@alphazede/bearing-lite 0.2.0 → 0.2.2

package/skills/plan-integrator/SKILL.md

@@ -23,9 +23,18 @@ the five artifacts, and generates `implementation.json` and two-state
 
 1. Cross-validate the five canonical artifacts. Copy design-lens names
    from design.md; never invent lens IDs.
-2. Generate `implementation.json` and `review.html` (`planning-review`,
+2. For `journey_type: specification`, default an Expedition wave to scaffold →
+   author from the gated register → Test Engineer verification cases → bind to the host
+   → readback of the bound revision and digest from the host → Park
+   Ranger with both named in the review request → owner decision. A deviation
+   is a planning-review finding.
+3. Generate `implementation.json` and `review.html` (`planning-review`,
    then `final-closeout`) when inputs are stable.
-3. Request a Planning Test Engineer delta after relevant decision,
+4. Classify every slice `work_class: light` or `judgement` with a
+   `work_class_reason`, using the five criteria in `skills/light-implementer`.
+   Light slices carry the Light Implementer role and at least one
+   `command_id`; the freeze rejects any other light slice.
+5. Request a Planning Test Engineer delta after relevant decision,
    requirement, or design changes. Do not author V&V.
 
 ## Return and recovery

package/skills/requirements-engineer/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: requirements-engineer
+description: >
+  One Requirements Engineer role, planning stage only. Use for the
+  requirement register quality gate after Gather Supplies and before the
+  Systems Modeler finalizes mappings. Do not use inside an Expedition wave,
+  or for V&V, SysML modeling, implementation, defect review, or publication.
+---
+
+# Requirements Engineer
+
+One role, one planning session. It owns requirement quality: every statement
+is precise, measurable, traceable, allocated, and verification-ready.
+Requirements are fixed at plan approval; an Expedition wave stores, binds,
+adds verification cases, and publishes approved statements and never re-gates
+them (the Assurance Test Engineer re-verifies at wave end). It never persists
+SDoc, publishes, selects models or lineups, or writes tests.
+
+## Inputs and match
+
+- **Inputs:** settled owner decisions, the requirement register as a planning
+  artifact (UID, statement, rationale, verification method, allocation: a
+  draft `.sdoc`, since Markdown rows are invisible to the lint), the plan's `AC-*`
+  and `RISK-*` rows, published-standard citations, the
+  `requirements-engineering` method skill, `lint-sdoc.py --profile library`
+  output, compact return schema.
+- **Match:** a planning package whose requirement register needs a
+  quality-gate verdict before the integrated owner review.
+- **Non-match:** any Expedition wave, design, SEIT, implementation, Park
+  Ranger, Surveyor.
+
+## Algorithm
+
+1. Run after Gather Supplies and before the Systems Modeler finalizes
+   mappings, on the requirement statements themselves: gate every register
+   row's statement, rationale, verification method, and allocation, and the
+   `AC-*`/`RISK-*` rows that cite them, against the NASA-adapted checklist;
+   reject escape clauses and undefined terms; every row cites its register
+   identity or is marked Journey-local.
+2. Cite the mechanical output (`lint-sdoc.py --profile library` over the
+   register: EARS, banned terms, glossary references) and judge only what the
+   tool cannot decide. Missing tool output is `NEEDS_MORE_EVIDENCE`.
+3. When a published standard is cited, verify the document and clause.
+4. Return the smallest set of failing rows. Never rewrite silently: propose
+   the corrected statement and let the author apply it.
+
+## Return and recovery
+
+Return `PASS`, `REPAIRABLE_FAILURE`, `NEEDS_MORE_EVIDENCE`, or
+`NEEDS_OWNER_DECISION` with verdict, candidate_ref, changed_paths, per-row
+findings, and blocker. Rerun the gate on each corrected register within Map the
+Route's correction rounds. Exhaustion with fixable rows returns
+`NEEDS_OWNER_DECISION` listing those rows, never silent acceptance. Missing
+`requirements-engineering` method skill is a typed capability gap.
+
+Never implement, model, self-certify, persist or publish SDoc, or grant
+owner-only approval.

package/skills/scribe/SKILL.md

@@ -22,6 +22,10 @@ Event side lane. Transcribes; cannot activate authority.
 
 1. Append owner decisions, authority events, ledger snapshots, lineup
    selections, and configuration digest to `journey.json` history.
+   Follow `../bearing-lite/references/owner-stops.md` for typed owner-stop
+   records: preserve question and round-trip IDs, record actual asked/answered
+   UTC times and explicit fully blocked intervals, and never infer missing
+   times. Automatic resolutions and owner steering are not invented questions.
 2. Do not activate authority or invent unresolved choices.
 3. Do not write Journey selections into `lineups.json` unless the owner
    asks to save a reusable profile.

package/skills/set-bearings/SKILL.md

@@ -15,19 +15,28 @@ Fresh planning node. The Router announces `Setting Our Bearings in <repo>.`
 
 - **Inputs:** confirmed repository root, owner-confirmed plan directory, Journey
   title, visible existing artifacts, repository rules, and return schema.
-- **Match:** the workspace or current-state repository map is missing or stale.
+- **Match:** the workspace or repository map is missing or stale.
 - **Non-match:** both are current and usable by Gather Supplies or Map the Route.
 
 ## Algorithm
 
 1. Re-read the exact confirmed root and plan directory; never derive a different
    root, slug, suffix, or sibling workspace.
-2. Preserve every existing artifact and unrelated edit. Resume rather than
-   replace an existing Journey.
-3. Create only the missing plan-directory stub and bounded repository map.
-4. Record observed systems, relevant paths, constraints, Git boundaries,
-   validation commands, and unknowns as evidence—not invented decisions.
-5. Verify that all written paths remain inside authority and are human-readable.
+2. If `workspace.md` exists in the plan directory, verify recorded root and plan
+   directory match confirmed inputs; a mismatch returns `BLOCKED`. Run `git
+   status --porcelain` scoped to mapped inputs; if unmodified, return
+   `WORKSPACE_RESUMED` (1 read, 1 status).
+3. Bound discovery: depth 2, max 40 paths, max 64 KiB, read-only. Anchors are
+   root manifest, task runner, CI entrypoint, top-level instructions, and root
+   test configs. Strictly prohibit discovery traversal into repo-relative
+   `src/`, `lib/`, `vendor/`, and `docs/`.
+4. If bounds are exhausted before required anchors are found, return
+   `NEEDS_EVIDENCE` naming the missing anchor. Never compose unobserved commands.
+5. Create missing plan directory or update `workspace.md` in place, preserving
+   existing recorded evidence and unrelated edits. Initialize a missing file
+   from `templates/workspace.md`. Quote validation commands with source and mark
+   `[observed, not run]`. Drop detail before Constraints and Unknowns.
+6. Verify written paths remain inside authority and return `WORKSPACE_READY`.
 
 ## Return and recovery
 

package/skills/set-bearings/templates/workspace.md

@@ -0,0 +1,28 @@
+# Workspace Environment: <journey-topic>
+
+## Repository Identity
+- Root: `<repository-root>`
+- Plan directory: `<plan-directory>`
+
+## Mapped Inputs
+- `<relative-path>`: `<what it establishes>`
+
+## Observed Systems
+- `<relative-directory>`: `<subsystem>`
+
+## Constraints and Git Boundaries
+- Branch / Worktree: `<branch>` (clean | dirty)
+- Rules: `<applicable-rules>`
+
+## Validation Commands [observed, not run]
+- Test: `<command>` (source: `<anchor-file>`) [observed, not run]
+- Lint: `<command>` (source: `<anchor-file>`) [observed, not run]
+- Build: `<command>` (source: `<anchor-file>`) [observed, not run]
+
+## Unknowns
+- `<unknown or none observed>`
+
+## Map Freshness
+- Tier 1: Recorded root and plan directory match confirmed inputs.
+- Tier 2: `git status --porcelain` scoped to mapped inputs shows no modifications.
+- Note: Does not detect committed changes postdating this observation.

package/skills/test-engineer/SKILL.md

@@ -27,6 +27,8 @@ separate catalog roles.
    reconciliation and performs delta reconciliation after relevant
    decision, requirement, or design changes. Do not invent missing
    method-skill behavior.
+   Expedition in-document verification cases are authored only against the
+   approved, planning-gated register.
 2. Assurance Test Engineer starts a fresh session; reject author ancestry;
    evaluate the exact stable candidate at the declared phase or wave end only.
    VALIDATING is owned here.

package/skills/bearing-lite/templates/default-role-lineup.md

@@ -1,32 +0,0 @@
-# Bearing Lite global defaults
-
-Store the user-owned copy at
-`~/.agents/bearing-lite/default-role-lineup.md`. The Router displays it before
-implementation and asks whether it is good for the current Journey. Never fill
-agent, model, or reasoning values on the user's behalf.
-
-```markdown
-review_cadence: at-end
-
-| Role | Primary agent/harness | Primary model | Primary reasoning | Fallback agent/harness | Fallback model | Fallback reasoning |
-| --- | --- | --- | --- | --- | --- | --- |
-| Router | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Explorer | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Crewmate | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Test Engineer | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Scribe | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Plan Integrator | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Systems Modeler | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Integration Engineer | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Park Ranger | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-| Surveyor | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET | OWNER_TO_SET |
-```
-
-Navigator is not a normal lineup role. Existing plans that still assign it use
-the Navigator compatibility diagnostic; treat the assignment as unused.
-Validator is not a normal lineup role. Existing plans that still assign it use
-the Validator compatibility diagnostic; treat the assignment as unused.
-
-Journey artifacts copy the confirmed values and mark named instances active,
-standby, or unused. Only verified primary unavailability activates its approved
-fallback. If both are unavailable, return `OWNER_DECISION_REQUIRED`.