docs: pre-Sprint-0 hardening — Lane A (A1-A6) + Lane B (B1) per Claude shakedown dossier #8

Merged
j7 merged 1 commit from docs/pre-sprint0-hardening into main 2026-07-09 23:20:49 -04:00
Collaborator

Summary

Applies the pre-Sprint-0 hardening lane specified in documents/audits/claude-shakedown-2026-07-09.md §4.6 (recs 1-7) and prompts/san-execute-shakedown.md Lane A/B cards. Single PR per J7 sequencing choice (α).

Gate-0 status:

  • D1 (multiplex target) — already resolved by ADR-0004 merged earlier (per-wolf gateways canonical).
  • D2 (Honcho fate) — already resolved with 'decommission pending' status word + E3-T15 card.

This PR closes the remaining dossier issues #3-#10 + §4.5 minors #2/#4.

What changed

Card File(s) Dossier ref
A1 board-schema fields + transition table kanban/board-schema.md issues #3, #4
A2 GBrain dedup (E2-T1 vs E3-T12) + E1-T5 → E1-T3 citations kanban/backlog.md, specs/gbrain-substrate.md, docs/persistence-boundaries.md issue #5
A3 cross-reference sweep + Mnemosyne restart + spec §13/§14 + README + delete TREE.txt specs/starros-stack-spec.md, docs/persistence-boundaries.md, docs/runtime-state.md, README.md, TREE.txt issues #7, #10, fact #10
A4 AMB visibility + Phase 1A/1C labels specs/starros-stack-spec.md, docs/runtime-state.md, decisions/0003-canonical-spec-boundaries.md issue #6
A5 example packets stamped HISTORICAL + Report-back channel packets/examples/{backend-kanban-adapter,ui-preview-panel}.md issue #9
A6 Jigo minors #2 (profile.yaml) + #4 (hermes-workspace-src) docs/persistence-boundaries.md, decisions/0003-canonical-spec-boundaries.md §4.5 items 2, 4
B1 re-sequence Outpost Traefik fix ahead of Sprint 0 kanban/backlog.md (new E3-T16 row) rec #6

Diff stat: 11 files changed, +85/-45 (TREE.txt deleted).

One flagged follow-up: Kohroku confirmation needed

A3 picked bsm-secret-fetch-for-environmentfile.sh helper as the canonical Mnemosyne restart command (superseding the older nixos-host-operations skill reference). I tagged this [NEEDS-KOHROKU] in runtime-state §3 #1 because I did not actually ask Kohroku — the helper script may have been renamed/moved since 2026-07-09. San will ping Kohroku before Sprint 0 opens.

Authority

Per specs/starros-stack-spec.md §4.1, ADR/schema/template changes carry San + Jigo + J7 authority. Jigo review is the gating step here; J7 sign-off expected at PR-review.

Refs

  • documents/audits/claude-shakedown-2026-07-09.md issues #3-#10, §4.5 items 2/4, §4.6 recs 1-7
  • prompts/san-execute-shakedown.md Lane A cards A1-A6 + Lane B card B1
  • ADR-0004 (multiplex = per-wolf) already merged — provides the §2 item 3 correction this PR pairs with

Test plan

  • Jigo review (primary, per ADR/schema authority)
  • J7 sign-off (post-Jigo)
  • San to confirm Mnemosyne helper-script name with Kohroku (pre-Sprint 0, not blocking this merge)
  • Verify no regression in kanban/board-schema.md legal-transition table (manual sanity check that the 13-row table covers every plausible card flow)
## Summary Applies the **pre-Sprint-0 hardening lane** specified in `documents/audits/claude-shakedown-2026-07-09.md` §4.6 (recs 1-7) and `prompts/san-execute-shakedown.md` Lane A/B cards. Single PR per J7 sequencing choice (α). **Gate-0 status:** - **D1** (multiplex target) — already resolved by ADR-0004 merged earlier (per-wolf gateways canonical). - **D2** (Honcho fate) — already resolved with 'decommission pending' status word + E3-T15 card. This PR closes the **remaining dossier issues #3-#10 + §4.5 minors #2/#4**. ## What changed | Card | File(s) | Dossier ref | |---|---|---| | **A1** board-schema fields + transition table | `kanban/board-schema.md` | issues #3, #4 | | **A2** GBrain dedup (E2-T1 vs E3-T12) + E1-T5 → E1-T3 citations | `kanban/backlog.md`, `specs/gbrain-substrate.md`, `docs/persistence-boundaries.md` | issue #5 | | **A3** cross-reference sweep + Mnemosyne restart + spec §13/§14 + README + delete TREE.txt | `specs/starros-stack-spec.md`, `docs/persistence-boundaries.md`, `docs/runtime-state.md`, `README.md`, `TREE.txt` | issues #7, #10, fact #10 | | **A4** AMB visibility + Phase 1A/1C labels | `specs/starros-stack-spec.md`, `docs/runtime-state.md`, `decisions/0003-canonical-spec-boundaries.md` | issue #6 | | **A5** example packets stamped HISTORICAL + Report-back channel | `packets/examples/{backend-kanban-adapter,ui-preview-panel}.md` | issue #9 | | **A6** Jigo minors #2 (profile.yaml) + #4 (hermes-workspace-src) | `docs/persistence-boundaries.md`, `decisions/0003-canonical-spec-boundaries.md` | §4.5 items 2, 4 | | **B1** re-sequence Outpost Traefik fix ahead of Sprint 0 | `kanban/backlog.md` (new E3-T16 row) | rec #6 | **Diff stat:** 11 files changed, +85/-45 (TREE.txt deleted). ## One flagged follow-up: Kohroku confirmation needed A3 picked `bsm-secret-fetch-for-environmentfile.sh` helper as the **canonical Mnemosyne restart command** (superseding the older `nixos-host-operations` skill reference). I tagged this `[NEEDS-KOHROKU]` in runtime-state §3 #1 because I did not actually ask Kohroku — the helper script may have been renamed/moved since 2026-07-09. San will ping Kohroku before Sprint 0 opens. ## Authority Per `specs/starros-stack-spec.md` §4.1, ADR/schema/template changes carry `San + Jigo + J7` authority. Jigo review is the gating step here; J7 sign-off expected at PR-review. ## Refs - `documents/audits/claude-shakedown-2026-07-09.md` issues #3-#10, §4.5 items 2/4, §4.6 recs 1-7 - `prompts/san-execute-shakedown.md` Lane A cards A1-A6 + Lane B card B1 - ADR-0004 (multiplex = per-wolf) already merged — provides the §2 item 3 correction this PR pairs with ## Test plan - [ ] Jigo review (primary, per ADR/schema authority) - [ ] J7 sign-off (post-Jigo) - [ ] San to confirm Mnemosyne helper-script name with Kohroku (pre-Sprint 0, not blocking this merge) - [ ] Verify no regression in `kanban/board-schema.md` legal-transition table (manual sanity check that the 13-row table covers every plausible card flow)
Applies the pre-Sprint-0 hardening lane specified in
documents/audits/claude-shakedown-2026-07-09.md §4.6 (recs 1-7) and the
san-execute-shakedown.md Lane A/B cards. Single PR per J7 sequencing choice (α).

