Skip to content

Add concise PyAutoBrain agent commands#16

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/brain-agent-commands
Jul 7, 2026
Merged

Add concise PyAutoBrain agent commands#16
Jammy2211 merged 1 commit into
mainfrom
feature/brain-agent-commands

Conversation

@Jammy2211

Copy link
Copy Markdown
Contributor

Summary

A thin, human-friendly command veneer over the existing bin/pyauto-brain
router. 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".

Users speak in short commands; PyAutoBrain performs the routing.

The router already existed (bin/pyauto-brain + conductors/faculties). This PR is
the missing user-facing surface, and is deliberately honest about which agents
exist today.

Commands

Command Routes to Tier
/feature Feature Agent → start_dev real conductor
/build Build Agent → vitals → Heart → PyAutoBuild real conductor
/health Health Agent loop → vitals → Heart real conductor
/bug /refactor /docs /research start_dev pre-tagged with the work-type work-type entry*
/route <text> infers the work-type and dispatches NL router
/brain <agent> raw bin/pyauto-brain passthrough debug door

* 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

  • Each verb is a thin skills/<verb>/<verb>.md (no SKILL.md), which
    bin/install.sh already turns into a flat ~/.claude/commands/<verb>.md. No
    installer change needed
    skills/ is already a scanned root.
  • Shared architecture prose lives in one skills/COMMANDS.md (reference-only; the
    installer's dir-scan skips it), so command bodies stay short.
  • Docs added to AGENTS.md and README.md.

Validation

  • bin/check_skill_line_counts.sh → all primary files ≤200 lines.
  • Discovery simulation → all 9 verbs map to flat commands; COMMANDS.md stays
    reference-only.
  • No-bypass grep → every command body routes via pyauto-brain / start_dev.

Follow-ups (not this PR)

  • Promote bug / refactor / docs / research to dedicated conductors, each
    when its behaviour earns a front door.
  • Reconcile /health with /health_check and /pyauto-status (one health door).

🤖 Generated with Claude Code

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>
Copilot AI review requested due to automatic review settings July 7, 2026 18:55
@Jammy2211 Jammy2211 merged commit 0a23663 into main Jul 7, 2026
1 check passed
@Jammy2211 Jammy2211 deleted the feature/brain-agent-commands branch July 7, 2026 18:56

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.md that the commands point to for consistent, centralized routing/architecture context.
  • Updates README.md and AGENTS.md to 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.

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.

2 participants