~aod-blueprint

/aod.blueprint Skill

Purpose

Unified project setup and story generation in a single command. The skill auto-detects whether the current project is new or existing, then runs the appropriate workflow:

1. First-Run -- Creates GitHub repo, registers project with orchestrator API, activates it, runs interactive intake, generates stories, creates issues
2. Subsequent-Run -- Skips setup, runs interactive intake, generates new stories with deduplication against existing issues
3. Demo Mode (--demo) -- Loads pre-built Hello World stories from HELLO_WORLD_STORIES.md, skips interactive intake entirely

All modes end with issue creation, lifecycle sync, consumer guide generation, and a completion report.

---

Step 0: Prerequisites Check

Validate that required tools and services are available before proceeding.

0.1: Check gh CLI

Run gh --version via Bash tool.

• If the command succeeds, continue to Step 0.2.
• If the command fails, display the following error and STOP:

ERROR: GitHub CLI (gh) is not installed or not in PATH.
Install it from https://cli.github.com/ and run `gh auth login` to authenticate.

0.2: Check API Health

Run the following command via Bash tool:

curl -sf ${AOD_API_URL:-http://localhost:8000}/health -H "X-AOD-Source: skill"

• If the command succeeds (exit code 0), display "Prerequisites OK" and continue to Step 1.
• If the command fails, display the following error and STOP:

ERROR: AOD Orchestrator API is not reachable at ${AOD_API_URL:-http://localhost:8000}.
Start the API with `make run` and try again.

---

Step 1: Auto-Detection

Determine the project name, check for an existing project in the orchestrator, and set the execution mode.

1.1: Derive Project Name

Run git remote get-url origin via Bash tool.

• If the command succeeds, extract the repo name from the URL: take the last path segment and strip any .git suffix. For example, https://github.com/org/my-project.git yields my-project. Store as {project_name}.
• If the command fails (no remote configured), run basename $(pwd) via Bash tool and store the result as {project_name}.