cycle-complete

Cycle Complete

Complete and archive a cycle. Ensures learnings are reflected before archiving.

When to Use

• All stories in the cycle are complete
• User explicitly ends cycle early
• Cycle has been abandoned and needs archival

Flow

Step 1: Verify Cycle State

Set cycle_dir to .craft/cycles/${ACTIVE_CYCLE}.

Use Grep with pattern ^status: complete, path $cycle_dir/stories/, glob *.md, output_mode files_with_matches → count results → stories_complete.

Use Glob with pattern $cycle_dir/stories/*.md → count results → stories_total.

If stories incomplete: Use AskUserQuestion:

question: "[N] of [M] stories complete. End cycle anyway?"
header: "Cycle"
options:
  - label: "Complete cycle"
    description: "Archive incomplete stories to backlog"
  - label: "Continue working"
    description: "Finish remaining stories first"

---

Step 2: Check for Pending Learnings & Ungraduated Fixes

Use Grep with pattern status: pending, path .craft/.learnings.yaml, output_mode count → pending_count. If file doesn't exist, pending_count = 0.

Also count ungraduated fix records and the rule-pass threshold:

FIX_COUNT=$(bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/count-ungraduated-fixes.sh")
THRESHOLD=$(grep -m1 '^rule_pass_threshold:' "${CRAFT_PROJECT_ROOT:-.}/.craft/settings.yaml" 2>/dev/null | sed 's/^rule_pass_threshold:[[:space:]]*//')
THRESHOLD=${THRESHOLD:-10}

If pending_count > 0 OR FIX_COUNT >= THRESHOLD:

Name the reason(s) that apply:

"There are [N] pending learnings that haven't been converted to harness yet." "[FIX_COUNT] fixes have accumulated since the last rule pass - reflect can mine them for graduation-worthy rules."

"Reflect before archiving?"

Use AskUserQuestion:

question: "Reflect before archiving?"
header: "Reflect"
options:
  - label: "Yes, reflect now"
    description: "Run /craft:reflect (learnings drain and/or rule pass), then archive"
  - label: "Skip reflection"
    description: "Keep everything pending, just archive cycle"