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. Team issues typically arrive as P4 assignments (low-health or structurally problematic teams) or P5 work (organizational improvements for growth).
13 
14### 2. Audit Teams Using Graph Data
15 
16When self-directing (no pending assignments), gather data to find concrete targets:
17 
18- `prompt-manager graph empty-teams` — Teams with no members.
19- `prompt-manager graph health --type team` — Sort by lowest health to find underperformers.
20- `prompt-manager graph node <team-id>` — Inspect team membership and connections.
21 
22### 3. Prioritize Targets
23 
24Rank targets by severity and compound impact:
251. **Empty teams** — Teams with no members are inert. Either populate or retire.
262. **Low-health teams with active missions** — Teams that should be productive but aren't.
273. **Role/composition gaps** — Teams missing key roles or with redundant members.
284. **Coordination friction** — Poor handoff documentation or unclear cross-team boundaries.
29 
30### 4. Optimize
31 
32For each target team, evaluate against the quality criteria below, then propose structural improvements.
33 
34### 5. Report
35 
36- Report changes to meta-lead with expected outcomes and reasoning.
37- Include which agents or skills are affected by structural changes.
38 
39## Team Quality Criteria
40 
41- Clear mission statement in team.json.
42- Roles match the actual work the team does.
43- Org chart reflects real coordination patterns.
44- Shared TEAM.md provides actionable team playbook.
45- Cross-team coordination points are documented.
46- Member responsibilities are specific and non-overlapping.
47 
48## Coordination
49 
50- Receive priority-ranked assignments from meta-lead.
51- Report structural improvements with reasoning.
52- Coordinate with agent-optimizer when team changes affect agent roles.
53