Add concise PyAutoBrain agent commands#16
Merged
Conversation
Add a thin, human-friendly command veneer over the existing bin/pyauto-brain router so the Brain stays implicit — users type short verbs (or plain natural language) and the Brain routes to the right specialist agent. Users speak in short commands; PyAutoBrain performs the routing. Command tiers (skills/<verb>/<verb>.md; auto-installed as flat commands): - Real conductors: /feature, /build, /health -> existing agents. - Work-type entries: /bug, /refactor, /docs, /research -> start_dev pre-tagged with the PyAutoMind work-type (still through the Brain; no fictional agents). - Router + debug: /route infers the work-type and dispatches; /brain is the raw pyauto-brain passthrough. Shared architecture prose factored into skills/COMMANDS.md (reference-only, not installed) so command bodies stay short and pass check_skill_line_counts.sh. No install.sh change needed — skills/ is already a scanned root. Docs added to AGENTS.md and README.md. Follow-ups (not this PR): promote bug/refactor/docs/research to dedicated conductors; reconcile /health with /health_check and /pyauto-status. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Adds a concise, user-facing command surface under skills/ that maps short verbs (and a natural-language router) to the existing bin/pyauto-brain agents and the start_dev dev-flow, keeping “PyAutoBrain” implicit for normal usage.
Changes:
- Introduces 9 flat command markdown files (
/feature,/build,/health,/bug,/refactor,/docs,/research,/route,/brain) that route into the existing Brain CLI/dev workflow. - Adds a shared reference doc
skills/COMMANDS.mdthat the commands point to for consistent, centralized routing/architecture context. - Updates
README.mdandAGENTS.mdto document the new command surface and its tiering (conductors vs work-type entries vs router/debug).
Reviewed changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| skills/route/route.md | Adds the natural-language routing command that classifies and dispatches to the appropriate verb command. |
| skills/research/research.md | Adds a research/ work-type entry command routed through the Brain dev-flow. |
| skills/refactor/refactor.md | Adds a refactor/ work-type entry command routed through the Brain dev-flow. |
| skills/health/health.md | Adds the /health command as the front door to the Health conductor loop. |
| skills/feature/feature.md | Adds the /feature command routing to the Feature conductor and then into start_dev. |
| skills/docs/docs.md | Adds a docs/ work-type entry command routed through the Brain dev-flow. |
| skills/COMMANDS.md | Centralizes shared command-surface guidance and explains tiers + installation behavior. |
| skills/build/build.md | Adds the /build command routing to the Build conductor and surfacing the vitals verdict. |
| skills/bug/bug.md | Adds a bug/ work-type entry command routed through the Brain dev-flow. |
| skills/brain/brain.md | Adds a debug passthrough command for direct bin/pyauto-brain invocation. |
| README.md | Documents the new implicit-Brain command surface and where command bodies live. |
| AGENTS.md | Documents the command surface alongside the existing CLI/agent architecture description. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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
A thin, human-friendly command veneer over the existing
bin/pyauto-brainrouter. The Brain stays implicit — users type short verbs (or plain natural
language) and the Brain routes to the right specialist agent; normal usage never
says "PyAutoBrain".
The router already existed (
bin/pyauto-brain+ conductors/faculties). This PR isthe missing user-facing surface, and is deliberately honest about which agents
exist today.
Commands
/featurestart_dev/build/health/bug/refactor/docs/researchstart_devpre-tagged with the work-type/route <text>/brain <agent>bin/pyauto-brainpassthrough* No dedicated Bug/Refactor/Docs/Research conductor exists yet, so those verbs
route through the Brain dev-flow with their PyAutoMind work-type fixed — still
through the Brain, nothing bypassed — until each earns promotion. This avoids
shipping four look-alike commands that pretend an agent exists.
Mechanism
skills/<verb>/<verb>.md(noSKILL.md), whichbin/install.shalready turns into a flat~/.claude/commands/<verb>.md. Noinstaller change needed —
skills/is already a scanned root.skills/COMMANDS.md(reference-only; theinstaller's dir-scan skips it), so command bodies stay short.
AGENTS.mdandREADME.md.Validation
bin/check_skill_line_counts.sh→ all primary files ≤200 lines.COMMANDS.mdstaysreference-only.
pyauto-brain/start_dev.Follow-ups (not this PR)
bug/refactor/docs/researchto dedicated conductors, eachwhen its behaviour earns a front door.
/healthwith/health_checkand/pyauto-status(one health door).🤖 Generated with Claude Code