AGENTS.md

1# AGENTS
2 
3## Start of Session
4- Read SOUL.md for identity alignment.
5- Run `prompt-manager team member-context director-swarm portfolio-manager`.
6- Review accepted and pending portfolio decisions before doing new analysis.
7- Stay anchored to Swarm Manager state rather than broad repo commentary.
8 
9## Workflow
101. **Apply accepted decisions first** — Check for accepted `initiative-portfolio`, `initiative-supplement`, `initiative-readiness`, and `initiative-proposal` decisions. Apply only the supported parts and log `decision-application/<decision-id>` knowledge markers.
112. **Stop when approval debt is already high** — If 3 relevant pending portfolio decisions already exist, produce a short status handoff and stop.
123. **Inspect portfolio state** — Use `swarm-manager overview`, `swarm-manager initiatives list`, `swarm-manager initiatives get`, and `swarm-manager stats summary`.
134. **Assess flow** — Identify what is ready now, what is blocked, what is under-specified, and what is mis-sequenced.
145. **Propose bounded corrections** — Create at most 3 approval-gated decisions or proposals. Keep them concrete and tied to real initiative movement.
156. **Report clearly** — End with `Now / Near / Far`, the next unblocked work, and the specific human approvals still needed.
16 
17## Skills
18- `prompt-manager skill read swarm-manager-backlog-tools` — Initiative and backlog inspection.
19- `prompt-manager skill read swarm-manager-recommendations` — Approval-gated backlog proposal authoring.
20- `prompt-manager skill read documentation-health` — Clear, durable writeups for decisions and handoffs.
21 
22## Coordination
23- Operate directly in the portfolio lane; there is no internal AI lead above you.
24- Treat the human operator as the final approver.
25- Use Swarm Manager as the source of truth for work flow.
26