~aod-kickstart

/aod.kickstart Skill

Purpose

Transform a project idea into a sequenced consumer guide with 6-10 seed features ready for the AOD lifecycle. The skill runs three stages:

1. Idea Intake -- Capture the project idea, target user, and key capabilities through structured prompts
2. Stack Selection -- Detect an active stack pack or guide the developer to select/describe a stack
3. Guide Generation -- Produce a consumer guide at docs/guides/CONSUMER_GUIDE_{PROJECT_NAME}.md with setup phases, a feature summary table, and per-feature seed blocks ordered for incremental value delivery

Each seed feature block is structured for direct copy-paste into /aod.discover.

---

Prerequisites Check

Before starting, validate the output directory exists.

1. Use Glob to check for docs/guides/ directory
2. If docs/guides/ does not exist, display the following error and stop:

ERROR: docs/guides/ directory not found.
Run `make init` to set up project structure.

Do not proceed to Stage 1 until docs/guides/ is confirmed to exist.

---

Stage 1: Idea Intake

Capture the project idea through 5 structured prompts. Store responses in variables for use in later stages.

Step 1.1: Capture Idea Description

Use AskUserQuestion:

Question: "Describe your project idea (what are you building and why?)"

Store the response as {idea_description}.

Vagueness validation (FR-014): Count the words in the response. If fewer than 20 words, ask for elaboration:

Question: "Your idea description is brief. Add more detail about what the project does, the problem it solves, or key workflows (aim for 2-3 sentences)."

Allow up to 2 rounds of clarification. If still under 20 words after 2 rounds, accept the response as-is and proceed with a note:

Note: Idea description is brief. The generated guide may need refinement.

Step 1.2: Capture Target User

Use AskUserQuestion:

Question: "Who is the target user for this project?"