new(entry modes): wire "Change an existing app" as the fourth pipeline entry mode; Windows test-run prompt - #126
Merged
Conversation
Adds docs/windows-test-run.md: a paste-able, unattended Claude Code prompt for a Git Bash machine. Covers the CI guard scripts, both fixture suites, 27 Windows-relevant fixtures with their subjects, the committed inputs (fixtures/app-analysis, page-fidelity mocks, html-to-md capture) run directly, and a field run on a scratch copy of a real project including the two-tree and toolkit.env precedence probes. Produces one results file, facts only. CHANGELOG line added in the same commit. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
Both already listed migration, requirements-driven, greenfield and the a-la-carte no-pipeline route; only the headlines said three, so sessions reading the headline reported three entry modes while the runbook and CLAUDE.md said three plus a-la-carte. Wording is now: three pipeline entry modes plus one route with no pipeline at all. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
# Conflicts: # CHANGELOG.md
…e entry mode Until now only gate-check.sh knew the existing-app-change mode: intake.md Q1 offered three modes, the runbook's classification rules had no rule for a live .mpr being altered, and the artifact manifest owed that mode nothing. A session changing a live app therefore had no option to pick (field run, 2026-09-22). - intake-template.sh: Q1 lists four modes with ordered classification rules; the answer is recorded verbatim as "Change an existing app", which entry-mode.sh already maps to existing-app-change. - conversion-runbook.md: new rule 1 + table row for the mode (P, 0-6 per slice, Path D, regression gates from Stage 5, Stage 7 N/A); incident note. - CONVERSION-RUNBOOK.md pointer table: matching row. - artifact-manifest.tsv: existing-app-change added to every P-6 row except coverage-ledger (that mode's ledger is `mxcli brain plan`). - README.md, toolkit-guide.html, CLAUDE.md: four pipeline modes plus the a-la-carte no-pipeline route, i.e. five ways in. - CHANGELOG.md: entry appended. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
sync-project.sh reports the missing kickoff question using the current template's heading, which now names the fourth entry mode; the fixture still grepped for the three-mode wording. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
MendixMau
marked this pull request as ready for review
September 22, 2026 12:45
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed and why
Two things ride on this branch.
1. "Change an existing app" is now a wired fourth pipeline entry mode (
d0cd109)Until now only
bin/gate-check.sh(viabin/lib/entry-mode.sh) knew theexisting-app-changemode.intake.mdQ1 offered three modes, the runbook's classification rules had no rule for a live.mprbeing altered, and the artifact manifest owed that mode nothing. A session changing a live app therefore had no option to pick, even though gate-check would have waived Stage 7 correctly had it been picked.bin/lib/intake-template.sh— Q1 now lists four modes with ordered classification rules (live.mprbeing altered → change an existing app; else legacy source → migration; else specs → requirements-driven; else greenfield) and tells the agent to record the answer verbatim asChange an existing app, whichentry-mode.shalready maps toexisting-app-change. À-la-carte audit/testing is called out as not a mode.skills/conversion-runbook.md"Entry Modes" — new rule 1 (existing rules renumbered), a table row for the mode (stages P, 0–6 per slice; Stage 1 = Path D; every gate from Stage 5 is a regression gate; Stage 7 N/A; ledger ismxcli brain plan), and the incident note.CONVERSION-RUNBOOK.mdpointer table — matching row.bin/lib/artifact-manifest.tsv—existing-app-changeadded to every P–6 row exceptcoverage-ledger; header comment documents the policy. Stage-3 rows stay owed: a collapsed Stage 3 is recorded via the register's stage waiver, never by silence.README.md,toolkit-guide.html,CLAUDE.md— four pipeline entry modes plus the à-la-carte no-pipeline route, i.e. five ways in (new guide card, new README bullet).CHANGELOG.md— entry appended in the same commit.2. Windows full test-run prompt (
2b13f57,7796929)Adds
docs/windows-test-run.md: a single paste-able, unattended Claude Code prompt for a Windows (Git Bash) machine that runs CI guards, both fixture suites, 27 Windows-relevant fixtures with their correct subjects, the tools on committed inputs, and a field run on a scratch project, writing one results file (PASS/PASS(known)/FAIL/SKIP). Placeholders only, no home paths, no client names. Also fixes the README / guide headlines that still said "three ways in".Field evidence
intake.mdQ1 offering only three modes whilegate-check.shalready reported Stage 7WAIVEDand Stage PPASSforexisting-app-change. Locally verified in this branch:entry_mode_token "Change an existing app"→existing-app-change; manifest parses to 38 data rows of 7 columns, 37 carrying the mode;check-scripts,check-portability, leak guard,check-pr-discipline, andrender-routing.sh --checkall clean. End-to-endinit-project.sh→ intake Q1 →gate-check.shon a "Change an existing app" project is the user's next test in a separate session.bin/,project-bin/,tests/,fixtures/path checked to exist onmaster(0 missing). The Windows results file is the field evidence and comes back as a follow-up.Checklist
check-scripts,check-portability,check-pr-discipline,render-routing --checkclean locallyROUTING:BEGIN/ENDuntouched🤖 Generated with Claude Code
https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw