Direction loop — defines WHY, WHAT, and strategic foundations. Dispatches producer skills and reviews coherence. Can be invoked standalone or by shipkit-master.
Purpose: Orchestrate the production and review of strategic artifacts until direction is coherent and stable.
If invoked directly (no orchestration.json exists or activeLoop is not set by master):
.shipkit/ directory exists — if not, tell the user to run /shipkit-why-project firstorchestration.json yourself with activeLoop: "direction"Strategic artifacts that define WHY, WHAT, and HOW at definition level:
.shipkit/why.json — Project vision and purpose.shipkit/product-discovery.json — Personas and user journeys.shipkit/product-definition.json — Features, patterns, differentiators.shipkit/engineering-definition.json — Mechanisms, components, stack.shipkit/architecture.json — Architecture decisions (derived from engineering-definition).shipkit/design-system/ — Design principles, tokens, aesthetic direction (UI projects only).shipkit/goals/product.json — Product success criteria.shipkit/goals/engineering.json — Engineering success criteria| Skill | What It Produces |
|---|---|
/shipkit-why-project | why.json |
/shipkit-stage | goals/strategic.json |
/shipkit-product-discovery | product-discovery.json |
/shipkit-product-definition | product-definition.json |
/shipkit-engineering-definition | engineering-definition.json + architecture.json |
/shipkit-design-system | .shipkit/design-system/ (DIRECTION.md, PRINCIPLES.md, MATURITY.md, tokens/) — UI projects only |
/shipkit-product-goals | goals/product.json |
/shipkit-engineering-goals | goals/engineering.json |
/shipkit-review-direction | reviews/direction-assessment.json |
All direction artifacts exist AND .shipkit/reviews/direction-assessment.json has status: "pass".
After each skill dispatch and after each review cycle, update .shipkit/orchestration.json:
{
"activeLoop": "direction",
"status": "in_progress",
"loops": {
"direction": {
"status": "in_progress",
"currentSkill": "shipkit-why-project",
"completedDispatches": [
{ "skill": "shipkit-why-project", "timestamp": "ISO" }
],
"reviewCycles": 0
}
}
}
Set status to "pass" or "partial" when the loop finishes. Increment reviewCycles each time /shipkit-review-direction runs.
Before dispatching any skills, create tasks for every dispatch in the roster:
TaskCreate for each producer dispatch:
TaskCreate: "Review: /shipkit-review-direction"TaskCreate: "Re-dispatch for gaps (if needed)"TaskCreate: "Re-review after fixes (if needed)"Rules:
TaskUpdate each task to completed only after the dispatched skill finishes AND you update orchestration.jsoncompleted, AND (b) direction-assessment.json reports status: "pass"in_progress, dispatch fixes, then re-review/shipkit-why-project — establishes foundation (vision lives inside why.json)/shipkit-stage — sets stage, constraints, business gates/shipkit-product-discovery — informs product definition/shipkit-product-definition — informs engineering definition/shipkit-engineering-definition — informs goals and design system/shipkit-design-system — scaffolds design direction + tokens (UI projects only; skip for CLI/API)/shipkit-product-goals — defines product success/shipkit-engineering-goals — defines technical success/shipkit-review-direction — assesses coherence