@alphazede/bearing-lite 0.2.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/CONTRIBUTING.md +11 -6
  2. package/README.md +224 -121
  3. package/com.github.copilot/hooks/hooks.json +33 -0
  4. package/hooks/assurance-budget.cjs +33 -11
  5. package/hooks/closeout.cjs +17 -0
  6. package/hooks/com.anthropic.claude-code/mapping.md +35 -16
  7. package/hooks/owner-stops.cjs +154 -0
  8. package/hooks/plan-package.cjs +5 -4
  9. package/hooks/policy.cjs +10 -4
  10. package/hooks/profiles.cjs +119 -0
  11. package/hooks/te-host.cjs +40 -5
  12. package/hooks/transition-order.cjs +24 -4
  13. package/hooks/verification.cjs +358 -0
  14. package/package.json +6 -3
  15. package/plugin.json +2 -34
  16. package/profiles.json +1 -0
  17. package/schemas/authority.schema.json +55 -34
  18. package/schemas/implementation.schema.json +204 -5
  19. package/schemas/journey.schema.json +142 -48
  20. package/schemas/profiles.schema.json +359 -0
  21. package/schemas/verification.schema.json +126 -0
  22. package/skills/{set-bearings → architectural-alignment}/SKILL.md +17 -13
  23. package/skills/{set-bearings → architectural-alignment}/templates/workspace.md +1 -1
  24. package/skills/bearing-lite/SKILL.md +23 -23
  25. package/skills/bearing-lite/references/assurance-policy.md +32 -16
  26. package/skills/bearing-lite/references/lineups.md +7 -105
  27. package/skills/bearing-lite/references/owner-stops.md +122 -0
  28. package/skills/bearing-lite/references/peer-synthesis.md +11 -12
  29. package/skills/bearing-lite/references/profiles.md +149 -0
  30. package/skills/bearing-lite/references/resume.md +30 -0
  31. package/skills/bearing-lite/references/review-policy.md +8 -3
  32. package/skills/bearing-lite/references/role-routing.mmd +14 -14
  33. package/skills/bearing-lite/references/task-state.md +10 -10
  34. package/skills/bearing-lite/references/task-state.mmd +2 -2
  35. package/skills/bearing-lite/references/verification.md +52 -0
  36. package/skills/bearing-lite/templates/task.md +29 -28
  37. package/skills/{explorer → coordinator}/SKILL.md +19 -19
  38. package/skills/{crewmate → implementer}/SKILL.md +17 -15
  39. package/skills/{repository-fit → intake}/SKILL.md +10 -9
  40. package/skills/integration-engineer/SKILL.md +17 -12
  41. package/skills/light-implementer/SKILL.md +6 -5
  42. package/skills/onboard-bearing/SKILL.md +46 -0
  43. package/skills/plan-integrator/SKILL.md +14 -14
  44. package/skills/planning-and-design/SKILL.md +60 -0
  45. package/skills/{map-the-route → planning-and-design}/references/artifact-grammar.md +29 -27
  46. package/skills/prompt/SKILL.md +245 -0
  47. package/skills/requirements-engineer/SKILL.md +11 -11
  48. package/skills/{park-ranger → reviewer}/SKILL.md +16 -13
  49. package/skills/{gather-supplies → scope-definition}/SKILL.md +13 -13
  50. package/skills/scribe/SKILL.md +12 -8
  51. package/skills/systems-modeler/SKILL.md +5 -3
  52. package/skills/test-engineer/SKILL.md +16 -13
  53. package/templates/dod-manifest-v1.html +648 -0
  54. package/tools/render-dod-manifest.mjs +1743 -0
  55. package/lineups.json +0 -1
  56. package/schemas/lineups.schema.json +0 -145
  57. package/skills/map-the-route/SKILL.md +0 -59
  58. package/skills/navigator/SKILL.md +0 -36
  59. package/skills/surveyor/SKILL.md +0 -48
  60. package/skills/validator/SKILL.md +0 -37
  61. package/skills/validator/references/grading-rubric.md +0 -40
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: planning-and-design
3
+ description: >
4
+ Create or resume Bearing's complete five-artifact planning package after
5
+ material decisions are settled. Use for Planning and Design or missing
6
+ planning artifacts. Do not use to implement, select models, self-approve, or
7
+ bypass the single integrated owner review.
8
+ ---
9
+
10
+ # Planning and Design
11
+
12
+ Fresh planning node. The Orchestrator writes Lifecycle state and owns conversation.
13
+
14
+ ## Match, inputs, and non-match
15
+
16
+ - **Match:** material intent is settled and any technical-plan, design, SEIT,
17
+ implementation graph, or DoD Manifest is missing.
18
+ - **Inputs:** confirmed decisions, workspace.md and evidence, artifact status,
19
+ requirements register, repository rules, proposed owner-supplied profile and
20
+ cadence, plus the return schema.
21
+ - **Non-match:** unresolved material scope, behavior, authority, risk, or
22
+ acceptance intent returns `REROUTE_SCOPE_DEFINITION`; generate no
23
+ `implementation.json` or Manifest.
24
+
25
+ ## Procedure
26
+
27
+ 1. Derive `<lifecycle-topic>-technical-plan.md` from the confirmed title; ask only on
28
+ ambiguity or collision. Establish whether a requirements register exists;
29
+ if repository evidence cannot decide, return `NEEDS_OWNER_DECISION`. Never
30
+ infer one. Registered identities remain references; author only Lifecycle-local
31
+ criteria; author the needed Lifecycle-level proof or return
32
+ `NEEDS_OWNER_DECISION` when register authority is unclear.
33
+ 2. Author and prospectively check, in dependency order, the testable
34
+ technical-plan, `design.md`, and `seit.json`. Preserve IDs, do not drop
35
+ Lifecycle-level proof or published-standard clause coverage, and select Reverify only on applicable binary-level SEIT claims.
36
+ 3. Map the implementation graph and propose development strategy
37
+ (`single_implementer` default or `tdd`), role states, profile, reasoning, and
38
+ cadence. Bind the one planning-review slot to owner-supplied
39
+ primary and ordered fallback route references under one candidate ref,
40
+ revision, and digest. Use supplied identities; never invent them.
41
+ 4. After those stable source inputs, freeze: `node <plugin root>/hooks/plan-package.cjs <plan dir>`
42
+ must PASS; any finding halts. Then generate `implementation.json` and the
43
+ DoD Manifest input together. Each includes the proposed
44
+ route, profile, role states, reasoning, cadence, traceability, waves,
45
+ recovery, approval boundaries, and register references versus Lifecycle-local
46
+ requirements. DoD Manifest states: `planning` then append-only closeout.
47
+ 5. Give every slice stable requirement/design/SEIT IDs, dependencies, exact
48
+ write set, authority, role, session rule, evidence, recovery, and stop rule.
49
+ 6. Follow `../bearing-lite/references/owner-stops.md`.
50
+ Open and verify the Manifest, then request exactly one integrated owner review
51
+ of outcome, design, route, profile, cadence, and plan. Dispatch remains
52
+ prohibited until approval. An owner change regenerates affected artifacts,
53
+ then returns to this same gate; never insert a profile or route pause.
54
+
55
+ ## Return and recovery
56
+
57
+ Return `PLAN_REVIEW_READY`, `REROUTE_SCOPE_DEFINITION`,
58
+ `NEEDS_OWNER_DECISION`, or `VALIDATION_FAILED` with paths, evidence, blocker,
59
+ and next action. Owner-decision pauses do not consume correction rounds. At
60
+ most three evidence-changing correction rounds; never implement or invent approval.
@@ -1,13 +1,14 @@
1
- # Map the Route Artifact Grammar
1
+ # Planning and Design Artifact Grammar
2
2
 
