ariadna 1.3.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. checksums.yaml +4 -4
  2. data/ariadna.gemspec +0 -1
  3. data/data/agents/ariadna-codebase-mapper.md +34 -722
  4. data/data/agents/ariadna-debugger.md +44 -1139
  5. data/data/agents/ariadna-executor.md +75 -396
  6. data/data/agents/ariadna-planner.md +78 -1215
  7. data/data/agents/ariadna-roadmapper.md +55 -582
  8. data/data/agents/ariadna-verifier.md +60 -702
  9. data/data/ariadna/templates/config.json +8 -33
  10. data/data/ariadna/workflows/debug.md +28 -0
  11. data/data/ariadna/workflows/execute-phase.md +31 -513
  12. data/data/ariadna/workflows/map-codebase.md +20 -319
  13. data/data/ariadna/workflows/new-milestone.md +20 -365
  14. data/data/ariadna/workflows/new-project.md +19 -880
  15. data/data/ariadna/workflows/plan-phase.md +24 -443
  16. data/data/ariadna/workflows/progress.md +20 -376
  17. data/data/ariadna/workflows/quick.md +19 -221
  18. data/data/ariadna/workflows/roadmap-ops.md +28 -0
  19. data/data/ariadna/workflows/verify-work.md +23 -560
  20. data/data/commands/ariadna/add-phase.md +11 -22
  21. data/data/commands/ariadna/debug.md +11 -143
  22. data/data/commands/ariadna/execute-phase.md +12 -30
  23. data/data/commands/ariadna/insert-phase.md +7 -14
  24. data/data/commands/ariadna/map-codebase.md +16 -49
  25. data/data/commands/ariadna/new-milestone.md +12 -25
  26. data/data/commands/ariadna/new-project.md +22 -26
  27. data/data/commands/ariadna/plan-phase.md +13 -22
  28. data/data/commands/ariadna/progress.md +16 -6
  29. data/data/commands/ariadna/quick.md +9 -11
  30. data/data/commands/ariadna/remove-phase.md +9 -12
  31. data/data/commands/ariadna/verify-work.md +14 -19
  32. data/data/skills/rails-backend/API.md +138 -0
  33. data/data/skills/rails-backend/CONTROLLERS.md +154 -0
  34. data/data/skills/rails-backend/JOBS.md +132 -0
  35. data/data/skills/rails-backend/MODELS.md +213 -0
  36. data/data/skills/rails-backend/SKILL.md +169 -0
  37. data/data/skills/rails-frontend/ASSETS.md +154 -0
  38. data/data/skills/rails-frontend/COMPONENTS.md +253 -0
  39. data/data/skills/rails-frontend/SKILL.md +187 -0
  40. data/data/skills/rails-frontend/VIEWS.md +168 -0
  41. data/data/skills/rails-performance/PROFILING.md +106 -0
  42. data/data/skills/rails-performance/SKILL.md +217 -0
  43. data/data/skills/rails-security/AUDIT.md +118 -0
  44. data/data/skills/rails-security/SKILL.md +422 -0
  45. data/data/skills/rails-testing/FIXTURES.md +78 -0
  46. data/data/skills/rails-testing/SKILL.md +160 -0
  47. data/data/skills/rails-testing/SYSTEM-TESTS.md +73 -0
  48. data/lib/ariadna/installer.rb +11 -15
  49. data/lib/ariadna/tools/cli.rb +0 -12
  50. data/lib/ariadna/tools/config_manager.rb +10 -72
  51. data/lib/ariadna/tools/frontmatter.rb +23 -1
  52. data/lib/ariadna/tools/init.rb +201 -401
  53. data/lib/ariadna/tools/model_profiles.rb +6 -14
  54. data/lib/ariadna/tools/phase_manager.rb +1 -10
  55. data/lib/ariadna/tools/state_manager.rb +170 -451
  56. data/lib/ariadna/tools/template_filler.rb +4 -12
  57. data/lib/ariadna/tools/verification.rb +21 -399
  58. data/lib/ariadna/uninstaller.rb +9 -0
  59. data/lib/ariadna/version.rb +1 -1
  60. data/lib/ariadna.rb +1 -0
  61. metadata +20 -91
  62. data/data/agents/ariadna-backend-executor.md +0 -261
  63. data/data/agents/ariadna-frontend-executor.md +0 -259
  64. data/data/agents/ariadna-integration-checker.md +0 -418
  65. data/data/agents/ariadna-phase-researcher.md +0 -469
  66. data/data/agents/ariadna-plan-checker.md +0 -622
  67. data/data/agents/ariadna-project-researcher.md +0 -618
  68. data/data/agents/ariadna-research-synthesizer.md +0 -236
  69. data/data/agents/ariadna-test-executor.md +0 -266
  70. data/data/ariadna/references/checkpoints.md +0 -772
  71. data/data/ariadna/references/continuation-format.md +0 -249
  72. data/data/ariadna/references/decimal-phase-calculation.md +0 -65
  73. data/data/ariadna/references/git-integration.md +0 -248
  74. data/data/ariadna/references/git-planning-commit.md +0 -38
  75. data/data/ariadna/references/model-profile-resolution.md +0 -32
  76. data/data/ariadna/references/model-profiles.md +0 -73
  77. data/data/ariadna/references/phase-argument-parsing.md +0 -61
  78. data/data/ariadna/references/planning-config.md +0 -194
  79. data/data/ariadna/references/questioning.md +0 -153
  80. data/data/ariadna/references/rails-conventions.md +0 -416
  81. data/data/ariadna/references/tdd.md +0 -267
  82. data/data/ariadna/references/ui-brand.md +0 -160
  83. data/data/ariadna/references/verification-patterns.md +0 -853
  84. data/data/ariadna/templates/codebase/architecture.md +0 -481
  85. data/data/ariadna/templates/codebase/concerns.md +0 -380
  86. data/data/ariadna/templates/codebase/conventions.md +0 -434
  87. data/data/ariadna/templates/codebase/integrations.md +0 -328
  88. data/data/ariadna/templates/codebase/stack.md +0 -189
  89. data/data/ariadna/templates/codebase/structure.md +0 -418
  90. data/data/ariadna/templates/codebase/testing.md +0 -606
  91. data/data/ariadna/templates/context.md +0 -283
  92. data/data/ariadna/templates/continue-here.md +0 -78
  93. data/data/ariadna/templates/debug-subagent-prompt.md +0 -91
  94. data/data/ariadna/templates/phase-prompt.md +0 -609
  95. data/data/ariadna/templates/planner-subagent-prompt.md +0 -117
  96. data/data/ariadna/templates/research-project/ARCHITECTURE.md +0 -439
  97. data/data/ariadna/templates/research-project/FEATURES.md +0 -168
  98. data/data/ariadna/templates/research-project/PITFALLS.md +0 -406
  99. data/data/ariadna/templates/research-project/STACK.md +0 -251
  100. data/data/ariadna/templates/research-project/SUMMARY.md +0 -247
  101. data/data/ariadna/templates/state.md +0 -176
  102. data/data/ariadna/templates/summary-complex.md +0 -59
  103. data/data/ariadna/templates/summary-minimal.md +0 -41
  104. data/data/ariadna/templates/summary-standard.md +0 -48
  105. data/data/ariadna/templates/user-setup.md +0 -310
  106. data/data/ariadna/workflows/add-phase.md +0 -111
  107. data/data/ariadna/workflows/add-todo.md +0 -157
  108. data/data/ariadna/workflows/audit-milestone.md +0 -241
  109. data/data/ariadna/workflows/check-todos.md +0 -176
  110. data/data/ariadna/workflows/complete-milestone.md +0 -644
  111. data/data/ariadna/workflows/diagnose-issues.md +0 -219
  112. data/data/ariadna/workflows/discovery-phase.md +0 -289
  113. data/data/ariadna/workflows/discuss-phase.md +0 -408
  114. data/data/ariadna/workflows/execute-plan.md +0 -448
  115. data/data/ariadna/workflows/help.md +0 -470
  116. data/data/ariadna/workflows/insert-phase.md +0 -129
  117. data/data/ariadna/workflows/list-phase-assumptions.md +0 -178
  118. data/data/ariadna/workflows/pause-work.md +0 -122
  119. data/data/ariadna/workflows/plan-milestone-gaps.md +0 -256
  120. data/data/ariadna/workflows/remove-phase.md +0 -154
  121. data/data/ariadna/workflows/research-phase.md +0 -74
  122. data/data/ariadna/workflows/resume-project.md +0 -306
  123. data/data/ariadna/workflows/set-profile.md +0 -80
  124. data/data/ariadna/workflows/settings.md +0 -145
  125. data/data/ariadna/workflows/transition.md +0 -493
  126. data/data/ariadna/workflows/update.md +0 -212
  127. data/data/ariadna/workflows/verify-phase.md +0 -226
  128. data/data/commands/ariadna/add-todo.md +0 -42
  129. data/data/commands/ariadna/audit-milestone.md +0 -42
  130. data/data/commands/ariadna/check-todos.md +0 -41
  131. data/data/commands/ariadna/complete-milestone.md +0 -136
  132. data/data/commands/ariadna/discuss-phase.md +0 -86
  133. data/data/commands/ariadna/help.md +0 -22
  134. data/data/commands/ariadna/list-phase-assumptions.md +0 -50
  135. data/data/commands/ariadna/pause-work.md +0 -35
  136. data/data/commands/ariadna/plan-milestone-gaps.md +0 -40
  137. data/data/commands/ariadna/reapply-patches.md +0 -110
  138. data/data/commands/ariadna/research-phase.md +0 -187
  139. data/data/commands/ariadna/resume-work.md +0 -40
  140. data/data/commands/ariadna/set-profile.md +0 -34
  141. data/data/commands/ariadna/settings.md +0 -36
  142. data/data/commands/ariadna/update.md +0 -37
  143. data/data/guides/backend.md +0 -3069
  144. data/data/guides/frontend.md +0 -1479
  145. data/data/guides/performance.md +0 -1193
  146. data/data/guides/security.md +0 -1522
  147. data/data/guides/style-guide.md +0 -1091
  148. data/data/guides/testing.md +0 -504
  149. data/data/templates.md +0 -94
