Skills

aid-create-mvp

Frontmatter

name — aid-create-mvp
description — Realize a ready MVP seed into roadmap.md’s ## MVP section only — the first shippable slice: what it includes, why the line falls there, what was cut, and its current status. Use this skill when an MVP seed is ready and the roadmap’s MVP section has not been written yet. The roadmap document itself is /aid-create-roadmap’s to create; when roadmap.md is absent this skill routes to /aid-create-roadmap without writing anything and leaves the seed in place. Routes to /aid-update-mvp when ## MVP already carries committed content. Writes no document and no registration entry — it owns a section, not a file.
allowed-tools — Read, Glob, Grep, Bash, Write, Edit, Agent
argument-hint — [<slice>] — what to realize into the ## MVP section (fills the section from the seed)

Definition: canonical/skills/aid-create-mvp/SKILL.md

Flow

flowchart TB
  classDef aidNode color:#fff
  classDef aidEntry fill:#166534,stroke:#14532d,color:#fff
  classDef aidExit fill:#991b1b,stroke:#7f1d1d,color:#fff
  classDef aidDecision fill:#92400e,stroke:#78350f,color:#fff
  classDef aidLoopBack fill:#1e3a8a,stroke:#1e3a8a,color:#fff
  classDef aidStep fill:#1a2035,stroke:#d4a853,color:#f1f5f9
  n1(["INTAKE"])
  n2["GUARD"]
  n3{"REALIZE"}
  n4["VERIFY"]
  n5["PRESENT<br/>hard stop -- the user decides"]
  n6(["DONE"])
  n1 --> n2
  n2 --> n3
  n3 -->|"creation path"| n4
  n3 -->|"Route path: advance to directly"| n6
  n4 -.-> n3
  n4 --> n5
  n5 --> n6
  class n1 aidEntry
  class n2 aidStep
  class n3 aidDecision
  class n4 aidLoopBack
  class n5 aidStep
  class n6 aidExit
  class n1 aidNode
  class n2 aidNode
  class n3 aidNode
  class n4 aidNode
  class n5 aidNode
  class n6 aidNode

Source fragments

Every node in the chart above, in chart order, with the exact canonical/ text it was derived from.

1 · INTAKE · entry

## State: INTAKE

1. **Require a subject.** Empty argument -> ask one bootstrapping question ("What
   belongs in the first shippable slice, and where does the line fall -- or run
   `/aid-design-mvp` first?") and wait.
2. **Allocate, exactly per `design-lifecycle.md § Skill shape -- Allocation`** -- the
   Work Initiation Gate, then `initiator: aid-create-mvp`, `active_skill:
   aid-create-mvp`, `pipeline.path: lite`, `lifecycle: Running`. `phase` is not
   driven.
3. **Read the seed** at `.aid/design/mvp.md`. If no seed exists, inform the user and
   ask whether to proceed without one (slice entered interactively) or to run
   `/aid-design-mvp` first; do not proceed silently.
4. **Read the destination** at `.aid/knowledge/roadmap.md` if it exists. Classify its
   state: absent | present-MVP-absent | present-MVP-populated.
5. **Classify complexity (model + effort)** for the `aid-architect` dispatch below;
   verifier tier >= producer tier (`agent-dispatch-tiering.md`).

Source: canonical/skills/aid-create-mvp/SKILL.md#L43-L58 · full step: canonical/skills/aid-create-mvp/SKILL.md#L43-L60

2 · GUARD · step

## State: GUARD

**Readiness gate (class-1 contract, feature-002 §3b).** Inspect the seed for a
non-empty `## Open questions` section per `design-lifecycle.md`'s detection rule.

Source: canonical/skills/aid-create-mvp/SKILL.md#L64-L67 · full step: canonical/skills/aid-create-mvp/SKILL.md#L64-L75

3 · REALIZE · decision

## State: REALIZE

Dispatch **`aid-architect`** (clean context, tiered) to realize the seed. Apply the
case determined in INTAKE:

Source: canonical/skills/aid-create-mvp/SKILL.md#L79-L82 · full step: canonical/skills/aid-create-mvp/SKILL.md#L79-L118

4 · VERIFY · loop-back

## State: VERIFY

**Full verify** -- exactly as `design-lifecycle.md § Skill shape -- "Full verify"`
defines it. Not clean -> loop to REALIZE; the circuit-breaker there governs escalation
to IMPEDIMENT + `lifecycle: Blocked`.

Source: canonical/skills/aid-create-mvp/SKILL.md#L122-L126 · full step: canonical/skills/aid-create-mvp/SKILL.md#L122-L128

5 · PRESENT — hard stop — the user decides · step

## State: PRESENT (hard stop -- the user decides)

Set `lifecycle: Paused-Awaiting-Input`. Present the realized `## MVP` section clearly.
Assert:

Source: canonical/skills/aid-create-mvp/SKILL.md#L132-L135 · full step: canonical/skills/aid-create-mvp/SKILL.md#L132-L145

6 · DONE · exit · UNSPECIFIED

## State: DONE

Set `lifecycle: Completed`, `updated` now, append a `## Lifecycle History` row.

Source: canonical/skills/aid-create-mvp/SKILL.md#L149-L151 · full step: canonical/skills/aid-create-mvp/SKILL.md#L149-L151

Report an issue with this page →