Notable changes to the Build framework. Newest first.
Build was written in and for Claude Code. The skills were always written to the Agent Skills open standard, but the docs and file layout assumed one tool. This release makes the framework's portability real and explicit.
What this means for you: you can now run the whole workspace in Codex, opencode, Cursor, Gemini CLI, or any other agent that implements the Agent Skills and AGENTS.md standards - without editing a single skill. If you're on Claude Code, nothing changes; CLAUDE.md still works, it's just a symlink now.
AGENTS.mdis the canonical instruction file, withCLAUDE.mdsymlinked to it.AGENTS.mdis the cross-tool convention (Codex, opencode, Cursor, ~20 others); Claude Code reads onlyCLAUDE.md, and Anthropic documents this symlink as the supported bridge. EditAGENTS.md, never the symlink.- Skills are reachable at both discovery paths. They still live at
.claude/skills/, with.agents/skillssymlinked to the same folder, because Codex scans.agents/skillsand never.claude/skills. One copy, no drift. - New
docs/portability.md- what runs where, per-tool setup, and an honest tested-vs-assumed table. Verified: Claude Code and opencode (all 8 skills load unmodified, peropencode debug skill). Assumed: everything else on the spec's client list. templates/PROJECT-CLAUDE.mdrenamed toPROJECT-AGENTS.md, andonboard-project/tune-personanow generate a per-projectAGENTS.mdplus itsCLAUDE.mdsymlink. Claude Code discovers nestedCLAUDE.mdbut not nestedAGENTS.md, so both are needed.- Docs reworded tool-neutrally. The Claude Code specific parts (auto-memory, plugins, SessionStart hooks) are now flagged as such, with guidance on what to swap. None of them are load-bearing.
- Windows note: the repo uses symlinks, which need Administrator or Developer Mode.
SETUP.mdanddocs/portability.mddocument the@AGENTS.mdimport fallback.
Reconciled ahead of the public release:
- New
review-prepskill ported from live use: dispatches a fresh-context agent to read a project's STATUS/docs/decisions and produce a pre-review punch list (pulse, decisions waiting, decisions closed, stale/at-risk flags, the 3 questions for the meeting). The fresh-context dispatch is the point - a cold reader catches STATUS drift and cross-artifact risks the operator's own working memory misses. Validated across two project shapes before porting. - Optional templates from real projects:
STRATEGY.md(durable vision/roadmap),EXPERIMENT.md(thesis-under-test),CONTEXT-BRIDGE.md(PM <-> separate engineering repo), andFREELANCE-ENGAGEMENT.md(billable engagement log). onboard-projectnow generates a per-project persona file from the persona interview as a first-class output, not an optional afterthought.process-documentgained transcript handling - detects call transcripts and runs an ASR-cleaning sub-agent (incl. non-English translate-to-English) before summarizing.- Richer
DECISION.md- status vocabulary now aligns with the standard ADR lifecycle (proposed / accepted / deprecated / superseded / revisiting).
CLAUDE.mdis now workspace-level, not per-project. The per-project version moved totemplates/PROJECT-CLAUDE.md.- New
WORKSPACE.mdexplains why Claude should run from the workspace root, not each project folder. - New
docs/section covers the auto-memory system, Obsidian integration, and the plugin ecosystem. - Two new skills ported from live use:
tune-personaandgit-week. templates/WAYS-OF-WORKING.mdadded (the triad of BRIEF/STATUS/WAYS was referenced but the template was missing).examples/adscale-case-study/- a fully anonymized real project, included inline so you can see the framework in action.