← back to docs

Workflow Diagram

nexus-dev-toolkit — Day 0 scaffold + Day 1 EPAV

Day 0 — /scaffold
Run once per project
Trigger
/scaffold
Claude reads your arch doc, BRD, PRD, and Figma export. Kicks off EVALUATE automatically.
↓
Phase 1 — EVALUATE
10 Key Decisions
Stack, data model, auth pattern, folder structure, component strategy, API design, deployment target, testing approach, design system, seed data — all confirmed before any code is written.
Claude stops · you review
↓
Human Gate
type /plan to continue
Review the EVALUATE summary. Correct any wrong assumptions before the plan is written.
↓
Phase 2 — PLAN
File-by-File Blueprint
Every file listed with its purpose. Exact package versions resolved via resolve_package_versions. No code written yet.
Claude stops · you review
↓
Human Gate
type /apply to continue
Review the blueprint. Adjust scope or file structure before implementation begins.
↓
Phase 3 — APPLY
Full Scaffold Generated
Mock auth, mock data, design system, AGENTS.md, all config files. Zero external dependencies. Runs npm install && npm run dev from commit one.
Claude stops · you review
↓
Human Gate
type /validate to continue
Build passes. Review the generated scaffold before validation runs.
↓
Phase 4 — VALIDATE
19-Point Checklist
Build integrity, mock auth, design fidelity, responsive layout, WCAG AA, AGENTS.md completeness. Every [BLOCKER] fixed before Day 0 is called done.
↓
Complete
✓ Scaffold ready
Run /graphify . to build the knowledge graph. Then start Day 1.
Day 1 — EPAV
Every feature · every sprint
Trigger
/evaluate <task>
Load a task from the dev tasks CSV. Claude queries the knowledge graph to understand blast radius and cross-file dependencies.
↓
EVALUATE
Orient on the Task
Identifies affected files, applicable rules from knowledge/rules/, relevant patterns from knowledge/patterns/, and acceptance criteria. Surfaces risks before any code is touched.
↓
Command
/plan
File-by-file implementation plan. Lists what changes and why. References AGENTS.md rules that apply. No code until the plan is approved.
you review the plan
↓
Command
/apply
Implements exactly what the plan says. No scope creep. Knowledge graph auto-updates after every file edit via the PostToolUse hook.
↓
Command
/validate
Runs acceptance criteria from EVALUATE. Checks tests, linting, build. Documents new patterns in knowledge/patterns/ for future tasks.
↓
Complete
✓ Feature shipped
Acceptance criteria verified. Knowledge graph updated. Patterns documented. Ready for the next task.
↺ repeat for every task
Slash command you trigger
Claude executes this phase
Human review gate
Outcome