3
3
  Apply this closed grammar while authoring or validating planning artifacts.
4
4
  Bearing rejects deviations with typed findings.
5
5
 
6
- The canonical Journey planning artifacts are exactly
7
- `<journey-topic>-technical-plan.md` with `type: technical-plan`, `design.md`,
8
- `seit.json`, `implementation.json`, and `review.html`. Markdown carries
6
+ The canonical Lifecycle planning artifacts are exactly
7
+ `<lifecycle-topic>-technical-plan.md` with `type: technical-plan`, `design.md`,
8
+ `seit.json`, `implementation.json`, and the Definition of Done Manifest
9
+ (`<plan-name>-dod-manifest.html`). Markdown carries
9
10
  technical-plan and design reasoning; the JSON files are schema-validated
10
- machine authorities; `review.html` is their complete integrated human
11
+ machine authorities; the DoD Manifest is their complete integrated human
11
12
  projection. There is no sixth canonical planning artifact. XLSX may be an
12
13
  optional derived export and is never authority.
13
14
 
@@ -20,17 +21,18 @@ optional derived export and is never authority.
20
21
  Design IDs use `DES-*` or `CONTRACT-*`; SEIT rows use `SEIT-*`; commands
21
22
  use `CMD-*` or `PROC-*`. Suffixes contain only uppercase letters, digits,
