Use when starting a new agentic project that needs phased planning, task tracking, and multi-session execution. Triggers on "start a new project", "plan this project", "create project structure", or any request to set up a structured multi-phase development workflow tracked in git.
Sets up a persistent, git-tracked project workspace under .tasks/ — a high-level plan split into phases, each phase into trackable task files. Designed for hand-off across multiple agent sessions.
brief.md describing the projectdigraph orchestrate {
"brief.md exists?" [shape=diamond];
"Run interview" [shape=box];
"Read brief.md" [shape=box];
"Ask: public or private repo?" [shape=diamond];
"gh repo create + push" [shape=box];
"Create .tasks/ structure" [shape=box];
"Generate phase-1 tasks" [shape=box];
"Create phase 2+ stubs" [shape=box];
"Commit + push" [shape=box];
"Instruct human" [shape=doublecircle];
"brief.md exists?" -> "Read brief.md" [label="yes"];
"brief.md exists?" -> "Run interview" [label="no"];
"Read brief.md" -> "Ask: public or private repo?";
"Run interview" -> "Ask: public or private repo?";
"Ask: public or private repo?" -> "gh repo create + push";
"gh repo create + push" -> "Create .tasks/ structure";
"Create .tasks/ structure" -> "Generate phase-1 tasks";
"Generate phase-1 tasks" -> "Create phase 2+ stubs";
"Create phase 2+ stubs" -> "Commit + push";
"Commit + push" -> "Instruct human";
}
Check for brief.md in the project root. If found, read it. If not, interview the user:
Check brief.md for a repo: field (public or private). If missing, ask the user.
brief.md supported fields: