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.
- checksums.yaml +4 -4
- data/ariadna.gemspec +0 -1
- data/data/agents/ariadna-codebase-mapper.md +34 -722
- data/data/agents/ariadna-debugger.md +44 -1139
- data/data/agents/ariadna-executor.md +75 -396
- data/data/agents/ariadna-planner.md +78 -1215
- data/data/agents/ariadna-roadmapper.md +55 -582
- data/data/agents/ariadna-verifier.md +60 -702
- data/data/ariadna/templates/config.json +8 -33
- data/data/ariadna/workflows/debug.md +28 -0
- data/data/ariadna/workflows/execute-phase.md +31 -513
- data/data/ariadna/workflows/map-codebase.md +20 -319
- data/data/ariadna/workflows/new-milestone.md +20 -365
- data/data/ariadna/workflows/new-project.md +19 -880
- data/data/ariadna/workflows/plan-phase.md +24 -443
- data/data/ariadna/workflows/progress.md +20 -376
- data/data/ariadna/workflows/quick.md +19 -221
- data/data/ariadna/workflows/roadmap-ops.md +28 -0
- data/data/ariadna/workflows/verify-work.md +23 -560
- data/data/commands/ariadna/add-phase.md +11 -22
- data/data/commands/ariadna/debug.md +11 -143
- data/data/commands/ariadna/execute-phase.md +12 -30
- data/data/commands/ariadna/insert-phase.md +7 -14
- data/data/commands/ariadna/map-codebase.md +16 -49
- data/data/commands/ariadna/new-milestone.md +12 -25
- data/data/commands/ariadna/new-project.md +22 -26
- data/data/commands/ariadna/plan-phase.md +13 -22
- data/data/commands/ariadna/progress.md +16 -6
- data/data/commands/ariadna/quick.md +9 -11
- data/data/commands/ariadna/remove-phase.md +9 -12
- data/data/commands/ariadna/verify-work.md +14 -19
- data/data/skills/rails-backend/API.md +138 -0
- data/data/skills/rails-backend/CONTROLLERS.md +154 -0
- data/data/skills/rails-backend/JOBS.md +132 -0
- data/data/skills/rails-backend/MODELS.md +213 -0
- data/data/skills/rails-backend/SKILL.md +169 -0
- data/data/skills/rails-frontend/ASSETS.md +154 -0
- data/data/skills/rails-frontend/COMPONENTS.md +253 -0
- data/data/skills/rails-frontend/SKILL.md +187 -0
- data/data/skills/rails-frontend/VIEWS.md +168 -0
- data/data/skills/rails-performance/PROFILING.md +106 -0
- data/data/skills/rails-performance/SKILL.md +217 -0
- data/data/skills/rails-security/AUDIT.md +118 -0
- data/data/skills/rails-security/SKILL.md +422 -0
- data/data/skills/rails-testing/FIXTURES.md +78 -0
- data/data/skills/rails-testing/SKILL.md +160 -0
- data/data/skills/rails-testing/SYSTEM-TESTS.md +73 -0
- data/lib/ariadna/installer.rb +11 -15
- data/lib/ariadna/tools/cli.rb +0 -12
- data/lib/ariadna/tools/config_manager.rb +10 -72
- data/lib/ariadna/tools/frontmatter.rb +23 -1
- data/lib/ariadna/tools/init.rb +201 -401
- data/lib/ariadna/tools/model_profiles.rb +6 -14
- data/lib/ariadna/tools/phase_manager.rb +1 -10
- data/lib/ariadna/tools/state_manager.rb +170 -451
- data/lib/ariadna/tools/template_filler.rb +4 -12
- data/lib/ariadna/tools/verification.rb +21 -399
- data/lib/ariadna/uninstaller.rb +9 -0
- data/lib/ariadna/version.rb +1 -1
- data/lib/ariadna.rb +1 -0
- metadata +20 -91
- data/data/agents/ariadna-backend-executor.md +0 -261
- data/data/agents/ariadna-frontend-executor.md +0 -259
- data/data/agents/ariadna-integration-checker.md +0 -418
- data/data/agents/ariadna-phase-researcher.md +0 -469
- data/data/agents/ariadna-plan-checker.md +0 -622
- data/data/agents/ariadna-project-researcher.md +0 -618
- data/data/agents/ariadna-research-synthesizer.md +0 -236
- data/data/agents/ariadna-test-executor.md +0 -266
- data/data/ariadna/references/checkpoints.md +0 -772
- data/data/ariadna/references/continuation-format.md +0 -249
- data/data/ariadna/references/decimal-phase-calculation.md +0 -65
- data/data/ariadna/references/git-integration.md +0 -248
- data/data/ariadna/references/git-planning-commit.md +0 -38
- data/data/ariadna/references/model-profile-resolution.md +0 -32
- data/data/ariadna/references/model-profiles.md +0 -73
- data/data/ariadna/references/phase-argument-parsing.md +0 -61
- data/data/ariadna/references/planning-config.md +0 -194
- data/data/ariadna/references/questioning.md +0 -153
- data/data/ariadna/references/rails-conventions.md +0 -416
- data/data/ariadna/references/tdd.md +0 -267
- data/data/ariadna/references/ui-brand.md +0 -160
- data/data/ariadna/references/verification-patterns.md +0 -853
- data/data/ariadna/templates/codebase/architecture.md +0 -481
- data/data/ariadna/templates/codebase/concerns.md +0 -380
- data/data/ariadna/templates/codebase/conventions.md +0 -434
- data/data/ariadna/templates/codebase/integrations.md +0 -328
- data/data/ariadna/templates/codebase/stack.md +0 -189
- data/data/ariadna/templates/codebase/structure.md +0 -418
- data/data/ariadna/templates/codebase/testing.md +0 -606
- data/data/ariadna/templates/context.md +0 -283
- data/data/ariadna/templates/continue-here.md +0 -78
- data/data/ariadna/templates/debug-subagent-prompt.md +0 -91
- data/data/ariadna/templates/phase-prompt.md +0 -609
- data/data/ariadna/templates/planner-subagent-prompt.md +0 -117
- data/data/ariadna/templates/research-project/ARCHITECTURE.md +0 -439
- data/data/ariadna/templates/research-project/FEATURES.md +0 -168
- data/data/ariadna/templates/research-project/PITFALLS.md +0 -406
- data/data/ariadna/templates/research-project/STACK.md +0 -251
- data/data/ariadna/templates/research-project/SUMMARY.md +0 -247
- data/data/ariadna/templates/state.md +0 -176
- data/data/ariadna/templates/summary-complex.md +0 -59
- data/data/ariadna/templates/summary-minimal.md +0 -41
- data/data/ariadna/templates/summary-standard.md +0 -48
- data/data/ariadna/templates/user-setup.md +0 -310
- data/data/ariadna/workflows/add-phase.md +0 -111
- data/data/ariadna/workflows/add-todo.md +0 -157
- data/data/ariadna/workflows/audit-milestone.md +0 -241
- data/data/ariadna/workflows/check-todos.md +0 -176
- data/data/ariadna/workflows/complete-milestone.md +0 -644
- data/data/ariadna/workflows/diagnose-issues.md +0 -219
- data/data/ariadna/workflows/discovery-phase.md +0 -289
- data/data/ariadna/workflows/discuss-phase.md +0 -408
- data/data/ariadna/workflows/execute-plan.md +0 -448
- data/data/ariadna/workflows/help.md +0 -470
- data/data/ariadna/workflows/insert-phase.md +0 -129
- data/data/ariadna/workflows/list-phase-assumptions.md +0 -178
- data/data/ariadna/workflows/pause-work.md +0 -122
- data/data/ariadna/workflows/plan-milestone-gaps.md +0 -256
- data/data/ariadna/workflows/remove-phase.md +0 -154
- data/data/ariadna/workflows/research-phase.md +0 -74
- data/data/ariadna/workflows/resume-project.md +0 -306
- data/data/ariadna/workflows/set-profile.md +0 -80
- data/data/ariadna/workflows/settings.md +0 -145
- data/data/ariadna/workflows/transition.md +0 -493
- data/data/ariadna/workflows/update.md +0 -212
- data/data/ariadna/workflows/verify-phase.md +0 -226
- data/data/commands/ariadna/add-todo.md +0 -42
- data/data/commands/ariadna/audit-milestone.md +0 -42
- data/data/commands/ariadna/check-todos.md +0 -41
- data/data/commands/ariadna/complete-milestone.md +0 -136
- data/data/commands/ariadna/discuss-phase.md +0 -86
- data/data/commands/ariadna/help.md +0 -22
- data/data/commands/ariadna/list-phase-assumptions.md +0 -50
- data/data/commands/ariadna/pause-work.md +0 -35
- data/data/commands/ariadna/plan-milestone-gaps.md +0 -40
- data/data/commands/ariadna/reapply-patches.md +0 -110
- data/data/commands/ariadna/research-phase.md +0 -187
- data/data/commands/ariadna/resume-work.md +0 -40
- data/data/commands/ariadna/set-profile.md +0 -34
- data/data/commands/ariadna/settings.md +0 -36
- data/data/commands/ariadna/update.md +0 -37
- data/data/guides/backend.md +0 -3069
- data/data/guides/frontend.md +0 -1479
- data/data/guides/performance.md +0 -1193
- data/data/guides/security.md +0 -1522
- data/data/guides/style-guide.md +0 -1091
- data/data/guides/testing.md +0 -504
- 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>
|