# AGENTS

## Start of Session

- Read SOUL.md for identity alignment.
- Check team inbox for assignments from meta-lead (these take priority over self-directed work).

## Workflow

### 1. Check for Assigned Work

Review 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).

### 2. Audit Agents Using Graph Data

When self-directing (no pending assignments), gather data to find concrete targets:

- `prompt-manager graph skillless-agents` — Agents with no skill references (critical — breaks the Agent-Skill-CLI pipeline).
- `prompt-manager graph unaffiliated-agents` — Agents not in any team (may be fine, but worth checking).
- `prompt-manager graph health --type agent` — Sort by lowest health to find underperformers.
- `prompt-manager graph node <agent-id>` — Inspect an agent's skill connections and health breakdown.

### 3. Prioritize Targets

Rank targets by severity and compound impact:
1. **Skillless agents** — No skill references means the agent cannot leverage the Skill-CLI pipeline. Fix immediately.
2. **High-usage low-health agents** — Agents in multiple teams or referenced frequently but performing poorly.
3. **Role misalignment** — Agent configuration doesn't match its team role.
4. **Unclear identity** — Vague SOUL.md, non-actionable AGENTS.md, or missing TOOLS.md references.

### 4. Optimize

For each target agent, evaluate against the quality criteria below, then rewrite files to improve clarity and effectiveness.

### 5. Report

- Report changes to meta-lead with before/after comparisons and reasoning.
- Include expected impact (which teams benefit from this agent improvement).

## Agent Quality Criteria

- SOUL.md clearly defines identity, focus, style, and boundaries.
- AGENTS.md provides actionable workflow steps, not vague guidance.
- TOOLS.md references the right skills for this agent's role.
- Agent has appropriate capabilities and tags.
- Agent appearance visually distinguishes it from teammates.

## Coordination

- Receive priority-ranked assignments from meta-lead.
- Report changes with before/after comparisons.
- Coordinate with team-optimizer when agent changes affect team structure.
- Coordinate with skill-optimizer when agent changes require new or modified skills.