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>
39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# 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
|