Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
cf0d2b2
process(exec, entry modes): declared position banner, refuse-once pla…
claude Nov 17, 2026
1da1d80
process(entry modes): mode contract, unattended-first plan rule, regi…
claude Nov 17, 2026
c4ad4d7
process(entry modes): retire greenfield; two doors (POC or requiremen…
claude Nov 17, 2026
86114c5
fix(mode contract): keep master's mode-column tokens; poc stays its o…
claude Nov 17, 2026
4e19928
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
038c1cd
test(mode contract): drift guard — every modes-column token is one th…
claude Nov 17, 2026
267acf0
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
cb7c0fa
fix(plan rule): review fixes — aggregate stage-4 waiver, ignore the s…
claude Nov 17, 2026
573f9df
Merge branch 'claude/entry-mode-plan-rule' into claude/mode-contract
claude Nov 17, 2026
ea9053e
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
1d68ffd
fix(gate-check, status): banner is warn-only even without bin/lib; CW…
claude Nov 17, 2026
fda6faf
Merge branch 'claude/entry-mode-plan-rule' into claude/mode-contract
claude Nov 17, 2026
b31b8cb
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
01e0c7a
Merge remote-tracking branch 'origin/master' into claude/mode-contract
claude Nov 17, 2026
93fbde0
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
16ff672
process(obligations): drop the retired greenfield token from obligati…
claude Nov 17, 2026
dac0e6e
Merge remote-tracking branch 'origin/master' into claude/entry-mode-p…
claude Nov 17, 2026
5e3d8d7
Merge branch 'claude/entry-mode-plan-rule' into claude/mode-contract
claude Nov 17, 2026
1523f79
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
9d566a2
fix(tests): POSIX leading paren on the drift guard's case inside $(..…
claude Nov 17, 2026
32419bc
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
b148b8d
fix(mode contract): review fixes — fit-gap wording, build-ready stamp…
claude Nov 17, 2026
da13b9f
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
40367d1
fix(greenfield retired): auto mode cannot bypass the plan rule; fixtu…
claude Nov 17, 2026
e57fc4c
Merge remote-tracking branch 'origin/master' into claude/entry-mode-p…
claude Nov 17, 2026
d8e52ed
Merge branch 'claude/entry-mode-plan-rule' into claude/mode-contract
claude Nov 17, 2026
1e26130
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
033f8ce
fix(tests): T15 checks 'boundary not detected' only on the waived sta…
claude Nov 17, 2026
a918bd2
fix(tests): the Bug filing opt-in lives in bin/lib/register-skeleton.…
claude Nov 17, 2026
0989b5f
Merge branch 'claude/mode-contract' into claude/retire-greenfield
claude Nov 17, 2026
8dec9dc
fix(greenfield retired): #788's CI-gate fixture no longer leans on gr…
claude Nov 17, 2026
0c7795d
Merge master bf1d2e9 (#790 squash) into claude/mode-contract: #791's …
claude Nov 17, 2026
f72c992
Merge commit '0c7795d5' into claude/retire-greenfield
claude Nov 17, 2026
8400aaf
Merge master (#791 squash) into retire-greenfield
claude Nov 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ Sections dated before 2026-09-19 predate the cycle and stay as they are. Named m
- fix(ready, ci, gate-check): **field run of the CI gate and `ready.sh` on a six-app copy (#788)**: a hand-written `# READY FOR BENCH (fix round 6, …)` heading passed the `ready` check (READY followed by words now counts; heading markup stripped); `ready.sh` ran over 300 s with no output (every external step now names itself, has stdin closed and a watchdog, `MXTK_READY_STEP_TIMEOUT`, default 120 s; a killed step is NOT MEASURED); the `order` check counted 0 of 234 per-app scripts (`apps/<App>/mdlsource/` now counted); and Stage 5 returned an empty verdict on any project with neither a look ledger nor a summary (`rows` unbound under `set -u`, introduced earlier in this PR); on the re-run, claims in a lowercase root `status.md` were not scanned (root status/progress/resume files now matched in any case), and an annotated `- Interview mode: auto (…)` line, which `interview-mode.sh` resolves to steering, waived the independent review (the raw line's first word now decides whether the review is owed) — parent session's field run
- new(ci, ready): **the gate an agent cannot skip, and a READY nobody can hand-write.** `bin/ci-gates.sh` runs in the project's own CI (`.github/workflows/toolkit-gates.yml`, from `templates/ci/`, installed by `init-project.sh` and `sync-project.sh` create-if-absent, never overwritten, beside any existing CI) on every push and PR, over the committed tree at the pinned toolkit commit: the claimed stage's gate FAILs, a READY line `bin/ready.sh` did not write (`bin/lib/ready-claims.sh`, also a Stage 6 FAIL), committed unseen pages under a done-claim, and model work before Stage 4 all fail it (otherwise it prints `look: K of N pages seen` as a visible warning), in seconds, with no Mendix runtime. `ready.sh` now also requires the position (stages P and 0–4 PASS, WAIVED or not owed by the entry mode: a field run wrote READY with Stage P never passed), honours `Waived obligation must-haves`, writes a review packet (`docs/progress/review-packets/<scope>.html`: screenshot beside target with the reviewer's score, paths only), reads the must-have mark on its tracked path `docs/progress/must-haves/<Module>.md`, and names every app of a multi-app project instead of checking nothing (field runs, 2026-11: agents skip in-session gates; a hand-written READY graded a 0-of-78-looked build done) — two unattended field runs
- new(ready, look-ledger, gate-check): **READY is earned through one command, and its evidence is in git.** `bin/ready.sh <project-root> [--module M | --app A]` runs `gate-check.sh` Stage 5 (Stage 6 once the register is there), the look ledger, the must-have list when present and, under `Interview mode: auto`, an independent reviewer's verdict file (`docs/progress/look-reviews/`, every page scored 1–5 after its last build, below 4 blocks); it prints K of N per check, exits non-zero unless all pass, writes the READY line to `docs/progress/ready.log` itself and commits `docs/progress/ready-<date>-<scope>.md` with explicit paths. `look-ledger.sh summary --write` puts the git-ignored ledger into a tracked `docs/progress/look-summary.tsv` (written by `ready.sh` and every `close-task.sh`), and `gate-check.sh` Stage 5 reads it when the ledger is absent, so a copy of the repo reports FAIL instead of MANUAL. `dispatching.md` gains the reviewer dispatch rule; the `ready` routing row reaches `CLAUDE.local.md` and every agent stub (field runs, 2026-11: a build wrote READY by hand with 0 of ~78 pages looked at; another marked itself ready 3 hours early with no review pass) — two unattended field runs
- process(entry modes): **greenfield is retired; two doors replace it** (stacked on the mode-contract PR): an idea for a demo is `Build type: poc` (unchanged), an idea for a real app is requirements-driven with the conversation as the source (Stages 1–2 a short interview that writes the BRDs, then 3–6 as usual; the small-project tier and `Pipeline mode: high-speed` keep it light) — no mode skips design and planning any more. `sync-project.sh` maps a register's `Entry mode: greenfield` to `requirements-driven` once (old line kept as a comment), adopted at the stage its readout shows through `gate-check.sh --adopt` (so under `Interview mode: auto` it is a ✋ human-pending decision), with `ENTRY-MODE-MAPPED` and `TOOLKIT-ADOPTED-AT` rows in `docs/BUILD-LOG.md`. `greenfield` is dropped from `artifact-manifest.tsv` column 6 and `obligations.tsv` column 10 (now `migration,requirements,existing-app-change`; `test-mode-contract.sh` V checks both against the reader). Until synced, gate-check, status and exec.sh print one "run sync" line and excuse nothing (the tokeniser reads it as `greenfield-retired`; the artifact check owes every row). A POC that becomes a real app hands its hand-over to a requirements-driven build or starts change-an-existing-app, stated once in the runbook (rule 4). `poc-build.md` gains step 0 "Inputs" (read a supplied spec once, list use cases/rules/must-haves; over POC size, recommend requirements-driven in the same message). Runbook, intake Q1, interview-protocol, README, toolkit-guide, `CONVERSION-RUNBOOK.md`, `pipeline-walks.html` and 12 skills' mode lists updated; the 2026-07-14 misclassification note is kept. Fixture `tests/wave2/test-greenfield-retired.sh` — owner decision, Nov 2026
- process(obligations): **`bin/lib/obligations.tsv` gains column 10 `modes`, the same column, tokens and tokeniser as `artifact-manifest.tsv` (`migration,requirements,greenfield,existing-app-change`, read through artifact-check.sh's own `_art_entry_mode`, never a second copy of its mapping)**: a row the register's `Entry mode:` does not list reads `N/A — not owed (entry mode …)`, never PASS; no or unrecognised mode = owed. Every row lists all four modes today, so no verdict changes; the column lets a mode that genuinely skips a pass be excused by data instead of by absence. Fixture `test-obligation-quality-floor.sh` T9 — follow-up to #787
- fix(obligations): **`Must-haves: advisory` for projects already past Stage 5 when the must-haves row arrived (follow-up to #787)**: `sync-project.sh` writes one `Must-haves:` line into `PROJECT.md` when none exists, and only then: `advisory — joined at stage N before the must-haves row existed` when gate-check's derived Current stage or `Adopted at stage:` is 6 or 7, else `bound`. `init-project.sh` writes `bound` for new projects. An advisory project's `Obligation must-haves` row reads `ADVISORY` and is left out of the pending count; `bound` keeps PENDING. It is keyed on the written line, not the project's position: a position check would silence a new project the day it passed Stage 5 without the marks. Fixture `tests/wave2/test-must-haves-advisory.sh` — owner request at the review of #787
- fix(obligations): **a quality floor in every entry mode: no per-module obligation reads PASS by absence, and a new `must-haves` row owes one mode-independent checklist per module**: with no module brief and no verify run, `obligation-check.sh` printed `Obligation look PASS — no module has been opened for work yet; nothing owed` (and the same for fidelity, sweep, journeys) on a project that had built ~78 pages and reviewed 0. Now an empty planned scope falls back to the modules that hold built pages, read from the look ledger (`.claude/loop/look/owed.tsv`), else page statements in the project's `*.mdl` scripts, else `.claude/loop/page-scope.json`, each looked for at the root, `app/` and `apps/*/`; every module row reads PENDING with an `OWED BY WHAT WAS BUILT: N page(s) built in M module(s) (...), K of M module(s) discharged` line. A model that has been built on (exec rows in `docs/BUILD-LOG.md`, `*.mdl` scripts, or a derived stage at 5+) with no countable pages is one FAULT naming `bin/page-scope.sh`, never "0 pages"; a `.mpr` with no build evidence (a fresh scaffold) keeps master's PASS line, so `bin/status.sh` still reads `modules opened: 0`. `existing-app-change` never takes scope from `page-scope.json`, which lists the whole model. A project with briefs keeps every earlier verdict. `skills/must-haves.md` (new, on demand) is the single source of poc-build.md's 12-row must-have checklist, generalised to every build type, plus row 13: every region the design shows is on the built page, counted; `poc-build.md` points to it, `module-review.md` stage 5 requires its mark `docs/progress/must-haves/<Module>.md` (first line `13 of 13 rows ticked or NOT DONE with a reason`). Informational, like every obligation row: no gate verdict or exit code changes; synced projects at Stage 5+ gain one `must-haves` PENDING row per module. Always-loaded words 64,984 -> 65,032 (budget 80,000). Fixture `tests/wave2/test-obligation-quality-floor.sh` — two field runs, unattended and requirements-driven, Nov 2026
Expand Down
3 changes: 2 additions & 1 deletion CONVERSION-RUNBOOK.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@ Then open your agent (Claude Code or equivalent) in `<project-root>` and say wha
|---|---|---|
| Legacy source code | Migration | P, 0–7 |
| Requirements/specs only, no code | Requirements-driven | P, 1–6 |
| Just an idea / existing plan | Greenfield | P (light), 5–6 |
| Just an idea — a real app | Requirements-driven, the conversation as the source | P, 0–6 |
| Just an idea — a demo | `Build type: poc` (`skills/poc-build.md`) | its own steps 1–9 |
| A live Mendix app you are changing | Change an existing app | P, 0–6 per change |

## Running unattended — the kick-off brief
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ commands that run at every step: `docs/pipeline-walks.html`.
|---|---|---|
| **Migration** | Legacy source code exists | P, 0 to 7 |
| **Requirements-driven** | Specs, BRDs or wireframes, no code | P, 0 to 6 |
| **Greenfield** | Just an idea or a plan | P (light), 0, 5, 6 |
| **Requirements-driven, from a conversation** | Just an idea for a real app (a demo: `Build type: poc`) | P, 0 to 6 |
| **Change an existing app** | A live `.mpr` you add to or alter | P, 0 to 6 per change |
| **À la carte assurance** | Audit or a test net only | none |

Expand Down
2 changes: 1 addition & 1 deletion bin/ci-gates.sh
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
# committed summary behind it fails: the claim cites evidence nobody can read.
# (d) order model work before its plan: docs/BUILD-LOG.md has exec rows (or mdlsource/ holds build
# scripts outside gallery/) while gate-check Stage 4 is not PASS/WAIVED. gate-check already
# waives Stage 4 for greenfield and for an --adopt point at or after it.
# waives Stage 4 for an --adopt point after it (and Build type: poc, where it is not owed).
#
# WHAT IT CANNOT SEE (anything not committed): the git-ignored .claude/loop/ ledgers themselves (only
# the summary ready.sh / close-task.sh commit), screenshots, chat, a model edited without exec.sh and
Expand Down
7 changes: 3 additions & 4 deletions bin/gate-check.sh
Original file line number Diff line number Diff line change
Expand Up @@ -742,10 +742,6 @@ stage_waiver() {
# Entry mode. The runbook's Entry Modes table already says these stages do not run; until now
# the gate did not know that, so it demanded artifacts the runbook had excused.
case "$ENTRY_MODE" in
greenfield)
case "$st" in
1|2|3|4) printf 'mode|not owed (mode: greenfield) — stages 1–4 collapse into the design front end and short plan (conversion-runbook.md → Entry Modes)\n'; return 0 ;;
esac ;;
requirements-driven)
case "$st" in
7) printf 'mode|not owed (mode: requirements-driven) — no legacy system to cut over from; if legacy data turns up, record a Stage-7 decision and this goes back to being checked (conversion-runbook.md → Entry Modes)\n'; return 0 ;;
Expand Down Expand Up @@ -4186,6 +4182,9 @@ printf "Summary: %d passed · %d not started · %d waived · %d need attention
if [ -z "$ENTRY_MODE" ] && [ -z "$ADOPTED_AT" ] && [ -n "${MXTK_POS_BANNER:-}" ]; then
printf '⚠ %s\n' "$MXTK_POS_BANNER"
fi
if [ "$ENTRY_MODE" = greenfield-retired ] && [ -n "${MXTK_POS_RETIRED:-}" ]; then
printf '⚠ %s\n' "${MXTK_POS_RETIRED/<project>/$PROJECT_DIR}"
fi

# The stage counts above are about STAGES. They say nothing about the per-module passes and the
# per-stage artifacts checked further up, and for a long time nothing down here did either — so
Expand Down
4 changes: 2 additions & 2 deletions bin/init-project.sh
Original file line number Diff line number Diff line change
Expand Up @@ -467,7 +467,7 @@ fi
# resolves $ANALYSIS_BASE against it. sources/ was created here from day one; analysis/ was not,
# on the unstated assumption that an extraction pipeline would `mkdir -p` it on its way past.
#
# That assumption holds for exactly one entry mode. A requirements-driven or greenfield project
# That assumption holds for exactly one entry mode. A requirements-driven project or a POC
# runs no pipeline, so nothing ever created the folder, so every surface the runbook promises had
# nowhere to be written — reported from a customer round on 2026-08-20, where the absence of
# analysis/ was the first visible symptom of a much larger hole (Stage 0 being skipped entirely).
Expand Down Expand Up @@ -497,7 +497,7 @@ and the honest way to change one is to re-run its producer.
| `extraction-report.html` | the extraction pipeline, or `kb-generation.md` for a document corpus | 1 |
| `brd-report.html` | `bin/brd-report.sh <project> [--stage N]`: process map, requirements and open questions | 2, any gate |

**This folder exists in every entry mode.** A requirements-driven or greenfield project runs no
**This folder exists in every entry mode.** A requirements-driven project (or a POC) runs no
extraction pipeline, but it still produces a sufficiency grade, a scope decision and a BRD report
— `bin/brd-report.sh` reads BRDs, not source, so the Stage 2 surface is the same page whatever
wrote the BRDs.
Expand Down
1 change: 1 addition & 0 deletions bin/lib/artifact-check.sh
Original file line number Diff line number Diff line change
Expand Up @@ -217,6 +217,7 @@ _art_entry_mode() {
local tok; tok="$(entry_mode_token "$raw")"
case "$tok" in
requirements-driven) echo "requirements" ;;
greenfield-retired) echo "" ;; # retired, not yet synced: every row owed — louder, never quieter
*) echo "$tok" ;;
esac
}
Expand Down
Loading
Loading