Conversation
… brain into the build loop The module brief gains a Build steps table; context-pack.sh turns a row into a pack (folder plan, brain brief, arch constraints, live DESCRIBEs, example). A/B on a real app's scratch copy, 3 runs each: ~9% fewer tokens, ~40% fewer tool calls and less time, same quality (0 new mx errors, planned folder). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
MendixMau
marked this pull request as draft
October 1, 2026 08:32
…, nested brain headings Field run: 10 helper runs on a real app's scratch copy across five step kinds; page runs went from 1 and 3 CE2421 errors to 0 and 0 with the watch-out. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
… longer escalate for a folder Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
The pack only looked for architecture/modules/<Module>-brief.md. The toolkit's own convention and real specs use <Module>/module-brief.md, so every dispatch there exited 2 and the helper got no pack. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
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 (one paragraph)
A helper used to put its own context together: read the brief, DESCRIBE entities one at a time, look for an example, guess the folder. Every lookup sends the whole conversation again. This PR makes that a single step. The module brief gets a
### Build stepstable, with one row per dispatch listing what the step builds, what it reads, the example to copy, and the brain slice. The newproject-bin/context-pack.sh <Module> <Step>turns that row into one file. The file holds the folder from the folder plan, the why frommxcli brain brief, the arch constraints, and live DESCRIBEs of every element the step reads, of the example, and of anything the step changes. The brief only names elements; the model describes them, and the pack is never committed. If a name is not in the model, the script exits 1 and lists it, so the problem shows up at dispatch time.iterative-build-loop.mdnow turns onmxcli brainat build start and gives every dispatch a pack.mdl-agentreads the pack first and records any why it learns withbrain capture. Also included: a routing row (render-routing re-run), an install-manifest entry and a CHANGELOG line.Field evidence
A/B on a scratch copy of a real app. Each arm built the same bulk-accept microflow with the same brief and the same brain, 3 helper runs per arm.
mxcli check, exec'd with 0 new mx errors and used the planned folder.app/) layouts.Checklist
## Unreleasedbin/render-routing.sh --checkcleanbin/check-scripts.sh,bin/check-portability.shclean🤖 Generated with Claude Code
https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
Generated by Claude Code