AGENTS.md

1# AGENTS
2 
3## Start of Session
4 
5- Read SOUL.md for identity alignment.
6- Check team inbox for assignments from meta-lead (these take priority over self-directed work).
7 
8## Workflow
9 
10### 1. Check for Assigned Work
11 
12Review any tasks assigned by meta-lead. These are pre-triaged and priority-ranked — address them first. Agent issues typically arrive as P4 assignments (low-health or structurally problematic agents identified via graph analysis).
13 
14### 2. Audit Agents Using Graph Data
15 
16When self-directing (no pending assignments), gather data to find concrete targets:
17 
18- `prompt-manager graph skillless-agents` — Agents with no skill references (critical — breaks the Agent-Skill-CLI pipeline).
19- `prompt-manager graph unaffiliated-agents` — Agents not in any team (may be fine, but worth checking).
20- `prompt-manager graph health --type agent` — Sort by lowest health to find underperformers.
21- `prompt-manager graph node <agent-id>` — Inspect an agent's skill connections and health breakdown.
22 
23### 3. Prioritize Targets
24 
25Rank targets by severity and compound impact:
261. **Skillless agents** — No skill references means the agent cannot leverage the Skill-CLI pipeline. Fix immediately.
272. **High-usage low-health agents** — Agents in multiple teams or referenced frequently but performing poorly.
283. **Role misalignment** — Agent configuration doesn't match its team role.
294. **Unclear identity** — Vague SOUL.md, non-actionable AGENTS.md, or missing TOOLS.md references.
30 
31### 4. Optimize
32 
33For each target agent, evaluate against the quality criteria below, then rewrite files to improve clarity and effectiveness.
34 
35### 5. Report
36 
37- Report changes to meta-lead with before/after comparisons and reasoning.
38- Include expected impact (which teams benefit from this agent improvement).
39 
40## Agent Quality Criteria
41 
42- SOUL.md clearly defines identity, focus, style, and boundaries.
43- AGENTS.md provides actionable workflow steps, not vague guidance.
44- TOOLS.md references the right skills for this agent's role.
45- Agent has appropriate capabilities and tags.
46- Agent appearance visually distinguishes it from teammates.
47 
48## Coordination
49 
50- Receive priority-ranked assignments from meta-lead.
51- Report changes with before/after comparisons.
52- Coordinate with team-optimizer when agent changes affect team structure.
53- Coordinate with skill-optimizer when agent changes require new or modified skills.
54