| 1 | # Orchestration Log Entry |
| 2 | |
| 3 | > One file per agent spawn. Saved to `.squad/orchestration-log/{timestamp}-{agent-name}.md` |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ### {timestamp} — {task summary} |
| 8 | |
| 9 | | Field | Value | |
| 10 | |-------|-------| |
| 11 | | **Agent routed** | {Name} ({Role}) | |
| 12 | | **Why chosen** | {Routing rationale — what in the request matched this agent} | |
| 13 | | **Mode** | {`background` / `sync`} | |
| 14 | | **Why this mode** | {Brief reason — e.g., "No hard data dependencies" or "User needs to approve architecture"} | |
| 15 | | **Files authorized to read** | {Exact file paths the agent was told to read} | |
| 16 | | **File(s) agent must produce** | {Exact file paths the agent is expected to create or modify} | |
| 17 | | **Outcome** | {Completed / Rejected by {Reviewer} / Escalated} | |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Rules |
| 22 | |
| 23 | 1. **One file per agent spawn.** Named `{timestamp}-{agent-name}.md`. |
| 24 | 2. **Log BEFORE spawning.** The entry must exist before the agent runs. |
| 25 | 3. **Update outcome AFTER the agent completes.** Fill in the Outcome field. |
| 26 | 4. **Never delete or edit past entries.** Append-only. |
| 27 | 5. **If a reviewer rejects work,** log the rejection as a new entry with the revision agent. |