claude-consult

Claude Consult

Get expert help from Claude specialist agents during implementation. Each agent has domain-specific skills pre-loaded and tools scoped to its role.

This is NOT a replacement for the review gates. The agent-loops skill defines formal code review (specialist-review) and test audit (diff-test-audit) gates that run after implementation. This skill is for asking questions during implementation — before you've written code, while you're writing it, or when you're stuck.

When to Use

• "How does this module work?" — before implementing
• "Does my approach match existing conventions?" — while implementing
• "Is this pattern secure?" — before committing to a design
• "Why is this test failing?" — when stuck
• "What do the testing standards say about X?" — before writing tests
• "Is this component accessible?" — during UI work

How to Invoke

claude -p --agent <agent-name> "<your question>"

All agents run headless (-p / print mode). They read the codebase, apply their loaded skills, and return an answer to stdout. Capture or pipe as needed:

# Direct invocation
claude -p --agent debugger "Why is test_auth_flow failing in src/auth/tests.py?"

# Capture to variable
ANSWER=$(claude -p --agent security-auditor "Is the input validation in src/api/handler.py safe?")

# Save to file
claude -p --agent architect-reviewer "Does adding a cache layer between api and db match the existing architecture?" > /tmp/arch-advice.md

Agent Roster

Codebase Understanding

Agent	Use when you need to...	Skills loaded
search-specialist	Find where something is defined or called	codanna-codebase-intelligence
architect-reviewer	Evaluate module boundaries and dependencies	system-design, api-design-patterns
docs-architect	Understand existing documentation structure	documentation-production, code-explanation

Code Quality & Patterns

Agent	Use when you need to...	Skills loaded
code-reviewer	Check if code follows project conventions	code-quality-workflow, testing-anti-patterns, secure-coding-practices
refiner	Get suggestions for improving code quality	code-quality-workflow
rest-expert	Design or check REST API patterns	api-design-patterns