@@ -1,226 +0,0 @@
1
- <purpose>
2
- Verify phase goal achievement through goal-backward analysis. Check that the codebase delivers what the phase promised, not just that tasks completed.
3
-
4
- Executed by a verification subagent spawned from execute-phase.md.
5
- </purpose>
6
-
7
- <core_principle>
8
- **Task completion ≠ Goal achievement**
9
-
10
- A task "create chat component" can be marked complete when the component is a placeholder. The task was done — but the goal "working chat interface" was not achieved.
11
-
12
- Goal-backward verification:
13
- 1. What must be TRUE for the goal to be achieved?
14
- 2. What must EXIST for those truths to hold?
15
- 3. What must be WIRED for those artifacts to function?
16
-
17
- Then verify each level against the actual codebase.
18
- </core_principle>
19
-
20
- <required_reading>
21
- @~/.claude/ariadna/references/verification-patterns.md
22
- @~/.claude/ariadna/templates/verification-report.md
23
- </required_reading>
24
-
25
- <process>
26
-
27
- <step name="load_context" priority="first">
28
- Load phase operation context:
29
-
30
- ```bash
31
- INIT=$(ariadna-tools init phase-op "${PHASE_ARG}")
32
- ```
33
-
34
- Extract from init JSON: `phase_dir`, `phase_number`, `phase_name`, `has_plans`, `plan_count`.
35
-
36
- Then load phase details and list plans/summaries:
37
- ```bash
38
- ariadna-tools roadmap get-phase "${phase_number}"
39
- grep -E "^| ${phase_number}" .ariadna_planning/REQUIREMENTS.md 2>/dev/null
40
- ls "$phase_dir"/*-SUMMARY.md "$phase_dir"/*-PLAN.md 2>/dev/null
41
- ```
42
-
43
- Extract **phase goal** from ROADMAP.md (the outcome to verify, not tasks) and **requirements** from REQUIREMENTS.md if it exists.
44
- </step>
45
-
46
- <step name="establish_must_haves">
47
- **Option A: Must-haves in PLAN frontmatter**
48
-
49
- Use ariadna-tools to extract must_haves from each PLAN:
50
-
51
- ```bash
52
- for plan in "$PHASE_DIR"/*-PLAN.md; do
53
- MUST_HAVES=$(ariadna-tools frontmatter get "$plan" --field must_haves)
54
- echo "=== $plan ===" && echo "$MUST_HAVES"
55
- done
56
- ```
57
-
58
- Returns JSON: `{ truths: [...], artifacts: [...], key_links: [...] }`
59
-
60
- Aggregate all must_haves across plans for phase-level verification.
61
-
62
- **Option B: Derive from phase goal**
63
-
64
- If no must_haves in frontmatter (MUST_HAVES returns error or empty):
65
- 1. State the goal from ROADMAP.md
66
- 2. Derive **truths** (3-7 observable behaviors, each testable)
67
- 3. Derive **artifacts** (concrete file paths for each truth)
68
- 4. Derive **key links** (critical wiring where stubs hide)
69
- 5. Document derived must-haves before proceeding
70
- </step>
71
-
72
- <step name="verify_truths">
73
- For each observable truth, determine if the codebase enables it.
74
-
75
- **Status:** ✓ VERIFIED (all supporting artifacts pass) | ✗ FAILED (artifact missing/stub/unwired) | ? UNCERTAIN (needs human)
76
-
77
- For each truth: identify supporting artifacts → check artifact status → check wiring → determine truth status.
78
-
79
- **Example:** Truth "User can see existing messages" depends on app/views/chats/show.html.erb (renders), ChatsController#index (provides), Message model (app/models/message.rb) (schema). If the view is a stub or controller returns hardcoded [] → FAILED. If all exist, are substantive, and connected → VERIFIED.
80
- </step>
81
-
82
- <step name="verify_artifacts">
83
- Use ariadna-tools for artifact verification against must_haves in each PLAN:
84
-
85
- ```bash
86
- for plan in "$PHASE_DIR"/*-PLAN.md; do
87
- ARTIFACT_RESULT=$(ariadna-tools verify artifacts "$plan")
88
- echo "=== $plan ===" && echo "$ARTIFACT_RESULT"
89
- done
90
- ```
91
-
92
- Parse JSON result: `{ all_passed, passed, total, artifacts: [{path, exists, issues, passed}] }`
93
-
94
- **Artifact status from result:**
95
- - `exists=false` → MISSING
96
- - `issues` not empty → STUB (check issues for "Only N lines" or "Missing pattern")
97
- - `passed=true` → VERIFIED (Levels 1-2 pass)
98
-
99
- **Level 3 — Wired (manual check for artifacts that pass Levels 1-2):**
100
- ```bash
101
- grep -r "require.*$artifact_name\|$artifact_name" app/ --include="*.rb" --include="*.erb" # REFERENCED
102
- grep -r "$artifact_name" app/ --include="*.rb" --include="*.erb" | grep -v "require" # USED
103
- ```
104
- WIRED = referenced AND used. ORPHANED = exists but not referenced/used.
105
-
106
- | Exists | Substantive | Wired | Status |
107
- |--------|-------------|-------|--------|
108
- | ✓ | ✓ | ✓ | ✓ VERIFIED |
109
- | ✓ | ✓ | ✗ | ⚠️ ORPHANED |
110
- | ✓ | ✗ | - | ✗ STUB |
111
- | ✗ | - | - | ✗ MISSING |
112
- </step>
113
-
114
- <step name="verify_wiring">
115
- Use ariadna-tools for key link verification against must_haves in each PLAN:
116
-
117
- ```bash
118
- for plan in "$PHASE_DIR"/*-PLAN.md; do
119
- LINKS_RESULT=$(ariadna-tools verify key-links "$plan")
120
- echo "=== $plan ===" && echo "$LINKS_RESULT"
121
- done
122
- ```
123
-
124
- Parse JSON result: `{ all_verified, verified, total, links: [{from, to, via, verified, detail}] }`
125
-
126
- **Link status from result:**
127
- - `verified=true` → WIRED
128
- - `verified=false` with "not found" → NOT_WIRED
129
- - `verified=false` with "Pattern not found" → PARTIAL
130
-
131
- **Fallback patterns (if key_links not in must_haves):**
132
-
133
- | Pattern | Check | Status |
134
- |---------|-------|--------|
135
- | View → Controller | Turbo Frame/link_to pointing to controller action, response rendered | WIRED / PARTIAL (route exists but action empty) / NOT_WIRED |
136
- | Controller → Database | ActiveRecord query on model, result assigned to @instance_var | WIRED / PARTIAL (query but not assigned) / NOT_WIRED |
137
- | Form → Handler | form_with/form_for submitting to controller action with real implementation, not empty method | WIRED / STUB (empty action) / NOT_WIRED |
138
- | Instance Var → Render | @instance_var appears in ERB template (`<%= @var %>` or `<%= @var.attribute %>`) | WIRED / NOT_WIRED |
139
-
140
- Record status and evidence for each key link.
141
- </step>
142
-
143
- <step name="verify_requirements">
144
- If REQUIREMENTS.md exists:
145
- ```bash
146
- grep -E "Phase ${PHASE_NUM}" .ariadna_planning/REQUIREMENTS.md 2>/dev/null
147
- ```
148
-
149
- For each requirement: parse description → identify supporting truths/artifacts → status: ✓ SATISFIED / ✗ BLOCKED / ? NEEDS HUMAN.
150
- </step>
151
-
152
- <step name="scan_antipatterns">
153
- Extract files modified in this phase from SUMMARY.md, scan each:
154
-
155
- | Pattern | Search | Severity |
156
- |---------|--------|----------|
157
- | TODO/FIXME/XXX/HACK | `grep -n -E "TODO\|FIXME\|XXX\|HACK"` | ⚠️ Warning |
158
- | Placeholder content | `grep -n -iE "placeholder\|coming soon\|will be here"` | 🛑 Blocker |
159
- | Empty returns | `grep -n -E "return null\|return \{\}\|return \[\]\|=> \{\}"` | ⚠️ Warning |
160
- | Log-only functions | Functions containing only console.log | ⚠️ Warning |
161
-
162
- Categorize: 🛑 Blocker (prevents goal) | ⚠️ Warning (incomplete) | ℹ️ Info (notable).
163
- </step>
164
-
165
- <step name="identify_human_verification">
166
- **Always needs human:** Visual appearance, user flow completion, real-time behavior (WebSocket/SSE), external service integration, performance feel, error message clarity.
167
-
168
- **Needs human if uncertain:** Complex wiring grep can't trace, dynamic state-dependent behavior, edge cases.
169
-
170
- Format each as: Test Name → What to do → Expected result → Why can't verify programmatically.
171
- </step>
172
-
173
- <step name="determine_status">
174
- **passed:** All truths VERIFIED, all artifacts pass levels 1-3, all key links WIRED, no blocker anti-patterns.
175
-
176
- **gaps_found:** Any truth FAILED, artifact MISSING/STUB, key link NOT_WIRED, or blocker found.
177
-
178
- **human_needed:** All automated checks pass but human verification items remain.
179
-
180
- **Score:** `verified_truths / total_truths`
181
- </step>
182
-
183
- <step name="generate_fix_plans">
184
- If gaps_found:
185
-
186
- 1. **Cluster related gaps:** API stub + component unwired → "Wire frontend to backend". Multiple missing → "Complete core implementation". Wiring only → "Connect existing components".
187
-
188
- 2. **Generate plan per cluster:** Objective, 2-3 tasks (files/action/verify each), re-verify step. Keep focused: single concern per plan.
189
-
190
- 3. **Order by dependency:** Fix missing → fix stubs → fix wiring → verify.
191
- </step>
192
-
193
- <step name="create_report">
194
- ```bash
195
- REPORT_PATH="$PHASE_DIR/${PHASE_NUM}-VERIFICATION.md"
196
- ```
197
-
198
- Fill template sections: frontmatter (phase/timestamp/status/score), goal achievement, artifact table, wiring table, requirements coverage, anti-patterns, human verification, gaps summary, fix plans (if gaps_found), metadata.
199
-
200
- See ~/.claude/ariadna/templates/verification-report.md for complete template.
201
- </step>
202
-
203
- <step name="return_to_orchestrator">
204
- Return status (`passed` | `gaps_found` | `human_needed`), score (N/M must-haves), report path.
205
-
206
- If gaps_found: list gaps + recommended fix plan names.
207
- If human_needed: list items requiring human testing.
208
-
209
- Orchestrator routes: `passed` → update_roadmap | `gaps_found` → create/execute fixes, re-verify | `human_needed` → present to user.
210
- </step>
211
-
212
- </process>
213
-
214
- <success_criteria>
215
- - [ ] Must-haves established (from frontmatter or derived)
216
- - [ ] All truths verified with status and evidence
217
- - [ ] All artifacts checked at all three levels
218
- - [ ] All key links verified
219
- - [ ] Requirements coverage assessed (if applicable)
220
- - [ ] Anti-patterns scanned and categorized
221
- - [ ] Human verification items identified
222
- - [ ] Overall status determined
223
- - [ ] Fix plans generated (if gaps_found)
224
- - [ ] VERIFICATION.md created with complete report
225
- - [ ] Results returned to orchestrator
226
- </success_criteria>
@@ -1,42 +0,0 @@
1
- ---
2
- name: ariadna:add-todo
3
- description: Capture idea or task as todo from current conversation context
4
- argument-hint: [optional description]
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - AskUserQuestion
10
- ---
11
-
12
- <objective>
13
- Capture an idea, task, or issue that surfaces during an Ariadna session as a structured todo for later work.
14
-
15
- Routes to the add-todo workflow which handles:
16
- - Directory structure creation
17
- - Content extraction from arguments or conversation
18
- - Area inference from file paths
19
- - Duplicate detection and resolution
20
- - Todo file creation with frontmatter
21
- - STATE.md updates
22
- - Git commits
23
- </objective>
24
-
25
- <execution_context>
26
- @.ariadna_planning/STATE.md
27
- @~/.claude/ariadna/workflows/add-todo.md
28
- </execution_context>
29
-
30
- <process>
31
- **Follow the add-todo workflow** from `@~/.claude/ariadna/workflows/add-todo.md`.
32
-
33
- The workflow handles all logic including:
34
- 1. Directory ensuring
35
- 2. Existing area checking
36
- 3. Content extraction (arguments or conversation)
37
- 4. Area inference
38
- 5. Duplicate checking
39
- 6. File creation with slug generation
40
- 7. STATE.md updates
41
- 8. Git commits
42
- </process>
@@ -1,42 +0,0 @@
1
- ---
2
- name: ariadna:audit-milestone
3
- description: Audit milestone completion against original intent before archiving
4
- argument-hint: "[version]"
5
- allowed-tools:
6
- - Read
7
- - Glob
8
- - Grep
9
- - Bash
10
- - Task
11
- - Write
12
- ---
13
- <objective>
14
- Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.
15
-
16
- **This command IS the orchestrator.** Reads existing VERIFICATION.md files (phases already verified during execute-phase), aggregates tech debt and deferred gaps, then spawns integration checker for cross-phase wiring.
17
- </objective>
18
-
19
- <execution_context>
20
- @~/.claude/ariadna/workflows/audit-milestone.md
21
- </execution_context>
22
-
23
- <context>
24
- Version: $ARGUMENTS (optional — defaults to current milestone)
25
-
26
- **Original Intent:**
27
- @.ariadna_planning/PROJECT.md
28
- @.ariadna_planning/REQUIREMENTS.md
29
-
30
- **Planned Work:**
31
- @.ariadna_planning/ROADMAP.md
32
- @.ariadna_planning/config.json (if exists)
33
-
34
- **Completed Work:**
35
- Glob: .ariadna_planning/phases/*/*-SUMMARY.md
36
- Glob: .ariadna_planning/phases/*/*-VERIFICATION.md
37
- </context>
38
-
39
- <process>
40
- Execute the audit-milestone workflow from @~/.claude/ariadna/workflows/audit-milestone.md end-to-end.
41
- Preserve all workflow gates (scope determination, verification reading, integration check, requirements coverage, routing).
42
- </process>
@@ -1,41 +0,0 @@
1
- ---
2
- name: ariadna:check-todos
3
- description: List pending todos and select one to work on
4
- argument-hint: [area filter]
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - AskUserQuestion
10
- ---
11
-
12
- <objective>
13
- List all pending todos, allow selection, load full context for the selected todo, and route to appropriate action.
14
-
15
- Routes to the check-todos workflow which handles:
16
- - Todo counting and listing with area filtering
17
- - Interactive selection with full context loading
18
- - Roadmap correlation checking
19
- - Action routing (work now, add to phase, brainstorm, create phase)
20
- - STATE.md updates and git commits
21
- </objective>
22
-
23
- <execution_context>
24
- @.ariadna_planning/STATE.md
25
- @.ariadna_planning/ROADMAP.md
26
- @~/.claude/ariadna/workflows/check-todos.md
27
- </execution_context>
28
-
29
- <process>
30
- **Follow the check-todos workflow** from `@~/.claude/ariadna/workflows/check-todos.md`.
31
-
32
- The workflow handles all logic including:
33
- 1. Todo existence checking
34
- 2. Area filtering
35
- 3. Interactive listing and selection
36
- 4. Full context loading with file summaries
37
- 5. Roadmap correlation checking
38
- 6. Action offering and execution
39
- 7. STATE.md updates
40
- 8. Git commits
41
- </process>
@@ -1,136 +0,0 @@
1
- ---
2
- type: prompt
3
- name: ariadna:complete-milestone
4
- description: Archive completed milestone and prepare for next version
5
- argument-hint: <version>
6
- allowed-tools:
7
- - Read
8
- - Write
9
- - Bash
10
- ---
11
-
12
- <objective>
13
- Mark milestone {{version}} complete, archive to milestones/, and update ROADMAP.md and REQUIREMENTS.md.
14
-
15
- Purpose: Create historical record of shipped version, archive milestone artifacts (roadmap + requirements), and prepare for next milestone.
16
- Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tagged.
17
- </objective>
18
-
19
- <execution_context>
20
- **Load these files NOW (before proceeding):**
21
-
22
- - @~/.claude/ariadna/workflows/complete-milestone.md (main workflow)
23
- - @~/.claude/ariadna/templates/milestone-archive.md (archive template)
24
- </execution_context>
25
-
26
- <context>
27
- **Project files:**
28
- - `.ariadna_planning/ROADMAP.md`
29
- - `.ariadna_planning/REQUIREMENTS.md`
30
- - `.ariadna_planning/STATE.md`
31
- - `.ariadna_planning/PROJECT.md`
32
-
33
- **User input:**
34
-
35
- - Version: {{version}} (e.g., "1.0", "1.1", "2.0")
36
- </context>
37
-
38
- <process>
39
-
40
- **Follow complete-milestone.md workflow:**
41
-
42
- 0. **Check for audit:**
43
-
44
- - Look for `.ariadna_planning/v{{version}}-MILESTONE-AUDIT.md`
45
- - If missing or stale: recommend `/ariadna:audit-milestone` first
46
- - If audit status is `gaps_found`: recommend `/ariadna:plan-milestone-gaps` first
47
- - If audit status is `passed`: proceed to step 1
48
-
49
- ```markdown
50
- ## Pre-flight Check
51
-
52
- {If no v{{version}}-MILESTONE-AUDIT.md:}
53
- ⚠ No milestone audit found. Run `/ariadna:audit-milestone` first to verify
54
- requirements coverage, cross-phase integration, and E2E flows.
55
-
56
- {If audit has gaps:}
57
- ⚠ Milestone audit found gaps. Run `/ariadna:plan-milestone-gaps` to create
58
- phases that close the gaps, or proceed anyway to accept as tech debt.
59
-
60
- {If audit passed:}
61
- ✓ Milestone audit passed. Proceeding with completion.
62
- ```
63
-
64
- 1. **Verify readiness:**
65
-
66
- - Check all phases in milestone have completed plans (SUMMARY.md exists)
67
- - Present milestone scope and stats
68
- - Wait for confirmation
69
-
70
- 2. **Gather stats:**
71
-
72
- - Count phases, plans, tasks
73
- - Calculate git range, file changes, LOC
74
- - Extract timeline from git log
75
- - Present summary, confirm
76
-
77
- 3. **Extract accomplishments:**
78
-
79
- - Read all phase SUMMARY.md files in milestone range
80
- - Extract 4-6 key accomplishments
81
- - Present for approval
82
-
83
- 4. **Archive milestone:**
84
-
85
- - Create `.ariadna_planning/milestones/v{{version}}-ROADMAP.md`
86
- - Extract full phase details from ROADMAP.md
87
- - Fill milestone-archive.md template
88
- - Update ROADMAP.md to one-line summary with link
89
-
90
- 5. **Archive requirements:**
91
-
92
- - Create `.ariadna_planning/milestones/v{{version}}-REQUIREMENTS.md`
93
- - Mark all v1 requirements as complete (checkboxes checked)
94
- - Note requirement outcomes (validated, adjusted, dropped)
95
- - Delete `.ariadna_planning/REQUIREMENTS.md` (fresh one created for next milestone)
96
-
97
- 6. **Update PROJECT.md:**
98
-
99
- - Add "Current State" section with shipped version
100
- - Add "Next Milestone Goals" section
101
- - Archive previous content in `<details>` (if v1.1+)
102
-
103
- 7. **Commit and tag:**
104
-
105
- - Stage: MILESTONES.md, PROJECT.md, ROADMAP.md, STATE.md, archive files
106
- - Commit: `chore: archive v{{version}} milestone`
107
- - Tag: `git tag -a v{{version}} -m "[milestone summary]"`
108
- - Ask about pushing tag
109
-
110
- 8. **Offer next steps:**
111
- - `/ariadna:new-milestone` — start next milestone (questioning → research → requirements → roadmap)
112
-
113
- </process>
114
-
115
- <success_criteria>
116
-
117
- - Milestone archived to `.ariadna_planning/milestones/v{{version}}-ROADMAP.md`
118
- - Requirements archived to `.ariadna_planning/milestones/v{{version}}-REQUIREMENTS.md`
119
- - `.ariadna_planning/REQUIREMENTS.md` deleted (fresh for next milestone)
120
- - ROADMAP.md collapsed to one-line entry
121
- - PROJECT.md updated with current state
122
- - Git tag v{{version}} created
123
- - Commit successful
124
- - User knows next steps (including need for fresh requirements)
125
- </success_criteria>
126
-
127
- <critical_rules>
128
-
129
- - **Load workflow first:** Read complete-milestone.md before executing
130
- - **Verify completion:** All phases must have SUMMARY.md files
131
- - **User confirmation:** Wait for approval at verification gates
132
- - **Archive before deleting:** Always create archive files before updating/deleting originals
133
- - **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
134
- - **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
135
- - **Fresh requirements:** Next milestone starts with `/ariadna:new-milestone` which includes requirements definition
136
- </critical_rules>
@@ -1,86 +0,0 @@
1
- ---
2
- name: ariadna:discuss-phase
3
- description: Gather phase context through adaptive questioning before planning
4
- argument-hint: "<phase>"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - AskUserQuestion
12
- ---
13
-
14
- <objective>
15
- Extract implementation decisions that downstream agents need — researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.
16
-
17
- **How it works:**
18
- 1. Analyze the phase to identify gray areas (UI, UX, behavior, etc.)
19
- 2. Present gray areas — user selects which to discuss
20
- 3. Deep-dive each selected area until satisfied
21
- 4. Create CONTEXT.md with decisions that guide research and planning
22
-
23
- **Output:** `{phase}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
24
- </objective>
25
-
26
- <execution_context>
27
- @~/.claude/ariadna/workflows/discuss-phase.md
28
- @~/.claude/ariadna/templates/context.md
29
- </execution_context>
30
-
31
- <context>
32
- Phase number: $ARGUMENTS (required)
33
-
34
- **Load project state:**
35
- @.ariadna_planning/STATE.md
36
-
37
- **Load roadmap:**
38
- @.ariadna_planning/ROADMAP.md
39
- </context>
40
-
41
- <process>
42
- 1. Validate phase number (error if missing or not in roadmap)
43
- 2. Check if CONTEXT.md exists (offer update/view/skip if yes)
44
- 3. **Analyze phase** — Identify domain and generate phase-specific gray areas
45
- 4. **Present gray areas** — Multi-select: which to discuss? (NO skip option)
46
- 5. **Deep-dive each area** — 4 questions per area, then offer more/next
47
- 6. **Write CONTEXT.md** — Sections match areas discussed
48
- 7. Offer next steps (research or plan)
49
-
50
- **CRITICAL: Scope guardrail**
51
- - Phase boundary from ROADMAP.md is FIXED
52
- - Discussion clarifies HOW to implement, not WHETHER to add more
53
- - If user suggests new capabilities: "That's its own phase. I'll note it for later."
54
- - Capture deferred ideas — don't lose them, don't act on them
55
-
56
- **Domain-aware gray areas:**
57
- Gray areas depend on what's being built. Analyze the phase goal:
58
- - Something users SEE → layout, density, interactions, states
59
- - Something users CALL → responses, errors, auth, versioning
60
- - Something users RUN → output format, flags, modes, error handling
61
- - Something users READ → structure, tone, depth, flow
62
- - Something being ORGANIZED → criteria, grouping, naming, exceptions
63
-
64
- Generate 3-4 **phase-specific** gray areas, not generic categories.
65
-
66
- **Probing depth:**
67
- - Ask 4 questions per area before checking
68
- - "More questions about [area], or move to next?"
69
- - If more → ask 4 more, check again
70
- - After all areas → "Ready to create context?"
71
-
72
- **Do NOT ask about (Claude handles these):**
73
- - Technical implementation
74
- - Architecture choices
75
- - Performance concerns
76
- - Scope expansion
77
- </process>
78
-
79
- <success_criteria>
80
- - Gray areas identified through intelligent analysis
81
- - User chose which areas to discuss
82
- - Each selected area explored until satisfied
83
- - Scope creep redirected to deferred ideas
84
- - CONTEXT.md captures decisions, not vague vision
85
- - User knows next steps
86
- </success_criteria>
@@ -1,22 +0,0 @@
1
- ---
2
- name: ariadna:help
3
- description: Show available Ariadna commands and usage guide
4
- ---
5
- <objective>
6
- Display the complete Ariadna command reference.
7
-
8
- Output ONLY the reference content below. Do NOT add:
9
- - Project-specific analysis
10
- - Git status or file context
11
- - Next-step suggestions
12
- - Any commentary beyond the reference
13
- </objective>
14
-
15
- <execution_context>
16
- @~/.claude/ariadna/workflows/help.md
17
- </execution_context>
18
-
19
- <process>
20
- Output the complete Ariadna command reference from @~/.claude/ariadna/workflows/help.md.
21
- Display the reference content directly — no additions or modifications.
22
- </process>
@@ -1,50 +0,0 @@
1
- ---
2
- name: ariadna:list-phase-assumptions
3
- description: Surface Claude's assumptions about a phase approach before planning
4
- argument-hint: "[phase]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Grep
9
- - Glob
10
- ---
11
-
12
- <objective>
13
- Analyze a phase and present Claude's assumptions about technical approach, implementation order, scope boundaries, risk areas, and dependencies.
14
-
15
- Purpose: Help users see what Claude thinks BEFORE planning begins - enabling course correction early when assumptions are wrong.
16
- Output: Conversational output only (no file creation) - ends with "What do you think?" prompt
17
- </objective>
18
-
19
- <execution_context>
20
- @~/.claude/ariadna/workflows/list-phase-assumptions.md
21
- </execution_context>
22
-
23
- <context>
24
- Phase number: $ARGUMENTS (required)
25
-
26
- **Load project state first:**
27
- @.ariadna_planning/STATE.md
28
-
29
- **Load roadmap:**
30
- @.ariadna_planning/ROADMAP.md
31
- </context>
32
-
33
- <process>
34
- 1. Validate phase number argument (error if missing or invalid)
35
- 2. Check if phase exists in roadmap
36
- 3. Follow list-phase-assumptions.md workflow:
37
- - Analyze roadmap description
38
- - Surface assumptions about: technical approach, implementation order, scope, risks, dependencies
39
- - Present assumptions clearly
40
- - Prompt "What do you think?"
41
- 4. Gather feedback and offer next steps
42
- </process>
43
-
44
- <success_criteria>
45
-
46
- - Phase validated against roadmap
47
- - Assumptions surfaced across five areas
48
- - User prompted for feedback
49
- - User knows next steps (discuss context, plan phase, or correct assumptions)
50
- </success_criteria>
@@ -1,35 +0,0 @@
1
- ---
2
- name: ariadna:pause-work
3
- description: Create context handoff when pausing work mid-phase
4
- allowed-tools:
5
- - Read
6
- - Write
7
- - Bash
8
- ---
9
-
10
- <objective>
11
- Create `.continue-here.md` handoff file to preserve complete work state across sessions.
12
-
13
- Routes to the pause-work workflow which handles:
14
- - Current phase detection from recent files
15
- - Complete state gathering (position, completed work, remaining work, decisions, blockers)
16
- - Handoff file creation with all context sections
17
- - Git commit as WIP
18
- - Resume instructions
19
- </objective>
20
-
21
- <execution_context>
22
- @.ariadna_planning/STATE.md
23
- @~/.claude/ariadna/workflows/pause-work.md
24
- </execution_context>
25
-
26
- <process>
27
- **Follow the pause-work workflow** from `@~/.claude/ariadna/workflows/pause-work.md`.
28
-
29
- The workflow handles all logic including:
30
- 1. Phase directory detection
31
- 2. State gathering with user clarifications
32
- 3. Handoff file writing with timestamp
33
- 4. Git commit
34
- 5. Confirmation with resume instructions
35
- </process>