Repository navigation
process(entry modes): mode contract, unattended-first plan rule, register skeleton (stacked on #790) - #791
Conversation
…n rule, design front end With no Entry mode and no Adopted at stage line, status.sh, gate-check.sh's summary and every exec.sh run print one banner. In Entry mode migration or requirements-driven, the first MDL write with no plan evidence is refused once (remedy: run stages 1-4, or gate-check.sh --adopt 5 --reason ...). Outside evidence clears it; a-la-carte (new), greenfield, poc, change-an-existing-app and --patch are never refused. The entry-mode tokeniser moves to project-bin/_position.sh (pure bash, no process starts) so the installed exec.sh can read it; bin/lib/entry-mode.sh is a shim. Runbook greenfield row reuses poc-build steps 1-4 plus a short plan; design-artifacts Step 2a maps supplied prototypes in PAGE-MAP.tsv and ui-preflight-pages' wireframe STOP accepts a mapped prototype. Field evidence: two field runs (2026-11), requirements-driven with a frozen spec and clickable prototypes, built ~78 pages with no plan or target. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
…ster skeleton - artifact-manifest.tsv modes column is the per-mode step list (vocabulary migration, requirements-driven, poc, existing-app, a-la-carte, all); dropped rows read "not owed (mode ...)". Build type: poc mode-waives stages 0-4, 6, 7 in gate-check. - Interview mode: auto: exec.sh refuses every pipeline-mode write until gate-check build-ready has passed (new .build-ready-pass record) or an adoption/stage-4 waiver exists; --adopt 4+ under auto writes an ASSUMED consentBy: auto-mode decision row (Stage 6 FAILs until confirmed). - "Mode changes are decisions": one rule in the runbook; poc-build points. - init/sync append missing register sections to a hand-written PROJECT.md (bin/lib/register-skeleton.sh, one template; fresh scaffold unchanged). - CONVERSION-RUNBOOK.md "Running unattended": the one kick-off brief. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
…wn axis Per the vocabulary correction: artifact-manifest.tsv column 6 keeps migration,requirements,greenfield,existing-app-change (the tokens entry_mode_token produces, copied by obligations.tsv column 10 in #787). No poc or all token; Build type: poc is read by gate-check.sh only. Only the N/A wording changes ("not owed (mode ...)"). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
…e reader emits Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
…tamp dir, rendered rules page - mxtk_pos_read honours "Waived stages: ..., 4 — reason" as gate-check does (was a false refusal on a project gate-check reads WAIVED at stage 4). - .mpr-snapshots/ is git-ignored before the refuse-once stamp is written, so "once per clone" cannot become once per repository; docs say plainly it is one refusal ever per clone. - skills/generated/rules-page.md re-rendered (bin/mdl-rules.sh --render) after the ui-preflight-pages.md STOP-row edit; CI was DRIFTED. - fixture: the status NEXT case accepts the intake-§1 needs-attention line that outranks the banner rule; aggregate-waiver and .gitignore cases. - _position.sh header: the shared tokeniser plus exec.sh's reader, not the only register reader. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
# Conflicts: # project-bin/exec.sh # skills/conversion-runbook.md
…D line stays first CI (wave2, run 44013599260): test-bug06-freshness copies gate-check.sh alone into a scratch toolkit, so the shim's banner text was never defined and `set -u` aborted the summary with exit 1 (reproduced: master 0, cb7c0fa 1, this 0). The banner is now an `if` with a defaulted variable. status.sh guards the reader the same way and prints the banner after the CWD line (test-status-session-cwd A: the CWD line must be first). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
# Conflicts: # CHANGELOG.md # bin/init-project.sh
…lan-rule # Conflicts: # CHANGELOG.md
# Conflicts: # CHANGELOG.md
….) (check-portability rule 3, bash 3.2) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
… ignored, SIGPIPE, refusal cost - gate-check fit-gap line: the poc branch runs before stage_waiver(3), and a mode reason "not owed (mode: m) — why" prints as "m entry mode — why" (was "not owed — not owed (mode: ...)"; test-fitgap-review F11a/F15a). - build-ready PASS git-ignores .mpr-snapshots/ before writing its record, as exec.sh does for its stamp. - test-mode-contract G: second init captured to a file, not piped into grep -q (SIGPIPE under pipefail). - auto-mode refusal says the cost for a project past Stage 5: one build-ready pass per clone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
…sh now (test-file-bugs.sh:472) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8
|
Review: MERGE-AFTER-FIX. The auto-mode plan rule works on both layouts. But sync's new skeleton step writes Value: Fixes G1 and adds the auto-mode refusal as described. One template ( Regression risk:
Correctness: All fixtures pass in a detached worktree. mode-contract is 21/0, and still 21/0 with every project on the Gaps:
Context cost: 65,373 → 65,497 (+124, measured on the #790 head and this head). Behaviour is NOT RUN with no reason given, although §4a.4 makes it required for always-loaded runbook text. Time cost: process starts per exec are unchanged. Auto projects pay one Exact fixes required:
CI on a918bd2: green. Generated by Claude Code |
…ion check (#793) The composition check of #787/#788/#790/#791/#792 found three ways an unattended agent could still get past the plan gate. This closes them: - Auto detection uses one first-word rule (mxtk_auto_word in project-bin/_position.sh) shared by exec.sh, gate-check.sh's --adopt check and ready.sh. `Interview mode: auto (…)` and `unattended — …` now count as auto, and the strictest of env, state file and register wins. - ready.sh reports NOT READY while any `consentBy: auto-mode` adoption row is unconfirmed, so an agent cannot approve its own plan skip and reach READY. - Under auto, an undeclared Entry mode is refused before build-ready. Attended behaviour is unchanged. - The checkpoint skills no longer describe greenfield as a live mode. Review: MERGE — no findings (the H/K/W/U order fix restores test-mode-contract to 28/0; the strictest-wins change is now in the CHANGELOG; CI green on d3c4ced) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This is the output of bin/cut-release.sh. The 24 entries under `## Unreleased` become `## v2026.11.17`. Included: #787, #788, #790, #791, #792 and #793. #789 is held. Review: MERGE — no findings (CHANGELOG heading only; the release section has no client names; CI green on 072e417) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Direct lane
Stack: #790 (banner + refuse-once plan rule) ← this PR ← #792 (greenfield retirement). This PR's base is #790's branch. Review them together, in order.
What changed and why (one paragraph): The owner's design input: unattended (
Interview mode: auto) is how people actually run the toolkit, and each mode (Entry mode + Build type) is a contract. Modes may move or drop gates, but the agent may not skip the declared mode's steps or quietly switch mode. A research comparison of five field builds that followed the process with the one that did not found two old gaps. G1: a hand-written PROJECT.md madeinit-project.shskip the register template in silence. G2: exec.sh had no stage check, which #790 adds.Mode contract, machine-readable, no new vocabulary. The existing modes column of
bin/lib/artifact-manifest.tsv(column 6) is now documented as the per-mode step list. Its values are unchanged (migration,requirements,greenfield,existing-app-change, asentry_mode_tokenproduces them, the same vocabulary fix(obligations): quality floor — per-module passes owed by what was built; one must-have list for every build type #787 copies ontoobligations.tsvcolumn 10). Only the wording changes: a row the mode drops readsN/A — not owed (mode <token>; manifest modes: …)instead of "entry mode … does not owe it".Build type: pocis a separate axis, read by gate-check.sh only: Stages 0–4, 6, 7 read WAIVED "not owed (mode: Build type: poc)" instead of PENDING. Stage 5 stays MANUAL and P is still checked. (A first push of this PR renamed the tokens and addedpocandall; that was reverted in 86114c5 after the vocabulary correction.)Auto mode refuses until the pre-build steps are done. Under
Interview mode: auto, a migration or requirements-driven project's MDL write is refused every time (no refuse-once) until one of these holds:gate-check.sh <p> build-readyhas passed (its PASS now writes.mpr-snapshots/.build-ready-pass, local and gitignored; sticky, so a later FAIL never blocks the repair, per guard rule 7);A plan on disk alone does not clear it under auto. Interactive mode keeps process(exec, entry modes): declared-position banner, refuse-once plan rule, design front end #790's refuse-once.
--adoptunder auto is not a silent escape.--adoptat 4 or later on a migration or requirements-driven project under auto also writes an ASSUMEDconsentBy: auto-modedecision row: Stage 4 when adopting at 5+, Stage 3 when adopting at 4. The existingauto_hand_pending()lists it on every run, and Stage 6 FAILs until a person confirms it. The refusal text says so.Mode changes are decisions: one statement in the runbook's Entry Modes;
poc-build.mdpoints to it.G1.
init-project.shandsync-project.shappend the missing register sections (Current stage, Decisions, Open questions, and Change log on init) to a PROJECT.md written by hand first, loudly, never touching existing lines. There is one template,bin/lib/register-skeleton.sh; a fresh scaffold is byte-identical to before (diffed). The generatedCLAUDE.local.mdgains an item 0: init runs before any PROJECT.md or model write.Unattended kick-off brief:
CONVERSION-RUNBOOK.md→ "Running unattended" is the one text a project brief quotes (five lines plus the failure note).Column values changed (both tables): none in this PR. #792 drops
greenfieldfrom artifact-manifest.tsv column 6. obligations.tsv column 10 gets the same drop once #787 is on master.What changes for existing projects after
sync-project.sh:build-readypasses or they adopt. This is the largest change; it hits once, untilgate-check.sh <p> build-readyruns. Alternative the reviewer may prefer: accept gate-check's readout at Stage 5+ under auto. I did not, because the readout skips the build-ready wiring checks.test-closeout.sh's one assertion was updated; anything grepping the old text needs the same.Impact
exec.sh,_position.sh(reads interview mode in pure bash, inbin/interview-mode.sh's order),gate-check.sh,init-project.sh,sync-project.sh,artifact-manifest.tsv(header text only),artifact-check.shandcloseout.sh(wording), newbin/lib/register-skeleton.sh. Not touched:obligations.tsv/obligation-check.sh(T1). New artifact read:.mpr-snapshots/.build-ready-pass, produced by the mandatorygate-check.sh <p> build-readystep.conversion-runbook.md. Lead: P 27,213 → 27,337; 4 29,463 → 29,587; 5 27,544 → 27,668. Frombin/render-routing.sh --check.Field evidence: the research comparison above. Manual runs on real
init-project.shscaffolds:auto mode: refused twice; refused again with a plan on disk; passed after the build-ready record;
--adopt 5under auto wrote the ASSUMED auto-mode Stage-4 row, and gate-check listed it as a ✋ decision to confirm;POC readout: 7 of 7 stages "not owed (mode: Build type: poc)";
hand-written PROJECT.md: init appended the sections; a second init skipped.
No client data (
check-no-client-data.shclean)Size cap: over, at 13 files. Splitting G1 into its own PR is possible if the reviewer wants it.
Test tier: new fixture
tests/wave2/test-mode-contract.shnot executed by the builder (fixtures not permitted in this session). The reviewer should run it, plustest-entry-mode-plan-rule.sh,test-closeout.sh,test-progress-report.sh,test-exec-process-budget.sh, the init and sync fixtures, and the gate-check fixtures.check-scripts.shandcheck-portability.share clean.CHANGELOG.mdline appendedDo not merge before the independent review.
🤖 Generated with Claude Code
https://claude.ai/code/session_01HXpQSifRwo7EWWDP1hPps8