Retire the old build spec, and point every reference at the architecture (M0.1) #85

2026-10-01T00:17:49Z

dev-agent commented

2026-10-01 00:17:49 +00:00

Development Plan M0.1, pre-approved. Comments and docs only; no behaviour change.

What changed

Every reference to the old spec now cites docs/Architecture.md: about 240 references across code, tests, specs/, nisse-dev.example.yaml, docs/Tuning-Guide.md, and the CLAUDE.md and README.md files.
docs/Architecture-Build-Spec.md is deleted (git keeps it), along with the plan's old → new table. M0.1 is marked done.
docs/Architecture.md: the status line no longer says references are pending, and L5 gains one line the rewrite missed: intake outages delay but never fail work (from the old B2). The poller and Matrix code cite it.

How ambiguous references were mapped:

A4 → L2 where it meant stop, abandon or the loop; → L3 where it meant approvals.
A10 → L6 in the context-budget code; → L7 elsewhere.
B2 → D4 for outbound Gitea and publishing; → D5 for review intake; → L5 for the outage posture.
"A3 step N" → the matching step of L8's new boot sequence (e.g. old step 8 "resume the committed state" → step 4; old step 5 "delegation resume" → step 5).
Comments describing behaviour the architecture drops (planning always escalating to a frontier model; thresholds tuned "at build-order step 5") now describe what the code does today, and point at the Development Plan instead of citing a section that no longer says it.

Acceptance (from the plan): grep finds no old-spec section reference. The only matches left are deliberate historical mentions: the architecture's status line and appendix, and M0.1's own description. Lint and format are clean; 499 unit tests and the integration suite (19 passed, 7 skipped) pass; the Quint model typechecks and its 8 scenarios pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_01PPQ14L3LikyefCMFBqEbKE

Development Plan **M0.1**, pre-approved. **Comments and docs only; no behaviour change.** **What changed** - **Every reference to the old spec now cites `docs/Architecture.md`:** about 240 references across code, tests, `specs/`, `nisse-dev.example.yaml`, `docs/Tuning-Guide.md`, and the `CLAUDE.md` and `README.md` files. - **`docs/Architecture-Build-Spec.md` is deleted** (git keeps it), along with the plan's old → new table. M0.1 is marked done. - **`docs/Architecture.md`:** the status line no longer says references are pending, and **L5 gains one line the rewrite missed**: intake outages delay but never fail work (from the old B2). The poller and Matrix code cite it. **How ambiguous references were mapped:** - **A4** → **L2** where it meant `stop`, `abandon` or the loop; → **L3** where it meant approvals. - **A10** → **L6** in the context-budget code; → **L7** elsewhere. - **B2** → **D4** for outbound Gitea and publishing; → **D5** for review intake; → **L5** for the outage posture. - **"A3 step N"** → the matching step of L8's new boot sequence (e.g. old step 8 "resume the committed state" → step 4; old step 5 "delegation resume" → step 5). - **Comments describing behaviour the architecture drops** (planning always escalating to a frontier model; thresholds tuned "at build-order step 5") now describe what the code does today, and point at the Development Plan instead of citing a section that no longer says it. **Acceptance (from the plan):** `grep` finds no old-spec section reference. The only matches left are deliberate historical mentions: the architecture's status line and appendix, and M0.1's own description. Lint and format are clean; 499 unit tests and the integration suite (19 passed, 7 skipped) pass; the Quint model typechecks and its 8 scenarios pass. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01PPQ14L3LikyefCMFBqEbKE

dev-agent added 1 commit 2026-10-01 00:17:49 +00:00

Retire the old build spec, and point every reference at the architecture (M0.1)

CI / checks (push) Skipped

CI / checks (pull_request) Successful in 1m22s

Details

1ad0b2147d

Development Plan M0.1. Every section reference in code, tests, specs/,
the example config, the tuning guide, and the CLAUDE.md and README files
now cites docs/Architecture.md (P, L, D, O, X, Q) instead of the old
spec's A-H, and docs/Architecture-Build-Spec.md is deleted (git keeps
it). The plan's old-to-new table goes with it.

Mostly mechanical, with a per-site choice where one old section split:
A4 became L2 where it meant stop/abandon/the loop and L3 where it meant
approvals; A10 became L6 in the context-budget code and L7 elsewhere; B2
became D4 for outbound Gitea and publishing and D5 for review intake;
'A3 step N' became the matching step of L8's boot sequence. Comments
describing behaviour the architecture drops (planning always escalating,
thresholds tuned at an old build step) now describe the current code and
point at the Development Plan.

docs/Architecture.md gains one line the rewrite missed: intake outages
delay but never fail work (old B2), now in L5, where the poller and
Matrix code cite it.

Comments and docs only; no behaviour change.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PPQ14L3LikyefCMFBqEbKE

dongar approved these changes

2026-10-01 00:52:50 +00:00

dongar merged commit 678466c176 into main

2026-10-01 00:52:53 +00:00

dongar deleted branch retire-old-spec

2026-10-01 00:52:54 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: dev/nisse#85