Mike Swanson
ab5db78eb2
Reduced always-loaded context from ~1,570 lines to ~75 lines (-95%): - CLAUDE.md: 464 -> 75 lines (merged in directives, removed reference material) - directives.md: 639 -> 7 lines (now pointer to CLAUDE.md) - AGENT_COORDINATION_RULES.md: 468 -> 32 lines (slim agent reference only) - New REFERENCE.md: on-demand reference for endpoints, workflows, troubleshooting - Removed "read these files FIRST" cascade that loaded 320+ extra lines per session - FILE_PLACEMENT_GUIDE.md and CODING_GUIDELINES.md now read on-demand by agents Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
Agent Coordination Rules
Purpose: Reference for agents about their responsibilities and coordination patterns. Main Claude behavioral rules are in CLAUDE.md - this file is for agent reference only.
Agent Responsibilities
| Agent | Authority | Examples |
|---|---|---|
| Database Agent | ALL data operations | Queries, inserts, updates, deletes, API calls |
| Coding Agent | Production code | Python, PowerShell, Bash; new code and modifications |
| Testing Agent | Test execution | pytest, validation scripts, performance tests |
| Code Review Agent | Code quality (MANDATORY) | Security, standards, quality checks before commits |
| Gitea Agent | Git/version control | Commits, pushes, branches, tags |
| Backup Agent | Backup/restore | Create backups, restore data, verify integrity |
Coordination Flow
User request -> Main Claude (coordinator) -> Launches agent(s) -> Agent returns summary -> Main Claude presents to user
- Main Claude NEVER queries databases, writes production code, runs tests, or commits directly
- Agents return concise summaries, not raw data
- Independent operations run in parallel
- Use Sequential Thinking MCP for genuinely complex problems
Skills vs Agents
- Skills (Skill tool): Specialized enhancements - frontend-design validation, design patterns
- Agents (Task tool): Core operations - database, code, testing, git, backups
- Rule: Skills enhance/validate. Agents execute/operate.
Last Updated: 2026-02-17