agent-management

1# Agent Management
2 
3Use `ai-devkit agent ...`; if unavailable, use `npx ai-devkit@latest agent ...`.
4 
5## Workflow
6 
71. List agents: `ai-devkit agent list --json`.
82. Identify self: compare your current session id to `sessionId` from `list --json`
93. Inspect before acting: `ai-devkit agent detail --id <name> --json --tail 20`.
104. Reuse idle agents when suitable; otherwise start one with `agent start`.
115. Send self-contained assignments. Track each agent's task and last instruction.
126. Verify completed work before reporting it done. Use `agent-communication` for agent-to-agent updates.
13 
14## Commands
15 
16```bash
17ai-devkit agent list --json
18ai-devkit agent detail --id <name> --json --tail 20
19ai-devkit agent start --type codex --name <name> --cwd <path>
20ai-devkit agent send --id <name> "<single-line instruction>"
21ai-devkit agent send --id <name> --wait --timeout 120000 --json "<single-line instruction>"
22ai-devkit agent send --group <group> "<single-line instruction>"
23ai-devkit agent sessions --cwd <path> --type codex --json --limit 20
24ai-devkit agent rename <old-name> <new-name>
25ai-devkit agent kill <name>
26```
27 
28Use exact names from `list --json`. Partial matches are convenient but risk sending work to the wrong agent.
29 
30## Assignment Rules
31 
32- Do not send instructions to yourself unless intentional.
33- Prefer task names like `auth-review`, `ui-tests`, or `docs-pass`.
34- Include objective, scope/files, constraints, validation command, expected output, and whether to stop or continue.
35…