The stakeholder
- Ask did STK-REQ-001 keep a checklist
- Count nominal, boundary, malformed_input. One SYS-REQ.
- Why the suite never walked the classes
Topic · obligation completeness
Gist
Obligation completeness is the STK to SYS gate: every class on the stakeholder checklist needs a covering system requirement. Proof runs proof audit --check obligation_completeness. A green STK is not a covered checklist. Jama still authors.
proof audit --check obligation_completeness
Keep the suite if it already fails a broken fixture. Keep Jama if it already holds the shalls. Neither one names the class that never got a SYS-REQ.
01 · The checklist that stopped at one child
You can keep STK-REQ-001 and still have never written the SYS-REQ for boundary or malformed_input.
The check walks stakeholder requirements that declare an obligation_checklist. Each listed class needs a satisfying system requirement that carries the same class. It is a structural hop. It does not judge whether those SYS-REQs are good. It asks whether the slot exists.
An empty checklist is a silent pass on this hop. That is a sibling: spec_lint_obligation_checklist_empty. A declared class with no covering SYS-REQ is an error unless you park it with --defer-obligation. A deferral is a counted warning. It is never promoted to an error, and it is never dropped. Suppression is the other primitive: only for a class that does not apply.
The id list lives on requirements completeness. Class-name drift across yaml, catalog, rules, and checklists lives on catalog completeness. Compiling a shall into an obligation lives on spec to obligations. This hop is the missing child class, not those three.
proof audit --check obligation_completeness --verbose
proof workflow check --stage spec --verbose
proof req show STK-REQ-001 --with lineage,traces
Inspect the named family before you edit. Add a SYS-REQ and link it with satisfies, or narrow the checklist to the classes that already exist, or defer the rest with a reason. Do not stamp one SYS-REQ with every class to clear the finding.
02 · The exhibit
STK-REQ-001 still exists. Click the tabs.
The stakeholder
This hop
No obligation_completeness JSON. The missing classes never ran.
No stampThe stakeholder
Keep the STK. It still owns that shall. That is not this hop.
Keep the STKProof
Same STK. A green checklist, or this stamp. Click the tabs.
| Surface | What they do | What Proof does | What we lose |
|---|---|---|---|
| Green suite / CI | The tests you selected passed. | Fail when a listed class has no covering SYS-REQ. | We do not write the SYS-REQ for you. A green stamp is not a proof of the Go. |
| Requirements completeness | Whether L0 / L1 / L2 ids exist. | Whether each declared class has a child. | Not that hop. See requirements completeness. |
| Catalog completeness | Whether yaml, catalog, rules, and checklists name the same classes. | Whether a covering SYS-REQ exists for each class on this STK. | Not that hop. See catalog completeness. |
| Jama | The authoring programme. Reviews if you put them there. | Fail the merge when the checklist stops halfway. | Not Jama's V&V. Jama still authors. We have not run a frozen Jama pack. |
The teaching graph is still one STK next to its classes. Run the check. Read the family. Write the missing SYS-REQ, or narrow the checklist, or defer with a reason. Do not copy every class onto one child to clear the stamp.
proof req new specs/system --component parser --obligation-class boundary
proof req link add SYS-REQ-011 satisfies STK-REQ-001
proof audit --check obligation_completeness --verbose
Typed evidence on the child is a later hop:
obligation_evidence_complete.
SYS to SW flow is
obligation_decomposition_complete.
Jama still authors.
Proof vs Jama.
03 · The honest loss
A green obligation_completeness is STK-to-SYS agreement. It is not a proof of the Go. Jama still authors.
The check does not judge the formula. A covering SYS-REQ that is vacuous still counts here. An empty checklist is not a finding on this hop. A deferred class stays a warning, including under audit.evidence_strict. We have not scored this graph against a frozen Jama pack or a second human's V&V judgment. The loss is named, not scored.
The compile hop stays on spec to obligations. The engagement stays on software correctness audit. Jama still authors.
04 · Nearby questions
What is obligation completeness? Same question. Same URL.
Is this requirements completeness? No. That hop is whether L0 / L1 / L2 ids exist. See requirements completeness.
Is this catalog completeness? No. That hop is class-name drift. See catalog completeness.
Is this spec to obligations? No. That hop compiles a shall. This hop asks whether each listed class has a SYS-REQ. See spec to obligations.
Is this vacuous requirements? No. A covering SYS-REQ that is vacuous still counts here. That hop is vacuous requirements.
Is Proof a Jama alternative for the checklist? No. Jama still authors. Proof vs Jama.