22
23
  dots, or hyphens.
23
- 3. `<journey-topic>-technical-plan.md` declares requirements, Entry criteria,
24
+ 3. `<lifecycle-topic>-technical-plan.md` declares requirements, Entry criteria,
24
25
  Exit criteria, Rollback or repair, and Accountable controller. `design.md`
25
26
  declares design IDs. `seit.json` declares SEIT rows and commands.
26
27
  4. Preserve stable IDs. Every implementation reference resolves to a declared
27
28
  requirement, design contract, SEIT row, and command.
28
- 5. Owner-supplied lineup identities and proposed `review_cadence: at-end` are
29
+ 5. Owner-supplied profile identities and proposed cadence (`slice`, `phase`, or
30
+ `lifecycle`) are
29
31
  required before implementation drafting; missing identities or cadence block
30
- drafting. Do not offer `per-slice` or `per-round`. Map the proposed Journey
32
+ drafting. Map the proposed Lifecycle
31
33
  type and active/standby/unused role states before generating implementation;
32
- the final implementation and `review.html` record those proposals together.
33
- 6. The lineup snapshot contains the Journey-owned `planning_review` binding:
34
+ the final implementation and DoD Manifest record those proposals together.
35
+ 6. The profile snapshot contains the Lifecycle-owned `planning_review` binding:
34
36
  policy reference, one candidate ref/revision/digest, and unique abstract
35
37
  reviewer slots with a primary route reference plus ordered fallback route
36
38
  references. Slot count satisfies the referenced core policy. Do not put route
@@ -38,31 +40,31 @@ optional derived export and is never authority.
38
40
 
39
41
  ## Requirements register
40
42
 
41
- 1. Before authoring a Journey specification, establish whether the target
43
+ 1. Before authoring a Lifecycle specification, establish whether the target
42
44
  repository or system already has a requirements register and where. When the
43
45
  repository cannot answer, ask the owner; never infer.
44
46
  2. Where no register exists, author requirements as today; this section does not
45
47
  apply.
46
48
  3. Where a register exists, specification requirement rows are either references
47
49
  to registered identities (no restated text), derivations from them
48
- (`AC-X derives from REG-ID`), or Journey-local `AC-*`/`RISK-*` criteria about
50
+ (`AC-X derives from REG-ID`), or Lifecycle-local `AC-*`/`RISK-*` criteria about
49
51
  write sets, seams, gates, or concurrency. Do not restate registered content.
50
52
  4. `seit.json` references verification allocations where the register provides
51
53
  them. Where the register provides none for a referenced requirement, author
52
- Journey-level proof for it or return `NEEDS_OWNER_DECISION` when register
53
- authority is unclear; do not silently drop coverage. Journey-level proof
54
- rows remain Journey-local.
55
- 5. `review.html` marks every requirement as either a register reference or
56
- Journey-local, so a reviewer can tell which artifact owns each statement.
54
+ Lifecycle-level proof for it or return `NEEDS_OWNER_DECISION` when register
55
+ authority is unclear; do not silently drop coverage. Lifecycle-level proof
56
+ rows remain Lifecycle-local.
57
+ 5. The DoD Manifest marks every requirement as either a register reference or
58
+ Lifecycle-local, so a reviewer can tell which artifact owns each statement.
57
59
  6. `design.md` is unaffected: it records how the work is built, which no
58
60
  requirements register covers.
