feat(stack): portable single-source engineering method + multi-agent install - #10
Merged
Conversation
Closes the portability gaps surfaced by the install audit: the full method lived only in machine-local agent configs, and install.sh did not wire the newer components. - AGENTS.md: expand 190 -> 250 lines into the COMPLETE canonical Layer-1 playbook (senior reflexes: ADR/RFC, sanitizers, FFI, lock hierarchy, RT telemetry, fuzz/property tests, CODEOWNERS, supply-chain, perf budgets, Boy Scout...). It is now the single source every tool config references via @AGENTS.md instead of re-stating the rules. - scripts/setup-agents.sh: idempotent, OS-aware linker that wires the anti-debt agent into every detected agent root (symlink on Linux/macOS, junction on Windows). Verified against existing Claude + Mavis links. - PORTABILITY.md: full multi-agent transfer guide (3-layer model, new-machine bootstrap, per-agent setup for Claude Code / MiniMax-Mavis / Cursor / Codex, in-repo vs machine-local matrix, verification steps). - install.sh: fix stale header comment; add a NEXT STEPS pointer to setup-agents.sh + PORTABILITY.md for the global multi-agent setup. - README: add engineering-method/hooks/anti-debt to the components, plus a whole-stack transfer section linking PORTABILITY.md.
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
1 participant
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.
Why
Install/portability audit found two gaps:
~/.claude/CLAUDE.md828 l. + Mavisagent.md50 KB). The repo only shipped the distilledAGENTS.md(190 l.) — a new machine/LLM inherited a partial method.install.shdid not wire the newer components (hooks/,anti-debt,scripts/).What
AGENTS.md→ complete canonical source (190→250 l.). Adds the full senior playbook (ADR/RFC, sanitizers+Miri, FFI conventions, lock hierarchy, RT lock-free telemetry, fuzz/property tests, CODEOWNERS, supply-chain scans, perf budgets, debt SLA, Boy Scout…), DRY against the distilled core. Now the single source every tool config references via@AGENTS.md.scripts/setup-agents.sh— idempotent, OS-aware linker (symlink Linux/macOS, junction Windows) that wires the anti-debt agent into every detected agent root. Verified against existing Claude + Mavis links (already linked correctly).PORTABILITY.md— full transfer guide: 3-layer model, new-machine bootstrap, per-agent setup (Claude Code / MiniMax-Mavis / Cursor / Codex), in-repo vs machine-local matrix, verification.install.sh— fixed stale header; NEXT STEPS now point to the global setup.README— components + whole-stack transfer section.Verification
setup-agents.sh --dry-run→ idempotent, both agentsalready linked correctlybash -nOK on both scriptsNo Python source changed — docs + bash only.