Repository navigation
docs: absorb Claude notes into the AGENTS.md policy block; trim skill descriptions (#492) - #493
Merged
Merged
Conversation
Fold the workspace-root "Claude-specific notes" into the generated pyauto:model-delegation block in provider-neutral wording, corrected: Sonnet floor is ship_* step 4 / pre_build step 2, the heartbeat lives in MODEL_DELEGATION.md's bounded worker contract, and workflow slash commands come from the installed skills. Collapse the duplicated model-delegation and no-OpenAI-API-fallback passages in WORKFLOW.md to pointers into MODEL_DELEGATION.md; keep the independent-review rule's home in WORKFLOW.md. Refs #492 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QmiavJnNzmKb6EJmgYATfx
Point Build/Heart capability notes, ORGANISM, repo_cleanup and the harness smoke doc at AGENTS.md (or the ship/prm close-out) instead of CLAUDE.md. The memory faculty now recalls wiki/AGENTS.md only; the clone boundary and workspace regroup keep CLAUDE.md as a legacy, absence-tolerant pattern so reference assistants still classify cleanly until their pointers retire. Refs #492 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QmiavJnNzmKb6EJmgYATfx
Skill descriptions are listed in every session and every delegated subagent for both the Claude and Codex skill roots. Trim the eleven over 300 characters (cortex, sampler_pipeline, ci_speedup, community, intake, batch, board, issue_cleanup, hygiene, eyes, feedback) to <= 250 while keeping their trigger phrases. No skill is renamed. Refs #492 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QmiavJnNzmKb6EJmgYATfx
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.
Closes #492. Sibling of PyAutoMind#482 (CLAUDE.md pointer retirement).
Why
Claude Code ≥ 2.1.277 loads
AGENTS.mdnatively, so everyCLAUDE.mdis being retired (PyAutoMind#482), including the unversioned workspace-rootCLAUDE.mdwhose "Claude-specific notes" need a versioned, agent-agnostic home. That home ispolicy/workspace_model_delegation.md, whichbin/install.shalready renders into the rootAGENTS.mdas thepyauto:model-delegationblock. Measured on 2.1.292: a fresh delegated subagent does receive the fullAGENTS.mdhierarchy plus the skill-description list (~18-22k tokens per delegation), so the per-delegation cost is what to trim; nothing needs restating in subagent prompts.What
policy/workspace_model_delegation.md: absorbs the root notes, corrected — the subagent template / "Progress heartbeat" that the old notes pointed at leftWORKFLOW.mdon 2026-09-18 (a7d8fce), so the block points atMODEL_DELEGATION.md's bounded-worker contract and heartbeat; the Sonnet floor is ship_* step 4; slash commands are the installed skills. Body 1069 B; renders and--check-workspace-policyOK on a scratch copy of the root file.skills/WORKFLOW.md/skills/MODEL_DELEGATION.md: "Model delegation" and "No OpenAI API fallback" collapsed into MODEL_DELEGATION.md with one-line pointers; the independent-review rule stays in WORKFLOW.md (pinned bytest_chat_orchestration_contract.py) with a pointer from MODEL_DELEGATION.md.CLAUDE.mdreferences dropped or marked legacy inORGANISM.md,BUILD_CAPABILITIES.md,HEART_CAPABILITIES.md,repo_cleanup/SKILL.md,docs/agent_harness_smoke.md,bin/install.sh,tests/test_memory_surfaces.py._clone.py/regroup_workspace.pykeep the pattern as tolerated-legacy until fix: honor absent witnesses and unresolved triage in sizing #482's wave removes the assistants'scripts/CLAUDE.md(theirclone-boundary.ymlCI would otherwise fail on unclassified files);_memory.pyreads onlywiki/AGENTS.md.SKILL.mdinstalls into both the Claude and Codex skill roots.test_grouped_organ_consumersfailure appears only whenactivate.shis sourced — pre-existing env leak).repos_sync.py --check: all Brain-owned generated blocks OK.Follow-ups
CLAUDE.mdpatterns in_clone.pyandregroup_workspace.py.bin/install.shso the rootAGENTS.mdcarries the new block; delete rootCLAUDE.md(with fix: honor absent witnesses and unresolved triage in sizing #482).API Changes
None — internal changes only. Docs, policy text and skill-description trims; no public Python API added, removed or changed (
_clone.py,_memory.py,regroup_workspace.pyedits are internal file-pattern lists).Test Plan
python3 -m pytest -q -n autoin PyAutoBrain (clean shell, noactivate.sh): 1291 passedrepos_sync.py --checkfrom the bundle root: all generated blocks OK (only the bundle-rootautofit_inference/autofit_profilingcheckout-manifest mismatch, unrelated to this branch)bin/install.shin the root workspace and confirm thepyauto:model-delegationblock renders🤖 Generated with Claude Code
https://claude.ai/code/session_01QmiavJnNzmKb6EJmgYATfx