Skip to content

docs: absorb Claude notes into the AGENTS.md policy block; trim skill descriptions (#492) - #493

Merged
Jammy2211 merged 3 commits into
mainfrom
feature/absorb-claude-notes-agents-md
Oct 7, 2026
Merged

Jammy2211 merged 3 commits into
mainfrom
feature/absorb-claude-notes-agents-md

Conversation

@Jammy2211

Copy link
Copy Markdown
Contributor

Closes #492. Sibling of PyAutoMind#482 (CLAUDE.md pointer retirement).

Why

Claude Code ≥ 2.1.277 loads AGENTS.md natively, so every CLAUDE.md is being retired (PyAutoMind#482), including the unversioned workspace-root CLAUDE.md whose "Claude-specific notes" need a versioned, agent-agnostic home. That home is policy/workspace_model_delegation.md, which bin/install.sh already renders into the root AGENTS.md as the pyauto:model-delegation block. Measured on 2.1.292: a fresh delegated subagent does receive the full AGENTS.md hierarchy 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 left WORKFLOW.md on 2026-09-18 (a7d8fce), so the block points at MODEL_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-policy OK 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 by test_chat_orchestration_contract.py) with a pointer from MODEL_DELEGATION.md.
  • Stale CLAUDE.md references dropped or marked legacy in ORGANISM.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.py keep the pattern as tolerated-legacy until fix: honor absent witnesses and unresolved triage in sizing #482's wave removes the assistants' scripts/CLAUDE.md (their clone-boundary.yml CI would otherwise fail on unclassified files); _memory.py reads only wiki/AGENTS.md.
  • Skill descriptions > 300 chars trimmed to ≤ 250 (cortex, sampler_pipeline, ci_speedup, community, intake, batch, board, issue_cleanup, hygiene, eyes, feedback); trigger phrases kept, no renames, YAML valid. Descriptions are listed in every session and every delegated subagent, and SKILL.md installs into both the Claude and Codex skill roots.
  • Tests: 1291 passed in a clean shell (one test_grouped_organ_consumers failure appears only when activate.sh is sourced — pre-existing env leak). repos_sync.py --check: all Brain-owned generated blocks OK.

Follow-ups

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.py edits are internal file-pattern lists).

Test Plan

  • python3 -m pytest -q -n auto in PyAutoBrain (clean shell, no activate.sh): 1291 passed
  • repos_sync.py --check from the bundle root: all generated blocks OK (only the bundle-root autofit_inference / autofit_profiling checkout-manifest mismatch, unrelated to this branch)
  • After merge: re-run bin/install.sh in the root workspace and confirm the pyauto:model-delegation block renders

🤖 Generated with Claude Code

https://claude.ai/code/session_01QmiavJnNzmKb6EJmgYATfx

Jammy2211 and others added 3 commits October 7, 2026 13:41
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
@Jammy2211
Jammy2211 merged commit 8048a2f into main Oct 7, 2026
3 checks passed
@Jammy2211
Jammy2211 deleted the feature/absorb-claude-notes-agents-md branch October 7, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore: absorb Claude notes into AGENTS.md policy block; drop stale CLAUDE.md refs

1 participant