Project Define
Use this skill only when explicitly invoked as $project-define. It owns Gates
0, WB, and 1, producing the codebase assessment, optional Working Backwards
artifact, and PRD in one continuous session.
Core Rules
- Read
progress.txtfresh from disk before acting. - Require a bootstrapped project. If
progress.txtis missing, tell the user to run$projectfirst. - Produce each gate artifact, present it for review, and record approval only
after all checklist items are
[x]or[-]with a reason. - Ask concise chat questions for user choices; use structured input tools when available.
- Use Codex filesystem editing tools for artifacts and
progress.txt. - Use Codex sub-agents only when available and appropriate; otherwise perform the scan locally.
- Do not invoke the next skill automatically. Recommend the next explicit skill.
- Read the referenced workflow files before executing their corresponding steps; they contain required edge-case handling, review criteria, and artifact formats.
Workflow
- Detect mode from
progress.txt,prd.md, and the user request. Revision mode applies when Gate 1 is approved and the user asks to revise/update the PRD. - For brownfield projects, read
references/gate-0-codebase.mdand producedocs/codebase-assessment.md. For greenfield projects, record Gate 0 as skipped using the compatible notation. - Read
references/gate-wb-working-backwards.mdand offer Working Backwards. Gate WB can be approved, skipped, or deferred; a deferred state allows Gate 1 interview and drafting work to proceed, but Gate 1 cannot be approved or completed until Gate WB is resolved as[x]or[-]. - Read
references/gate-1-prd.mdand create or reviseprd.mdusingassets/prd-template.md. - Create/update review files under
docs/reviews/usingreferences/review-checklist-template.md. - Update
progress.txtusingreferences/progress-format.md.
Reference Files
references/gate-0-codebase.mdreferences/gate-wb-working-backwards.mdreferences/gate-1-prd.mdreferences/progress-format.mdreferences/review-checklist-template.mdassets/prd-template.md
Completion
Report created/updated artifacts and recommend $project for status, then
$project-design when Gate 1 is approved.