cycle-start

Cycle Start

Activate a cycle and begin implementation.

Flow

Step 1: Select Cycle

If cycle name provided: Verify it exists in .craft/cycles/[name]/

If no cycle specified:

Scan for cycles that can be activated (planning or ready status only):

# Discover activatable cycles
Glob ".craft/cycles/*/cycle.yaml" → cycle_yaml_files

activatable_cycles = []
for each cycle_yaml in cycle_yaml_files:
  Read cycle_yaml → parse status, title
  if status == "planning" or status == "ready":
    cycle_name = directory name from path
    cycle_title = title value
    Glob ".craft/cycles/$cycle_name/stories/*.md" → count → story_count
    activatable_cycles.append(cycle_name, cycle_title, story_count, status)

Sort and recommend:

1. Extract numeric prefix from cycle directory names (e.g., 1-auth → 1, 2-dashboard → 2)
2. Sort cycles by numeric prefix (lowest first)
3. The recommended cycle is the lowest-numbered cycle that isn't complete
4. If cycles lack numeric prefixes, present them in filesystem order without recommendation

Recommendation logic:

# For each cycle, extract prefix: cycle_name | sed 's/^\([0-9]*\)-.*/\1/'
# Sort by prefix number
# First in sorted list = recommended

"Which cycle do you want to start?"

Use AskUserQuestion (options sorted by numeric prefix, recommended marked):

question: "Which cycle do you want to start?"
header: "Cycle"
options:
  - label: "[1-auth] — Auth Flow (Recommended)"
    description: "3 stories, ready — next in sequence"
  - label: "[2-dashboard] — Dashboard Foundation"
    description: "6 stories, ready"
  - label: "[3-api] — API Layer"
    description: "4 stories, [planning] — needs detailing first"

Note: For cycles with status: planning, include [planning] in the description to signal they may need detailing. Step 2b already handles the case where stories aren't ready.

Note: Show "Already active: [cycle]" in the question text if applicable.

Note: If cycles don't have numeric prefixes (legacy projects), omit the "(Recommended)" marker and present cycles in the order found.