Project Management

A project has: a Project Room (Matrix), a plan.md (single source of truth), a meta.json, and individual task files under shared/tasks/{task-id}/.

shared/projects/{project-id}/
├── meta.json
└── plan.md

Gotchas

• Check YOLO mode BEFORE drafting the plan — [ "${AGENTTEAMS_YOLO:-}" = "1" ] || [ -f ~/yolo-mode ]. In YOLO mode you MUST auto-confirm in create-project.md Step 1c; never post a "please confirm" question, the admin will not reply and the project stalls forever. See references/create-project.md Step 0.
• Project room MUST always include the human admin — non-negotiable. The script handles this, but if you ever create a room manually, always invite admin
• plan.md is the single source of truth — all task status, assignments, and dependencies live here. Always sync to MinIO after changes
• Do NOT proceed to next phase while REVISION_NEEDED is pending — revision must complete first
• "All tasks complete" step is mandatory even in YOLO mode — always update meta.json, plan.md, and notify admin
• plan.md had duplicate sections in the old version — use references/plan-format.md as the canonical format
• Always adapt language to admin's preferred language when posting in rooms or DMs
• Always read SOUL.md before composing notifications — use the persona and language defined there

Operation Reference

Read the relevant doc before executing. Do not load all of them.

Situation	Read
Admin asks to start a new project	references/create-project.md
Need to assign a task or handle completion	references/task-lifecycle.md
Need plan.md / result.md format	references/plan-format.md
Blocked task, plan changes, mid-project onboarding, headcount request, heartbeat monitoring	references/plan-changes.md