D1 (multiplex target) was already resolved by ADR-0004 merged earlier; D2
(Honcho fate) was already resolved with the 'decommission pending' status word
+ E3-T15 card. This PR closes the remaining dossier issues:

A1 — kanban/board-schema.md:
  - Add 'forbidden_paths' + 'report_back_channel' to required card fields
    (dossier issue #3; closes the schema/policy gap that let external-worker
    cards be schema-valid without enforcing policy §4).
  - Add §Legal transitions table (dossier issue #4): closes the 'wolf solo
    can move any card to done' loophole; ready-to-merge → done now requires J7.

A2 — GBrain dedup:
  - kanban/backlog.md E2-T1 → 'DEDUP — see E3-T12; same deliverable'
  - specs/gbrain-substrate.md line 3: 'E1-T5' → 'E1-T3 (GBrain spec authoring)'
  - docs/persistence-boundaries.md line 16: 'E1-T5 GBrain spec drafted' →
    'E1-T3 GBrain spec authored'
  (dossier issue #5)

A3 — cross-reference sweep:
  - specs/starros-stack-spec.md §13: remove the implemented recommendation
    (san-handoff already lists runtime-state + persistence-boundaries); add
    a status note explaining the removal.
  - specs/starros-stack-spec.md §14: correct provenance (v1.0 was a blob, not
    a commit; PR #1 + #2 are now MERGED with their merge commit SHAs;
    dossier issues #10, #4).
  - docs/persistence-boundaries.md: fix the §"De-scoped" dangling anchor to
    point at runtime-state §2 + §3 + backlog E3-T15 (dossier issue #9).
  - README.md: rewrite milestones as 'all five closed' with status block
    (dossier issue #10).
  - Delete TREE.txt (dossier issue #10; git IS the tree).

  - Mnemosyne restart procedure: picked 'bsm-secret-fetch-for-environmentfile.sh'
    helper as the canonical command, supersedes the older 'nixos-host-operations'
    skill reference (dossier issue #10 / fact #10). Tagged [NEEDS-KOHROKU] —
    San will ping Kohroku before Sprint 0 opens to confirm the helper script
    is still current.

A4 — AMB visibility:
  - specs/starros-stack-spec.md §3: new AMB row.
  - docs/runtime-state.md §2: new :6380 row.
  - decisions/0003 §Glossary: define 'Phase 1A' = broker live + plain
    requirepass; 'Phase 1C' = per-wolf ACL material finalized (dossier #6).

A5 — example packets:
  - Both Mission-Control-targeting example packets stamped HISTORICAL (J7
    2026-07-09 pause; revival tracked as E3-T3).
  - Both packets now include the Report-back channel metadata line
    (dossier issue #9; required by external-workers §6 and the new
    board-schema required-field).

A6 — Jigo minors #2 + #4:
  - docs/persistence-boundaries.md Notes: new 'profile.yaml template vs
    instance' clarification (template in staging tree; instances in
    canonical profiles tree).
  - decisions/0003 §Glossary: Hermes Workspace row now disambiguates from
    'hermes-workspace-src/' (which holds paused Mission Control source, not
    the killed flake input).

B1 — re-sequence Outpost Traefik fix ahead of Sprint 0:
  - kanban/backlog.md: new E3-T16 row supersedes E3-T11 sequencing for the
    pre-Sprint-0 hardening window. J7 sign-off gated if change window is
    risky; peer-host discipline (Outpost admin path).

Lane A bookkeeping:
  - New Epic E4 in backlog.md tracks all 7 hardening cards (A1-A6 + B1) with
    owners + reviewers per the execute prompt.

Ref: documents/audits/claude-shakedown-2026-07-09.md issues #3-#10,
     §4.5 items 2/4, §4.6 recs 1-7; prompts/san-execute-shakedown.md
     Lane A cards A1-A6 + Lane B card B1.

Reviewer: Jigo (per San + Jigo + J7 authority for ADR/schema/template
          changes; see specs/starros-stack-spec.md §4.1).
j7 merged commit 2ce34bce6b into main 2026-07-09 23:20:49 -04:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
j7/StarrOS!8
No description provided.