Rename PyAutoAgent to PyAutoBrain - #1
Merged
Conversation
Rename the repository from PyAutoAgent to PyAutoBrain, reframing it as the reasoning layer of the PyAuto organism rather than a generic host of "agents". - bin/pyauto-brain is now the canonical CLI; bin/pyauto-agent is a thin back-compat shim that forwards to it. - Re-centre the docs (README, AGENTS, CLAUDE, per-agent AGENTS) on reasoning, planning and orchestration, and clarify the organism boundary: Mind decides what -> Brain figures out how -> Hands perform -> Heart says whether it is healthy. - Update the call chain to Brain -> Heart (gate) -> Build (execute) and resolve the health authority via pyauto-heart/PyAutoHeart (the former pyauto-pulse/PyAutoPulse), which keeps a pyauto-pulse back-compat shim. - agents/ remains the home of the specialist reasoning agents (release, health). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XjtgzzCWQXzNZDdB2XKLBJ
There was a problem hiding this comment.
Pull request overview
Renames the repo’s framing and user-facing CLI from PyAutoAgent to PyAutoBrain, positioning it as the organism’s reasoning/orchestration layer and updating the documented boundary and call chain to Brain → Heart (gate) → Build (execute) while preserving backward compatibility via a pyauto-agent shim.
Changes:
- Added
bin/pyauto-brainas the canonical CLI dispatcher; convertedbin/pyauto-agentinto a forwarding shim. - Updated shared helpers and both specialist agents (
release,health) to resolve and drive PyAutoHeart (pyauto-heart) instead of PyAutoPulse. - Rewrote top-level and per-agent documentation to reflect the Mind/Brain/Hands/Heart/Memory model and updated command examples.
Reviewed changes
Copilot reviewed 8 out of 10 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Updates repo description, organism model, call chain, and usage examples for PyAutoBrain/PyAutoHeart. |
| CLAUDE.md | Updates Claude guidance wording and notes the rename + CLI change. |
| bin/pyauto-brain | New canonical CLI dispatcher for specialist reasoning agents. |
| bin/pyauto-agent | Replaced full dispatcher with a back-compat shim to pyauto-brain. |
| agents/_common.sh | Updates organ resolution helpers to prefer pyauto-heart and adjusts messaging. |
| agents/release/release.sh | Updates release agent to reason over Heart readiness and delegate to Build. |
| agents/release/AGENTS.md | Updates release agent docs and examples to PyAutoBrain/PyAutoHeart chain. |
| agents/health/health.sh | Updates health agent to forward to pyauto-heart and refreshed messaging. |
| agents/health/AGENTS.md | Updates health agent docs and examples to pyauto-heart and new framing. |
| AGENTS.md | Updates canonical repo guidance to the organism model, Brain/Heart/Build boundary, and rename notes. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
The Hands organ (PyAutoBuild) builds and releases the software (packaging, tagging, notebooks, PyPI) — "performs the work" was imprecise. Rephrase the organism boundary in README.md and AGENTS.md accordingly. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XjtgzzCWQXzNZDdB2XKLBJ
This was referenced Jul 28, 2026
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.
Summary
Renames this repository from PyAutoAgent to PyAutoBrain, reframing it as the reasoning layer of the PyAuto organism rather than a generic host of "agents". Implements the
autoprompt/autobrain.mdtask from PyAutoMind.The organism boundary is now stated explicitly and consistently:
Call chain updated from
Agent → Pulse → BuildtoBrain → Heart (gate) → Build (execute).Changes
bin/pyauto-agent→bin/pyauto-brain(canonical), internals renamed (BRAIN_HOME, reasoning-framed help text).README.md,AGENTS.md,CLAUDE.md, and both per-agentAGENTS.mdrewritten to centre on reasoning/planning/orchestration and clarify the Mind/Brain/Hands/Heart boundary.agents/_common.sh,agents/release/release.sh,agents/health/health.shnow resolve and drive the PyAutoHeart health authority (pyauto-heart, formerlypyauto-pulse/PyAutoPulse). Behaviour and exit codes are unchanged.agents/remains the home of the specialist reasoning agents (release,health).Backwards compatibility
bin/pyauto-agentis kept as a thin shim that forwards every invocation topyauto-brain.pyauto-heart; PyAutoHeart itself retains apyauto-pulseshim, so the chain stays compatible.README.md/AGENTS.md/CLAUDE.md.Validation
bash -nsyntax-checks pass for all five shell scripts.bin/pyauto-brain help/help release/help healthrender correctly.bin/pyauto-agentshim correctly forwards topyauto-brain.🤖 Generated with Claude Code
Generated by Claude Code