@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.
- package/CONTRIBUTING.md +11 -6
- package/README.md +224 -121
- package/com.github.copilot/hooks/hooks.json +33 -0
- package/hooks/assurance-budget.cjs +33 -11
- package/hooks/closeout.cjs +17 -0
- package/hooks/com.anthropic.claude-code/mapping.md +35 -16
- package/hooks/owner-stops.cjs +154 -0
- package/hooks/plan-package.cjs +5 -4
- package/hooks/policy.cjs +10 -4
- package/hooks/profiles.cjs +119 -0
- package/hooks/te-host.cjs +40 -5
- package/hooks/transition-order.cjs +24 -4
- package/hooks/verification.cjs +358 -0
- package/package.json +6 -3
- package/plugin.json +2 -34
- package/profiles.json +1 -0
- package/schemas/authority.schema.json +55 -34
- package/schemas/implementation.schema.json +204 -5
- package/schemas/journey.schema.json +142 -48
- package/schemas/profiles.schema.json +359 -0
- package/schemas/verification.schema.json +126 -0
- package/skills/{set-bearings → architectural-alignment}/SKILL.md +17 -13
- package/skills/{set-bearings → architectural-alignment}/templates/workspace.md +1 -1
- package/skills/bearing-lite/SKILL.md +23 -23
- package/skills/bearing-lite/references/assurance-policy.md +32 -16
- package/skills/bearing-lite/references/lineups.md +7 -105
- package/skills/bearing-lite/references/owner-stops.md +122 -0
- package/skills/bearing-lite/references/peer-synthesis.md +11 -12
- package/skills/bearing-lite/references/profiles.md +149 -0
- package/skills/bearing-lite/references/resume.md +30 -0
- package/skills/bearing-lite/references/review-policy.md +8 -3
- package/skills/bearing-lite/references/role-routing.mmd +14 -14
- package/skills/bearing-lite/references/task-state.md +10 -10
- package/skills/bearing-lite/references/task-state.mmd +2 -2
- package/skills/bearing-lite/references/verification.md +52 -0
- package/skills/bearing-lite/templates/task.md +29 -28
- package/skills/{explorer → coordinator}/SKILL.md +19 -19
- package/skills/{crewmate → implementer}/SKILL.md +17 -15
- package/skills/{repository-fit → intake}/SKILL.md +10 -9
- package/skills/integration-engineer/SKILL.md +17 -12
- package/skills/light-implementer/SKILL.md +6 -5
- package/skills/onboard-bearing/SKILL.md +46 -0
- package/skills/plan-integrator/SKILL.md +14 -14
- package/skills/planning-and-design/SKILL.md +60 -0
- package/skills/{map-the-route → planning-and-design}/references/artifact-grammar.md +29 -27
- package/skills/prompt/SKILL.md +245 -0
- package/skills/requirements-engineer/SKILL.md +11 -11
- package/skills/{park-ranger → reviewer}/SKILL.md +16 -13
- package/skills/{gather-supplies → scope-definition}/SKILL.md +13 -13
- package/skills/scribe/SKILL.md +12 -8
- package/skills/systems-modeler/SKILL.md +5 -3
- package/skills/test-engineer/SKILL.md +16 -13
- package/templates/dod-manifest-v1.html +648 -0
- package/tools/render-dod-manifest.mjs +1743 -0
- package/lineups.json +0 -1
- package/schemas/lineups.schema.json +0 -145
- package/skills/map-the-route/SKILL.md +0 -59
- package/skills/navigator/SKILL.md +0 -36
- package/skills/surveyor/SKILL.md +0 -48
- package/skills/validator/SKILL.md +0 -37
- 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
|
-
#
|
|
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
|
|
7
|
-
`<
|
|
8
|
-
`seit.json`, `implementation.json`, and
|
|
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;
|
|
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. `<
|
|
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
|
|
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.
|
|
32
|
+
drafting. Map the proposed Lifecycle
|
|
31
33
|
type and active/standby/unused role states before generating implementation;
|
|
32
|
-
the final implementation and
|
|
33
|
-
6. The
|
|
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
|
|
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
|
|
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
|
-
|
|
53
|
-
authority is unclear; do not silently drop coverage.
|
|
54
|
-
rows remain
|
|
55
|
-
5.
|
|
56
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 →
|
|
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
|
|
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
|
|
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.
|
|
155
|
-
`planning
|
|
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
|
|
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
|
|
6
|
-
Systems Modeler finalizes mappings. Do not use inside
|
|
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;
|
|
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
|
|
17
|
-
SDoc, publishes, selects models or
|
|
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
|
|
30
|
-
|
|
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
|
|
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
|
|
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
|
|
52
|
-
|
|
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:
|
|
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
|
|
6
|
-
defect adjudication. Do not use for implementation,
|
|
7
|
-
evidence scoring, user acceptance, author self-review, or
|
|
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
|
-
#
|
|
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
|
|
18
|
+
relevant evidence, declared cadence boundary, review focus, and
|
|
19
19
|
compact return schema.
|
|
20
|
-
- **Match:**
|
|
21
|
-
|
|
22
|
-
- **Non-match:** slice or round boundary, candidate is
|
|
23
|
-
|
|
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
|
|
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:
|
|
2
|
+
name: scope-definition
|
|
3
3
|
description: >
|
|
4
|
-
Relentlessly resolve material owner decisions for a Bearing
|
|
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
|
|
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
|
-
#
|
|
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.
|
|
18
|
-
|
|
19
|
-
|
|
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
|
|
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
|
|
45
|
-
7. Return one consolidated decision batch to the
|
|
46
|
-
the dependency branch is complete,
|
|
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
|
|
60
|
+
Never write Lifecycle state, choose for the owner, design, or implement.
|
package/skills/scribe/SKILL.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: scribe
|
|
3
3
|
description: >
|
|
4
|
-
Transcribe
|
|
5
|
-
|
|
6
|
-
activate authority, invent choices, or save
|
|
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,
|
|
17
|
-
|
|
18
|
-
- **Match:** a visible
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
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
|
|