59
- 7. A specification-authoring Journey carries its requirement register (UID,
61
+ 7. A specification-authoring Lifecycle carries its requirement register (UID,
60
62
  statement, rationale, verification method, allocation) as a planning
61
63
  artifact: a draft `.sdoc` path (Markdown sections are not lint-checkable),
62
64
  recorded as `implementation.json` `journey_settings.journey_type:
63
65
  specification` plus `journey_settings.requirement_register`. The freeze
64
66
  fails without an existing register; the Requirements Engineer gates it
65
- before the integrated owner review; no Expedition wave re-gates it.
67
+ before the integrated owner review; no later implementation wave re-gates it.
66
68
 
67
69
  ## Published standards
68
70
 
@@ -96,7 +98,7 @@ optional derived export and is never authority.
96
98
 
97
99
  ## Implementation rules
98
100
 
99
- 1. Regular JSON is the nested execution authority for Journey settings, lineup
101
+ 1. Regular JSON is the nested execution authority for Lifecycle settings, profile
100
102
  snapshots, waves, slices, dependencies, traceability, and manifests.
101
103
  2. Every slice declares one named role plus goal, type, requirement IDs, design
102
104
  IDs, SEIT proof rows, exact design-lens names sourced from `design.md`,
@@ -106,10 +108,10 @@ optional derived export and is never authority.
106
108
  3. `work_class` is `light` or `judgement` (default). A `light` slice names
107
109
  the Light Implementer role, at least one command id, and a
108
110
  `work_class_reason`; see `skills/light-implementer` for the criteria.
109
- 4. For `journey_type: specification`, a specification-authoring Expedition
111
+ 4. For `journey_type: specification`, a specification-authoring implementation
110
112
  wave defaults to scaffold → author from the gated register → Test Engineer
111
113
  verification cases → bind to the host → readback of the bound revision and
112
- digest from the host → Park Ranger with both named in the review
114
+ digest from the host → Reviewer with both named in the review
113
115
  request → owner decision. A deviation is a planning-review finding.
114
116
  5. Optional fields are Shared interfaces (`path#Symbol`), Integration
115
117
  boundary, Published standard (`doc#clause`) when applicable, SysML and
@@ -144,16 +146,16 @@ placeholders, bare negations, or deferral language.
144
146
 
145
147
  1. Select review-oriented feature diagrams (flow diagrams, state-machine diagrams, or process/sequence diagrams) when they materially clarify architecture or lifecycle behavior for owner review.
146
148
  2. Major features select a justified subset or full set of diagrams based on architectural complexity. Trivial features or minor fixes do not require unnecessary diagrams.
147
- 3. Every feature diagram must include canonical, reviewable source (such as Mermaid code blocks), render visually inside generated `review.html`, and retain nearby authoritative explanatory text.
149
+ 3. Every feature diagram must include canonical, reviewable source (such as Mermaid code blocks), render visually inside generated DoD Manifest HTML, and retain nearby authoritative explanatory text.
148
150
  4. Non-trivial technical plans include words plus context/boundary, use-case/outcome, and operational-flow views. In MBSE mode record model revision/digest; never silently substitute Mermaid for mandated SysML. Trivial work may record `diagram_not_required` with a concrete rationale.
149
151
 
150
152
  ## Completion boundary
151
153
 
152
- Author technical-plan, design, SEIT, implementation, and review HTML in that
154
+ Author technical-plan, design, SEIT, implementation, and DoD Manifest HTML in that
153
155
  dependency order with internal prospective checks; generate implementation and
154
- HTML together after their stable inputs. `review.html` has two states:
155
- `planning-review` before implementation and `final-closeout` after
156
+ HTML together after their stable inputs. The DoD Manifest has two states:
157
+ `planning` before implementation and append-only closeout after
156
158
  implementation. Each records its stage and exact input digests. The single owner review gate requires
157
159
  the complete five-artifact package. Do not insert a lineup, route, or
158
160
  specification-only owner gate unless the owner explicitly requests staged
159
- approvals. The HTML becomes authoritative only after integrated owner approval.
161
+ approvals. The HTML becomes a frozen projection only after integrated owner approval.
@@ -0,0 +1,245 @@
1
+ ---
2
+ name: prompt
3
+ description: Write a bounded execution prompt for another agent.
4
+ type: agent-skill
5
+ title: Write Agent Handoff
6
+ okf_status: active
7
+ tags:
8
+ - internal
9
+ - skills
10
+ ---
11
+
12
+ # Write Agent Handoff
13
+
14
+ Create the smallest prompt that allows one agent to perform one responsibility and return verifiable evidence.
15
+
16
+ ## Structure
17
+
18
+ Use only these sections:
19
+
20
+ ```text
21
+ ROLE
22
+ STATE
23
+ OBJECTIVE
24
+ AUTHORITY
25
+ LOOP
26
+ VERIFY
27
+ RETURN
28
+ STOP
29
+ ```
30
+
31
+ ## ROLE
32
+
33
+ Name one agent role.
34
+
35
+ State what that role is responsible for.
36
+
37
+ Do not give the agent responsibilities owned by another role.
38
+
39
+ ```text
40
+ ROLE
41
+ Crewmate
42
+
43
+ RESPONSIBILITY
44
+ Implement one approved slice.
45
+ ```
46
+
47
+ ## STATE
48
+
49
+ Describe the current known state.
50
+
51
+ Separate facts from assumptions.
52
+
53
+ ```text
54
+ STATE
55
+ Phase: Authentication
56
+ Slice: AUTH-3
57
+ Status: ready
58
+ Baseline: commit abc123
59
+ Current failure: unauthorized paths are accepted
60
+ ```
61
+
62
+ Include exact paths, revisions, commands, identifiers, and unresolved failures when available.
63
+
64
+ Do not paste information the agent can retrieve cheaply.
65
+
66
+ ## OBJECTIVE
67
+
68
+ Define one observable outcome.
69
+
70
+ ```text
71
+ OBJECTIVE
72
+ Reject unauthorized paths without changing valid-path behavior.
73
+ ```
74
+
75
+ The objective should describe the result, not vague activity such as “investigate” or “work on.”
76
+
77
+ ## AUTHORITY
78
+
79
+ Define what the agent may and may not change.
80
+
81
+ ```text
82
+ AUTHORITY
83
+ Allowed paths:
84
+ - src/path-policy.ts
85
+ - test/path-policy.test.ts
86
+
87
+ Prohibited:
88
+ - architecture changes
89
+ - public API changes
90
+ - unrelated cleanup
91
+ ```
92
+
93
+ Preserve authority already granted by the controlling workflow.
94
+
95
+ Do not invent permissions, budgets, deadlines, or reasoning levels.
96
+
97
+ Do not specify a reasoning level for the agent unless the owner has explicitly instructed one. Otherwise omit it and let the agent's configured model default apply.
98
+
99
+ ## LOOP
100
+
101
+ Write the shortest controlled execution loop.
102
+
103
+ ```text
104
+ LOOP
105
+
106
+ 1. Observe the current code and evidence.
107
+ 2. State a change hypothesis.
108
+ 3. Make the smallest allowed change.
109
+ 4. Run focused verification.
110
+ 5. Inspect the result.
111
+ 6. If verification fails, classify the failure.
112
+ 7. Retry only with a new hypothesis or new evidence.
113
+ 8. Stop when the objective is proven or a genuine blocker exists.
114
+ ```
115
+
116
+ Adapt the loop to the role.
117
+
118
+ ### Crewmate Loop
119
+
120
+ ```text
121
+ Observe
122
+ → Hypothesize
123
+ → Implement
124
+ → Test
125
+ → Report
126
+ ```
127
+
128
+ ### Validator Loop
129
+
130
+ ```text
131
+ Read contract
132
+ → Inspect evidence
133
+ → Challenge proof
134
+ → Classify
135
+ → Report
136
+ ```
137
+
138
+ ### Park Ranger Loop
139
+
140
+ ```text
141
+ Inspect diff
142
+ → Trace behavior
143
+ → Find introduced defects
144
+ → Prove findings
145
+ → Report verdict
146
+ ```
147
+
148
+ ### Explorer Loop
149
+
150
+ ```text
151
+ Read phase state
152
+ → Select ready work
153
+ → Dispatch agent
154
+ → Evaluate returned evidence
155
+ → Advance, repair, or escalate
156
+ ```
157
+
158
+ ### Navigator &Trail Boss Loop
159
+
160
+ ```text
161
+ Read global state
162
+ → Identify ready phases
163
+ → Allocate Explorers
164
+ → Monitor dependencies
165
+ → Resolve conflicts
166
+ → Integrate or escalate
167
+ → Completeness you have authority except for OWNER DECISions
168
+ ```
169
+
170
+ ## VERIFY
171
+
172
+ Define how success is proven.
173
+
174
+ ```text
175
+ VERIFY
176
+ - CMD-UNIT-AUTH passes
177
+ - unauthorized path test fails before repair and passes afterward
178
+ - existing valid-path tests remain passing
179
+ - no files outside the write set change
180
+ ```
181
+
182
+ Verification must use observable evidence.
183
+
184
+ Do not use statements such as:
185
+
186
+ ```text
187
+ The solution looks correct.
188
+ The agent is confident.
189
+ The implementation appears complete.
190
+ ```
191
+
192
+ ## RETURN
193
+
194
+ Require a machine-routable result.
195
+
196
+ ```text
197
+ RETURN
198
+
199
+ Outcome:
200
+ - PASS
201
+ - REPAIRABLE_FAILURE
202
+ - CONTRACT_FAILURE
203
+ - ENVIRONMENT_FAILURE
204
+ - NEEDS_MORE_EVIDENCE
205
+ - OWNER_DECISION_REQUIRED
206
+
207
+ Include:
208
+ - changed paths
209
+ - commands executed
210
+ - evidence
211
+ - remaining risks
212
+ - blocker, if any
213
+ ```
214
+
215
+ ## STOP
216
+
217
+ Define genuine stop conditions.
218
+
219
+ ```text
220
+ STOP WHEN
221
+ - the objective is proven
222
+ - authority is insufficient
223
+ - the contract cannot be satisfied honestly
224
+ - required evidence cannot be produced
225
+ - an owner or architecture decision is required
226
+ ```
227
+
228
+ Do not stop merely because the work is difficult.
229
+
230
+ ## Final Check
231
+
232
+ Before returning the handoff, confirm:
233
+
234
+ ```text
235
+ - One role
236
+ - One objective
237
+ - Known starting state
238
+ - Clear authority
239
+ - Controlled loop
240
+ - Observable verification
241
+ - Structured return
242
+ - Genuine stop conditions
243
+ ```
244
+
245
+ Remove repetition, conversation history, generic advice, and unnecessary explanation.
@@ -2,8 +2,8 @@
2
2
  name: requirements-engineer
3
3
  description: >
4
4
  One Requirements Engineer role, planning stage only. Use for the
5
- requirement register quality gate after Gather Supplies and before the
6
- Systems Modeler finalizes mappings. Do not use inside an Expedition wave,
5
+ requirement register quality gate after Scope Definition and before the
6
+ Systems Modeler finalizes mappings. Do not use inside a Lifecycle wave,
7
7
  or for V&V, SysML modeling, implementation, defect review, or publication.
8
8
  ---
9
9
 
@@ -11,10 +11,10 @@ description: >
11
11
 
12
12
  One role, one planning session. It owns requirement quality: every statement
13
13
  is precise, measurable, traceable, allocated, and verification-ready.
14
- Requirements are fixed at plan approval; an Expedition wave stores, binds,
14
+ Requirements are fixed at plan approval; a Lifecycle wave stores, binds,
15
15
  adds verification cases, and publishes approved statements and never re-gates
16
- them (the Assurance Test Engineer re-verifies at wave end). It never persists
17
- SDoc, publishes, selects models or lineups, or writes tests.
16
+ them (the Assurance Test Engineer re-verifies at the cadence boundary). It never persists
17
+ SDoc, publishes, selects models or profiles, or writes tests.
18
18
 
19
19
  ## Inputs and match
20
20
 
@@ -26,17 +26,17 @@ SDoc, publishes, selects models or lineups, or writes tests.
26
26
  output, compact return schema.
27
27
  - **Match:** a planning package whose requirement register needs a
28
28
  quality-gate verdict before the integrated owner review.
29
- - **Non-match:** any Expedition wave, design, SEIT, implementation, Park
30
- Ranger, Surveyor.
29
+ - **Non-match:** any implementation wave, design, SEIT, implementation, Reviewer,
30
+ Integration Engineer execution.
31
31
 
32
32
  ## Algorithm
33
33
 
34
- 1. Run after Gather Supplies and before the Systems Modeler finalizes
34
+ 1. Run after Scope Definition and before the Systems Modeler finalizes
35
35
  mappings, on the requirement statements themselves: gate every register
36
36
  row's statement, rationale, verification method, and allocation, and the
37
37
  `AC-*`/`RISK-*` rows that cite them, against the NASA-adapted checklist;
38
38
  reject escape clauses and undefined terms; every row cites its register
39
- identity or is marked Journey-local.
39
+ identity or is marked Lifecycle-local.
40
40
  2. Cite the mechanical output (`lint-sdoc.py --profile library` over the
41
41
  register: EARS, banned terms, glossary references) and judge only what the
42
42
  tool cannot decide. Missing tool output is `NEEDS_MORE_EVIDENCE`.
@@ -48,8 +48,8 @@ SDoc, publishes, selects models or lineups, or writes tests.
48
48
 
49
49
  Return `PASS`, `REPAIRABLE_FAILURE`, `NEEDS_MORE_EVIDENCE`, or
50
50
  `NEEDS_OWNER_DECISION` with verdict, candidate_ref, changed_paths, per-row
51
- findings, and blocker. Rerun the gate on each corrected register within Map the
52
- Route's correction rounds. Exhaustion with fixable rows returns
51
+ findings, and blocker. Rerun the gate on each corrected register within Planning and
52
+ Design's correction rounds. Exhaustion with fixable rows returns
53
53
  `NEEDS_OWNER_DECISION` listing those rows, never silent acceptance. Missing
54
54
  `requirements-engineering` method skill is a typed capability gap.
55
55
 
@@ -1,34 +1,37 @@
1
1
  ---
2
- name: park-ranger
2
+ name: reviewer
3
3
  description: >
4
4
  Independently review one exact stable candidate for introduced actionable
5
- defects in a fresh session at the end. Use for Park Ranger, code review, or
6
- defect adjudication. Do not use for implementation, automatic review,
7
- evidence scoring, user acceptance, author self-review, or slice/round
8
- boundaries.
5
+ defects in a fresh session at the configured cadence boundary. Use for
6
+ Reviewer, code review, or defect adjudication. Do not use for implementation,
7
+ automatic review, evidence scoring, user acceptance, author self-review, or
8
+ unconfigured slice/round boundaries.
9
9
  ---
10
10
 
11
- # Park Ranger
11
+ # Reviewer
12
12
 
13
13
  Independent defect assurance, outside the mutation-authority ladder.
14
14
 
15
15
  ## Inputs and match
16
16
 
17
17
  - **Inputs:** approved baseline, exact candidate ref and diff, author identity,
18
- relevant evidence, declared phase or wave end boundary, review focus, and
18
+ relevant evidence, declared cadence boundary, review focus, and
19
19
  compact return schema.
20
- - **Match:** Park Ranger is declared and the declared phase or wave's
21
- integrated candidate is stable at that end.
22
- - **Non-match:** slice or round boundary, candidate is unstable/unchanged, or
23
- Surveyor/Test Engineer work is requested.
20
+ - **Match:** Reviewer is declared and the configured slice, phase, or
21
+ lifecycle candidate is stable at that boundary. Default cadence is `phase`.
22
+ - **Non-match:** unconfigured slice or round boundary, candidate is
23
+ unstable/unchanged, or Test Engineer / Integration Engineer execution work
24
+ is requested.
24
25
 
25
26
  ## Algorithm
26
27
 
27
28
  1. Start a fresh session; reject author identity, author ancestry, candidate
28
- discontinuity, or any boundary other than the declared phase or wave end.
29
+ discontinuity, or any boundary other than the declared cadence unit.
29
30
  Consume the Assurance
30
31
  Test Engineer receipt. Do not routinely invoke Test Engineering; use it
31
- only to adjudicate a specific suspected test defect.
32
+ only to adjudicate a specific suspected test defect. Deterministic
33
+ verification may support a suspected defect; author diagnostics cannot
34
+ satisfy assurance, and post-repair closure adds no review round.
32
35
  2. Review only introduced correctness, security, performance, and meaningful
33
36
  maintainability defects plus applicable plan drift. When the candidate
34
37
  implements a published standard, compare the change against the cited text
@@ -1,22 +1,22 @@
1
1
  ---
2
- name: gather-supplies
2
+ name: scope-definition
3
3
  description: >
4
- Relentlessly resolve material owner decisions for a Bearing Journey, one
4
+ Relentlessly resolve material owner decisions for a Bearing Lifecycle, one
5
5
  dependency-ordered question at a time, until shared understanding is explicit.
6
- Use for Gather Supplies or unresolved plan intent. Do not use for discoverable
6
+ Use for Scope Definition or unresolved plan intent. Do not use for discoverable
7
7
  repository facts, design drafting, implementation, or settled decisions.
8
8
  ---
9
9
 
10
- # Gather Supplies
10
+ # Scope Definition
11
11
 
12
- Planning node, not a persona or plan-state writer.
12
+ Planning node after Architectural Alignment, not a persona or plan-state writer.
13
13
 
14
14
  ## Match and inputs
15
15
 
16
16
  - **Match:** a material scope, behavior, authority, risk, or acceptance
17
- decision is unresolved. The Explorer-versus-Expedition route choice is not
18
- gathered here; the Router asks it at the route review after Map the Route
19
- maps the implementation graph.
17
+ decision is unresolved. Development strategy is not gathered here; the
18
+ Orchestrator records `single_implementer` or `tdd` from the profile or an
19
+ explicit owner choice in `implementation.json`.
20
20
  - **Non-match:** evidence can answer it, the owner already decided it, or a work
21
21
  packet is ready.
22
22
  - **Inputs:** goal, visible plan state, repository evidence, prior decisions,
@@ -33,7 +33,7 @@ Planning node, not a persona or plan-state writer.
33
33
  `BLOCKED` is surfaced. Planning is a fan-out/fan-in DAG with Scribe as an
34
34
  event side lane.
35
35
  2. Select the earliest unresolved decision whose dependencies are satisfied.
36
- 3. Ask exactly one question, relayed to the owner through the Router. Lead
36
+ 3. Ask exactly one question, relayed to the owner through the Orchestrator. Lead
37
37
  with the recommended answer and why, then explain only material
38
38
  alternatives and tradeoffs. Wait for the owner.
39
39
  4. Challenge vague terms, contradictions, unsafe assumptions, and incomplete
@@ -41,9 +41,9 @@ Planning node, not a persona or plan-state writer.
41
41
  5. Follow the affected dependency branch. Revisit an earlier answer when new
42
42
  evidence conflicts; otherwise do not replay it.
43
43
  6. Buffer confirmed decisions in the active session. Do not persist, patch, or
44
- re-render Journey state after each answer.
45
- 7. Return one consolidated decision batch to the Router at a natural checkpoint:
46
- the dependency branch is complete, Map the Route is next, handoff/context
44
+ re-render Lifecycle state after each answer.
45
+ 7. Return one consolidated decision batch to the Orchestrator at a natural checkpoint:
46
+ the dependency branch is complete, Planning and Design is next, handoff/context
47
47
  loss is imminent, or the owner requests a flush.
48
48
  8. When no material branch remains, summarize the shared interpretation and ask
49
49
  for explicit confirmation that shared understanding has been reached; then
@@ -57,4 +57,4 @@ rationale, affected requirements, buffered decision count, remaining branch,
57
57
  checkpoint, and next action. Stop after three evidence-changing attempts on one
58
58
  blocked decision.
59
59
 
60
- Never write Journey state, choose for the owner, design, or implement.
60
+ Never write Lifecycle state, choose for the owner, design, or implement.
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: scribe
3
3
  description: >
4
- Transcribe Journey decisions, authority events, ledger snapshots, and
5
- lineup selections as an event side lane. Use for Scribe. Do not use to
6
- activate authority, invent choices, or save lineups unless the owner
4
+ Transcribe Lifecycle decisions, authority events, ledger snapshots, and
5
+ profile selections as an event side lane. Use for Scribe. Do not use to
6
+ activate authority, invent choices, or save profiles unless the owner
7
7
  asks.
8
8
  ---
9
9
 
@@ -13,17 +13,21 @@ Event side lane. Transcribes; cannot activate authority.
13
13
 
14
14
  ## Inputs and match
15
15
 
16
- - **Inputs:** owner decisions, authority events, Gather ledger snapshots,
17
- lineup selections, configuration digest, `journey.json`.
18
- - **Match:** a visible Journey event must be appended to history.
16
+ - **Inputs:** owner decisions, authority events, Scope Definition ledger snapshots,
17
+ profile selections, configuration digest, `journey.json`.
18
+ - **Match:** a visible Lifecycle event must be appended to history.
19
19
  - **Non-match:** planning dispatch, specialist engineering, execution.
20
20
 
21
21
  ## Algorithm
22
22
 
23
- 1. Append owner decisions, authority events, ledger snapshots, lineup
23
+ 1. Append owner decisions, authority events, ledger snapshots, profile
24
24
  selections, and configuration digest to `journey.json` history.
25
+ Follow `../bearing-lite/references/owner-stops.md` for typed owner-stop
26
+ records: preserve question and round-trip IDs, record actual asked/answered
27
+ UTC times and explicit fully blocked intervals, and never infer missing
28
+ times. Automatic resolutions and owner steering are not invented questions.
25
29
  2. Do not activate authority or invent unresolved choices.
26
- 3. Do not write Journey selections into `lineups.json` unless the owner
30
+ 3. Do not write Lifecycle selections into `profiles.json` unless the owner
27
31
  asks to save a reusable profile.
28
32
 
29
33
  ## Return and recovery
@@ -2,13 +2,15 @@
2
2
  name: systems-modeler
3
3
  description: >
4
4
  Select modeling mode and attach view metadata after Requirements
5
- Engineer work and before design finalization. Use for Systems Modeler.
6
- Do not finalize requirement mappings against unstable requirements.
5
+ Engineer work and before design finalization. Use for Systems Modeler
6
+ planning session. Do not finalize requirement mappings against unstable
7
+ requirements.
7
8
  ---
8
9
 
9
10
  # Systems Modeler
10
11
 
11
- Runs after the Requirements Engineer and before design finalization.
12
+ One role with a planning session. Runs after the Requirements Engineer and
13
+ before design finalization.
12
14
 
13
15
  ## Inputs and match
14
16