ariadna 1.2.0 → 1.2.2
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/data/agents/ariadna-backend-executor.md +9 -6
- data/data/agents/ariadna-codebase-mapper.md +5 -5
- data/data/agents/ariadna-debugger.md +13 -13
- data/data/agents/ariadna-executor.md +9 -6
- data/data/agents/ariadna-frontend-executor.md +9 -6
- data/data/agents/ariadna-integration-checker.md +1 -1
- data/data/agents/ariadna-phase-researcher.md +1 -1
- data/data/agents/ariadna-planner.md +17 -17
- data/data/agents/ariadna-project-researcher.md +10 -10
- data/data/agents/ariadna-research-synthesizer.md +11 -11
- data/data/agents/ariadna-roadmapper.md +8 -8
- data/data/agents/ariadna-test-executor.md +9 -6
- data/data/agents/ariadna-verifier.md +4 -4
- data/data/ariadna/references/decimal-phase-calculation.md +2 -2
- data/data/ariadna/references/git-integration.md +4 -4
- data/data/ariadna/references/git-planning-commit.md +7 -7
- data/data/ariadna/references/model-profile-resolution.md +1 -1
- data/data/ariadna/references/model-profiles.md +2 -2
- data/data/ariadna/references/planning-config.md +13 -13
- data/data/ariadna/references/rails-conventions.md +9 -2
- data/data/ariadna/references/tdd.md +2 -2
- data/data/ariadna/templates/DEBUG.md +2 -2
- data/data/ariadna/templates/UAT.md +3 -3
- data/data/ariadna/templates/codebase/architecture.md +1 -1
- data/data/ariadna/templates/codebase/concerns.md +1 -1
- data/data/ariadna/templates/codebase/conventions.md +1 -1
- data/data/ariadna/templates/codebase/integrations.md +1 -1
- data/data/ariadna/templates/codebase/stack.md +1 -1
- data/data/ariadna/templates/codebase/structure.md +1 -1
- data/data/ariadna/templates/codebase/testing.md +1 -1
- data/data/ariadna/templates/context.md +2 -2
- data/data/ariadna/templates/continue-here.md +1 -1
- data/data/ariadna/templates/debug-subagent-prompt.md +2 -2
- data/data/ariadna/templates/discovery.md +2 -2
- data/data/ariadna/templates/milestone-archive.md +4 -4
- data/data/ariadna/templates/milestone.md +1 -1
- data/data/ariadna/templates/phase-prompt.md +19 -19
- data/data/ariadna/templates/planner-subagent-prompt.md +9 -9
- data/data/ariadna/templates/project.md +2 -2
- data/data/ariadna/templates/requirements.md +1 -1
- data/data/ariadna/templates/research-project/ARCHITECTURE.md +1 -1
- data/data/ariadna/templates/research-project/FEATURES.md +1 -1
- data/data/ariadna/templates/research-project/PITFALLS.md +1 -1
- data/data/ariadna/templates/research-project/STACK.md +1 -1
- data/data/ariadna/templates/research-project/SUMMARY.md +1 -1
- data/data/ariadna/templates/research.md +2 -2
- data/data/ariadna/templates/roadmap.md +1 -1
- data/data/ariadna/templates/state.md +4 -4
- data/data/ariadna/templates/summary.md +12 -1
- data/data/ariadna/templates/user-setup.md +2 -2
- data/data/ariadna/templates/verification-report.md +1 -1
- data/data/ariadna/workflows/add-phase.md +5 -5
- data/data/ariadna/workflows/add-todo.md +7 -7
- data/data/ariadna/workflows/audit-milestone.md +7 -7
- data/data/ariadna/workflows/check-todos.md +4 -4
- data/data/ariadna/workflows/complete-milestone.md +18 -18
- data/data/ariadna/workflows/diagnose-issues.md +4 -4
- data/data/ariadna/workflows/discovery-phase.md +4 -4
- data/data/ariadna/workflows/discuss-phase.md +2 -2
- data/data/ariadna/workflows/execute-phase.md +97 -9
- data/data/ariadna/workflows/execute-plan.md +30 -19
- data/data/ariadna/workflows/help.md +18 -18
- data/data/ariadna/workflows/insert-phase.md +6 -6
- data/data/ariadna/workflows/list-phase-assumptions.md +1 -1
- data/data/ariadna/workflows/map-codebase.md +22 -22
- data/data/ariadna/workflows/new-milestone.md +16 -16
- data/data/ariadna/workflows/new-project.md +39 -39
- data/data/ariadna/workflows/pause-work.md +4 -4
- data/data/ariadna/workflows/plan-milestone-gaps.md +4 -4
- data/data/ariadna/workflows/plan-phase.md +43 -19
- data/data/ariadna/workflows/progress.md +6 -6
- data/data/ariadna/workflows/quick.md +6 -6
- data/data/ariadna/workflows/remove-phase.md +3 -3
- data/data/ariadna/workflows/research-phase.md +4 -4
- data/data/ariadna/workflows/resume-project.md +9 -9
- data/data/ariadna/workflows/set-profile.md +2 -2
- data/data/ariadna/workflows/settings.md +4 -4
- data/data/ariadna/workflows/transition.md +11 -11
- data/data/ariadna/workflows/verify-phase.md +2 -2
- data/data/ariadna/workflows/verify-work.md +8 -8
- data/data/commands/ariadna/add-phase.md +2 -2
- data/data/commands/ariadna/add-todo.md +1 -1
- data/data/commands/ariadna/audit-milestone.md +6 -6
- data/data/commands/ariadna/check-todos.md +2 -2
- data/data/commands/ariadna/complete-milestone.md +11 -11
- data/data/commands/ariadna/debug.md +3 -3
- data/data/commands/ariadna/discuss-phase.md +2 -2
- data/data/commands/ariadna/execute-phase.md +6 -5
- data/data/commands/ariadna/insert-phase.md +2 -2
- data/data/commands/ariadna/list-phase-assumptions.md +2 -2
- data/data/commands/ariadna/map-codebase.md +7 -7
- data/data/commands/ariadna/new-milestone.md +10 -10
- data/data/commands/ariadna/new-project.md +6 -6
- data/data/commands/ariadna/pause-work.md +1 -1
- data/data/commands/ariadna/plan-milestone-gaps.md +5 -5
- data/data/commands/ariadna/quick.md +2 -2
- data/data/commands/ariadna/remove-phase.md +2 -2
- data/data/commands/ariadna/research-phase.md +6 -6
- data/data/commands/ariadna/verify-work.md +2 -2
- data/data/guides/frontend.md +1044 -9
- data/data/statusline/ariadna-statusline.sh +47 -0
- data/data/templates.md +1 -1
- data/exe/ariadna +2 -1
- data/lib/ariadna/installer.rb +30 -1
- data/lib/ariadna/tools/config_manager.rb +12 -6
- data/lib/ariadna/tools/git_integration.rb +2 -2
- data/lib/ariadna/tools/init.rb +66 -61
- data/lib/ariadna/tools/phase_manager.rb +31 -13
- data/lib/ariadna/tools/roadmap_analyzer.rb +5 -5
- data/lib/ariadna/tools/state_manager.rb +14 -14
- data/lib/ariadna/tools/template_filler.rb +5 -5
- data/lib/ariadna/tools/utilities.rb +4 -4
- data/lib/ariadna/tools/verification.rb +4 -4
- data/lib/ariadna/uninstaller.rb +17 -0
- data/lib/ariadna/version.rb +1 -1
- metadata +2 -1
|
@@ -26,7 +26,7 @@ If `found` is false: Error and exit.
|
|
|
26
26
|
## Step 2: Check Existing Research
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
|
-
ls .
|
|
29
|
+
ls .ariadna_planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
If exists: Offer update/view/skip options.
|
|
@@ -36,8 +36,8 @@ If exists: Offer update/view/skip options.
|
|
|
36
36
|
```bash
|
|
37
37
|
# Phase section from roadmap (already loaded in PHASE_INFO)
|
|
38
38
|
echo "$PHASE_INFO" | jq -r '.section'
|
|
39
|
-
cat .
|
|
40
|
-
cat .
|
|
39
|
+
cat .ariadna_planning/REQUIREMENTS.md 2>/dev/null
|
|
40
|
+
cat .ariadna_planning/phases/${PHASE}-*/*-CONTEXT.md 2>/dev/null
|
|
41
41
|
# Decisions from state-snapshot (structured JSON)
|
|
42
42
|
ariadna-tools state-snapshot | jq '.decisions'
|
|
43
43
|
```
|
|
@@ -58,7 +58,7 @@ Phase context: {context_md}
|
|
|
58
58
|
</context>
|
|
59
59
|
|
|
60
60
|
<output>
|
|
61
|
-
Write to: .
|
|
61
|
+
Write to: .ariadna_planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
|
|
62
62
|
</output>",
|
|
63
63
|
subagent_type="ariadna-phase-researcher",
|
|
64
64
|
model="{researcher_model}"
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
Use this workflow when:
|
|
3
3
|
- Starting a new session on an existing project
|
|
4
4
|
- User says "continue", "what's next", "where were we", "resume"
|
|
5
|
-
- Any planning operation when .
|
|
5
|
+
- Any planning operation when .ariadna_planning/ already exists
|
|
6
6
|
- User returns after time away from project
|
|
7
7
|
</trigger>
|
|
8
8
|
|
|
@@ -35,8 +35,8 @@ Parse JSON for: `state_exists`, `roadmap_exists`, `project_exists`, `planning_ex
|
|
|
35
35
|
Read and parse STATE.md, then PROJECT.md:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
cat .
|
|
39
|
-
cat .
|
|
38
|
+
cat .ariadna_planning/STATE.md
|
|
39
|
+
cat .ariadna_planning/PROJECT.md
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
**From STATE.md extract:**
|
|
@@ -63,10 +63,10 @@ Look for incomplete work that needs attention:
|
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
65
|
# Check for continue-here files (mid-plan resumption)
|
|
66
|
-
ls .
|
|
66
|
+
ls .ariadna_planning/phases/*/.continue-here*.md 2>/dev/null
|
|
67
67
|
|
|
68
68
|
# Check for plans without summaries (incomplete execution)
|
|
69
|
-
for plan in .
|
|
69
|
+
for plan in .ariadna_planning/phases/*/*-PLAN.md; do
|
|
70
70
|
summary="${plan/PLAN/SUMMARY}"
|
|
71
71
|
[ ! -f "$summary" ] && echo "Incomplete: $plan"
|
|
72
72
|
done 2>/dev/null
|
|
@@ -196,7 +196,7 @@ What would you like to do?
|
|
|
196
196
|
**Note:** When offering phase planning, check for CONTEXT.md existence first:
|
|
197
197
|
|
|
198
198
|
```bash
|
|
199
|
-
ls .
|
|
199
|
+
ls .ariadna_planning/phases/XX-name/*-CONTEXT.md 2>/dev/null
|
|
200
200
|
```
|
|
201
201
|
|
|
202
202
|
If missing, suggest discuss-phase before plan. If exists, offer plan directly.
|
|
@@ -242,7 +242,7 @@ Based on user selection, route to appropriate workflow:
|
|
|
242
242
|
---
|
|
243
243
|
```
|
|
244
244
|
- **Transition** → ./transition.md
|
|
245
|
-
- **Check todos** → Read .
|
|
245
|
+
- **Check todos** → Read .ariadna_planning/todos/pending/, present summary
|
|
246
246
|
- **Review alignment** → Read PROJECT.md, compare to current state
|
|
247
247
|
- **Something else** → Ask what they need
|
|
248
248
|
</step>
|
|
@@ -273,7 +273,7 @@ If STATE.md is missing but other artifacts exist:
|
|
|
273
273
|
1. Read PROJECT.md → Extract "What This Is" and Core Value
|
|
274
274
|
2. Read ROADMAP.md → Determine phases, find current position
|
|
275
275
|
3. Scan \*-SUMMARY.md files → Extract decisions, concerns
|
|
276
|
-
4. Count pending todos in .
|
|
276
|
+
4. Count pending todos in .ariadna_planning/todos/pending/
|
|
277
277
|
5. Check for .continue-here files → Session continuity
|
|
278
278
|
|
|
279
279
|
Reconstruct and write STATE.md, then proceed normally.
|
|
@@ -282,7 +282,7 @@ This handles cases where:
|
|
|
282
282
|
|
|
283
283
|
- Project predates STATE.md introduction
|
|
284
284
|
- File was accidentally deleted
|
|
285
|
-
- Cloning repo without full .
|
|
285
|
+
- Cloning repo without full .ariadna_planning/ state
|
|
286
286
|
</reconstruction>
|
|
287
287
|
|
|
288
288
|
<quick_resume>
|
|
@@ -27,7 +27,7 @@ ariadna-tools config-ensure-section
|
|
|
27
27
|
INIT=$(ariadna-tools state load)
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
This creates `.
|
|
30
|
+
This creates `.ariadna_planning/config.json` with defaults if missing and loads current config.
|
|
31
31
|
</step>
|
|
32
32
|
|
|
33
33
|
<step name="update_config">
|
|
@@ -40,7 +40,7 @@ Update `model_profile` field:
|
|
|
40
40
|
}
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
Write updated config back to `.
|
|
43
|
+
Write updated config back to `.ariadna_planning/config.json`.
|
|
44
44
|
</step>
|
|
45
45
|
|
|
46
46
|
<step name="confirm">
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Interactive configuration of Ariadna workflow agents (research, plan_check, verifier) and model profile selection via multi-question prompt. Updates .
|
|
2
|
+
Interactive configuration of Ariadna workflow agents (research, plan_check, verifier) and model profile selection via multi-question prompt. Updates .ariadna_planning/config.json with user preferences.
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<required_reading>
|
|
@@ -16,12 +16,12 @@ ariadna-tools config-ensure-section
|
|
|
16
16
|
INIT=$(ariadna-tools state load)
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
Creates `.
|
|
19
|
+
Creates `.ariadna_planning/config.json` with defaults if missing and loads current config values.
|
|
20
20
|
</step>
|
|
21
21
|
|
|
22
22
|
<step name="read_current">
|
|
23
23
|
```bash
|
|
24
|
-
cat .
|
|
24
|
+
cat .ariadna_planning/config.json
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
Parse current values (default to `true` if not present):
|
|
@@ -106,7 +106,7 @@ Merge new settings into existing config.json:
|
|
|
106
106
|
}
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
Write updated config to `.
|
|
109
|
+
Write updated config to `.ariadna_planning/config.json`.
|
|
110
110
|
</step>
|
|
111
111
|
|
|
112
112
|
<step name="confirm">
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
**Read these files NOW:**
|
|
4
4
|
|
|
5
|
-
1. `.
|
|
6
|
-
2. `.
|
|
7
|
-
3. `.
|
|
5
|
+
1. `.ariadna_planning/STATE.md`
|
|
6
|
+
2. `.ariadna_planning/PROJECT.md`
|
|
7
|
+
3. `.ariadna_planning/ROADMAP.md`
|
|
8
8
|
4. Current phase's plan files (`*-PLAN.md`)
|
|
9
9
|
5. Current phase's summary files (`*-SUMMARY.md`)
|
|
10
10
|
|
|
@@ -25,8 +25,8 @@ Mark current phase complete and advance to next. This is the natural point where
|
|
|
25
25
|
Before transition, read project state:
|
|
26
26
|
|
|
27
27
|
```bash
|
|
28
|
-
cat .
|
|
29
|
-
cat .
|
|
28
|
+
cat .ariadna_planning/STATE.md 2>/dev/null
|
|
29
|
+
cat .ariadna_planning/PROJECT.md 2>/dev/null
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
Parse current position to verify we're transitioning the right phase.
|
|
@@ -39,8 +39,8 @@ Note accumulated context that may need updating after transition.
|
|
|
39
39
|
Check current phase has all plan summaries:
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
ls .
|
|
43
|
-
ls .
|
|
42
|
+
ls .ariadna_planning/phases/XX-current/*-PLAN.md 2>/dev/null | sort
|
|
43
|
+
ls .ariadna_planning/phases/XX-current/*-SUMMARY.md 2>/dev/null | sort
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
**Verification logic:**
|
|
@@ -53,7 +53,7 @@ ls .planning/phases/XX-current/*-SUMMARY.md 2>/dev/null | sort
|
|
|
53
53
|
<config-check>
|
|
54
54
|
|
|
55
55
|
```bash
|
|
56
|
-
cat .
|
|
56
|
+
cat .ariadna_planning/config.json 2>/dev/null
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
</config-check>
|
|
@@ -111,7 +111,7 @@ Wait for user decision.
|
|
|
111
111
|
Check for lingering handoffs:
|
|
112
112
|
|
|
113
113
|
```bash
|
|
114
|
-
ls .
|
|
114
|
+
ls .ariadna_planning/phases/XX-current/.continue-here*.md 2>/dev/null
|
|
115
115
|
```
|
|
116
116
|
|
|
117
117
|
If found, delete them — phase is complete, handoffs are stale.
|
|
@@ -151,7 +151,7 @@ Evolve PROJECT.md to reflect learnings from completed phase.
|
|
|
151
151
|
**Read phase summaries:**
|
|
152
152
|
|
|
153
153
|
```bash
|
|
154
|
-
cat .
|
|
154
|
+
cat .ariadna_planning/phases/XX-current/*-SUMMARY.md
|
|
155
155
|
```
|
|
156
156
|
|
|
157
157
|
**Assess requirement changes:**
|
|
@@ -259,7 +259,7 @@ Update Project Reference section in STATE.md.
|
|
|
259
259
|
```markdown
|
|
260
260
|
## Project Reference
|
|
261
261
|
|
|
262
|
-
See: .
|
|
262
|
+
See: .ariadna_planning/PROJECT.md (updated [today])
|
|
263
263
|
|
|
264
264
|
**Core value:** [Current core value from PROJECT.md]
|
|
265
265
|
**Current focus:** [Next phase name]
|
|
@@ -36,7 +36,7 @@ Extract from init JSON: `phase_dir`, `phase_number`, `phase_name`, `has_plans`,
|
|
|
36
36
|
Then load phase details and list plans/summaries:
|
|
37
37
|
```bash
|
|
38
38
|
ariadna-tools roadmap get-phase "${phase_number}"
|
|
39
|
-
grep -E "^| ${phase_number}" .
|
|
39
|
+
grep -E "^| ${phase_number}" .ariadna_planning/REQUIREMENTS.md 2>/dev/null
|
|
40
40
|
ls "$phase_dir"/*-SUMMARY.md "$phase_dir"/*-PLAN.md 2>/dev/null
|
|
41
41
|
```
|
|
42
42
|
|
|
@@ -143,7 +143,7 @@ Record status and evidence for each key link.
|
|
|
143
143
|
<step name="verify_requirements">
|
|
144
144
|
If REQUIREMENTS.md exists:
|
|
145
145
|
```bash
|
|
146
|
-
grep -E "Phase ${PHASE_NUM}" .
|
|
146
|
+
grep -E "Phase ${PHASE_NUM}" .ariadna_planning/REQUIREMENTS.md 2>/dev/null
|
|
147
147
|
```
|
|
148
148
|
|
|
149
149
|
For each requirement: parse description → identify supporting truths/artifacts → status: ✓ SATISFIED / ✗ BLOCKED / ? NEEDS HUMAN.
|
|
@@ -34,7 +34,7 @@ Parse JSON for: `planner_model`, `checker_model`, `commit_docs`, `phase_found`,
|
|
|
34
34
|
**First: Check for active UAT sessions**
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
|
-
find .
|
|
37
|
+
find .ariadna_planning/phases -name "*-UAT.md" -type f 2>/dev/null | head -5
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
**If active sessions exist AND no $ARGUMENTS provided:**
|
|
@@ -164,7 +164,7 @@ skipped: 0
|
|
|
164
164
|
[none yet]
|
|
165
165
|
```
|
|
166
166
|
|
|
167
|
-
Write to `.
|
|
167
|
+
Write to `.ariadna_planning/phases/XX-name/{phase}-UAT.md`
|
|
168
168
|
|
|
169
169
|
Proceed to `present_test`.
|
|
170
170
|
</step>
|
|
@@ -292,7 +292,7 @@ Clear Current Test section:
|
|
|
292
292
|
|
|
293
293
|
Commit the UAT file:
|
|
294
294
|
```bash
|
|
295
|
-
ariadna-tools commit "test({phase}): complete UAT - {passed} passed, {issues} issues" --files ".
|
|
295
|
+
ariadna-tools commit "test({phase}): complete UAT - {passed} passed, {issues} issues" --files ".ariadna_planning/phases/XX-name/{phase}-UAT.md"
|
|
296
296
|
```
|
|
297
297
|
|
|
298
298
|
Present summary:
|
|
@@ -366,13 +366,13 @@ Task(
|
|
|
366
366
|
**Mode:** gap_closure
|
|
367
367
|
|
|
368
368
|
**UAT with diagnoses:**
|
|
369
|
-
@.
|
|
369
|
+
@.ariadna_planning/phases/{phase_dir}/{phase}-UAT.md
|
|
370
370
|
|
|
371
371
|
**Project State:**
|
|
372
|
-
@.
|
|
372
|
+
@.ariadna_planning/STATE.md
|
|
373
373
|
|
|
374
374
|
**Roadmap:**
|
|
375
|
-
@.
|
|
375
|
+
@.ariadna_planning/ROADMAP.md
|
|
376
376
|
|
|
377
377
|
</planning_context>
|
|
378
378
|
|
|
@@ -417,7 +417,7 @@ Task(
|
|
|
417
417
|
**Phase Goal:** Close diagnosed gaps from UAT
|
|
418
418
|
|
|
419
419
|
**Plans to verify:**
|
|
420
|
-
@.
|
|
420
|
+
@.ariadna_planning/phases/{phase_dir}/*-PLAN.md
|
|
421
421
|
|
|
422
422
|
</verification_context>
|
|
423
423
|
|
|
@@ -456,7 +456,7 @@ Task(
|
|
|
456
456
|
**Mode:** revision
|
|
457
457
|
|
|
458
458
|
**Existing plans:**
|
|
459
|
-
@.
|
|
459
|
+
@.ariadna_planning/phases/{phase_dir}/*-PLAN.md
|
|
460
460
|
|
|
461
461
|
**Checker issues:**
|
|
462
462
|
{structured_issues_from_checker}
|
|
@@ -19,8 +19,8 @@ Routes to the add-phase workflow which handles:
|
|
|
19
19
|
</objective>
|
|
20
20
|
|
|
21
21
|
<execution_context>
|
|
22
|
-
@.
|
|
23
|
-
@.
|
|
22
|
+
@.ariadna_planning/ROADMAP.md
|
|
23
|
+
@.ariadna_planning/STATE.md
|
|
24
24
|
@~/.claude/ariadna/workflows/add-phase.md
|
|
25
25
|
</execution_context>
|
|
26
26
|
|
|
@@ -24,16 +24,16 @@ Verify milestone achieved its definition of done. Check requirements coverage, c
|
|
|
24
24
|
Version: $ARGUMENTS (optional — defaults to current milestone)
|
|
25
25
|
|
|
26
26
|
**Original Intent:**
|
|
27
|
-
@.
|
|
28
|
-
@.
|
|
27
|
+
@.ariadna_planning/PROJECT.md
|
|
28
|
+
@.ariadna_planning/REQUIREMENTS.md
|
|
29
29
|
|
|
30
30
|
**Planned Work:**
|
|
31
|
-
@.
|
|
32
|
-
@.
|
|
31
|
+
@.ariadna_planning/ROADMAP.md
|
|
32
|
+
@.ariadna_planning/config.json (if exists)
|
|
33
33
|
|
|
34
34
|
**Completed Work:**
|
|
35
|
-
Glob: .
|
|
36
|
-
Glob: .
|
|
35
|
+
Glob: .ariadna_planning/phases/*/*-SUMMARY.md
|
|
36
|
+
Glob: .ariadna_planning/phases/*/*-VERIFICATION.md
|
|
37
37
|
</context>
|
|
38
38
|
|
|
39
39
|
<process>
|
|
@@ -21,8 +21,8 @@ Routes to the check-todos workflow which handles:
|
|
|
21
21
|
</objective>
|
|
22
22
|
|
|
23
23
|
<execution_context>
|
|
24
|
-
@.
|
|
25
|
-
@.
|
|
24
|
+
@.ariadna_planning/STATE.md
|
|
25
|
+
@.ariadna_planning/ROADMAP.md
|
|
26
26
|
@~/.claude/ariadna/workflows/check-todos.md
|
|
27
27
|
</execution_context>
|
|
28
28
|
|
|
@@ -25,10 +25,10 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
|
|
25
25
|
|
|
26
26
|
<context>
|
|
27
27
|
**Project files:**
|
|
28
|
-
- `.
|
|
29
|
-
- `.
|
|
30
|
-
- `.
|
|
31
|
-
- `.
|
|
28
|
+
- `.ariadna_planning/ROADMAP.md`
|
|
29
|
+
- `.ariadna_planning/REQUIREMENTS.md`
|
|
30
|
+
- `.ariadna_planning/STATE.md`
|
|
31
|
+
- `.ariadna_planning/PROJECT.md`
|
|
32
32
|
|
|
33
33
|
**User input:**
|
|
34
34
|
|
|
@@ -41,7 +41,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
|
|
41
41
|
|
|
42
42
|
0. **Check for audit:**
|
|
43
43
|
|
|
44
|
-
- Look for `.
|
|
44
|
+
- Look for `.ariadna_planning/v{{version}}-MILESTONE-AUDIT.md`
|
|
45
45
|
- If missing or stale: recommend `/ariadna:audit-milestone` first
|
|
46
46
|
- If audit status is `gaps_found`: recommend `/ariadna:plan-milestone-gaps` first
|
|
47
47
|
- If audit status is `passed`: proceed to step 1
|
|
@@ -82,17 +82,17 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
|
|
82
82
|
|
|
83
83
|
4. **Archive milestone:**
|
|
84
84
|
|
|
85
|
-
- Create `.
|
|
85
|
+
- Create `.ariadna_planning/milestones/v{{version}}-ROADMAP.md`
|
|
86
86
|
- Extract full phase details from ROADMAP.md
|
|
87
87
|
- Fill milestone-archive.md template
|
|
88
88
|
- Update ROADMAP.md to one-line summary with link
|
|
89
89
|
|
|
90
90
|
5. **Archive requirements:**
|
|
91
91
|
|
|
92
|
-
- Create `.
|
|
92
|
+
- Create `.ariadna_planning/milestones/v{{version}}-REQUIREMENTS.md`
|
|
93
93
|
- Mark all v1 requirements as complete (checkboxes checked)
|
|
94
94
|
- Note requirement outcomes (validated, adjusted, dropped)
|
|
95
|
-
- Delete `.
|
|
95
|
+
- Delete `.ariadna_planning/REQUIREMENTS.md` (fresh one created for next milestone)
|
|
96
96
|
|
|
97
97
|
6. **Update PROJECT.md:**
|
|
98
98
|
|
|
@@ -114,9 +114,9 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
|
|
114
114
|
|
|
115
115
|
<success_criteria>
|
|
116
116
|
|
|
117
|
-
- Milestone archived to `.
|
|
118
|
-
- Requirements archived to `.
|
|
119
|
-
- `.
|
|
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
120
|
- ROADMAP.md collapsed to one-line entry
|
|
121
121
|
- PROJECT.md updated with current state
|
|
122
122
|
- Git tag v{{version}} created
|
|
@@ -22,7 +22,7 @@ User's issue: $ARGUMENTS
|
|
|
22
22
|
|
|
23
23
|
Check for active sessions:
|
|
24
24
|
```bash
|
|
25
|
-
ls .
|
|
25
|
+
ls .ariadna_planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
|
|
26
26
|
```
|
|
27
27
|
</context>
|
|
28
28
|
|
|
@@ -85,7 +85,7 @@ goal: find_and_fix
|
|
|
85
85
|
</mode>
|
|
86
86
|
|
|
87
87
|
<debug_file>
|
|
88
|
-
Create: .
|
|
88
|
+
Create: .ariadna_planning/debug/{slug}.md
|
|
89
89
|
</debug_file>
|
|
90
90
|
```
|
|
91
91
|
|
|
@@ -129,7 +129,7 @@ Continue debugging {slug}. Evidence is in the debug file.
|
|
|
129
129
|
</objective>
|
|
130
130
|
|
|
131
131
|
<prior_state>
|
|
132
|
-
Debug file: @.
|
|
132
|
+
Debug file: @.ariadna_planning/debug/{slug}.md
|
|
133
133
|
</prior_state>
|
|
134
134
|
|
|
135
135
|
<checkpoint_response>
|
|
@@ -32,10 +32,10 @@ Extract implementation decisions that downstream agents need — researcher and
|
|
|
32
32
|
Phase number: $ARGUMENTS (required)
|
|
33
33
|
|
|
34
34
|
**Load project state:**
|
|
35
|
-
@.
|
|
35
|
+
@.ariadna_planning/STATE.md
|
|
36
36
|
|
|
37
37
|
**Load roadmap:**
|
|
38
|
-
@.
|
|
38
|
+
@.ariadna_planning/ROADMAP.md
|
|
39
39
|
</context>
|
|
40
40
|
|
|
41
41
|
<process>
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ariadna:execute-phase
|
|
3
3
|
description: Execute all plans in a phase with wave-based parallelization
|
|
4
|
-
argument-hint: "<phase-number> [--gaps-only] [--team]"
|
|
4
|
+
argument-hint: "<phase-number> [--gaps-only] [--team] [--no-team]"
|
|
5
5
|
allowed-tools:
|
|
6
6
|
- Read
|
|
7
7
|
- Write
|
|
@@ -26,7 +26,7 @@ Orchestrator stays lean: discover plans, analyze dependencies, group into waves,
|
|
|
26
26
|
|
|
27
27
|
**Execution modes:**
|
|
28
28
|
- **Wave mode (default):** Sequential waves of parallel `Task()` spawns. Standard for most phases.
|
|
29
|
-
- **Team mode (`--team` flag
|
|
29
|
+
- **Team mode (`--team` flag, `team_execution: true` or `"auto"` in config):** Creates a team with domain-specialized executor agents that coordinate via shared task list. Better for large phases with domain-split plans. When `team_execution: "auto"`, team mode activates for phases with 3+ plans across 2+ non-general domains.
|
|
30
30
|
|
|
31
31
|
Context budget: ~15% orchestrator, 100% fresh per subagent.
|
|
32
32
|
</objective>
|
|
@@ -42,14 +42,15 @@ Phase: $ARGUMENTS
|
|
|
42
42
|
**Flags:**
|
|
43
43
|
- `--gaps-only` — Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verify-work creates fix plans.
|
|
44
44
|
- `--team` — Use team-based execution with domain-specialized agents instead of wave-based execution.
|
|
45
|
+
- `--no-team` — Force wave-based execution even when auto-detection would choose team mode.
|
|
45
46
|
|
|
46
|
-
@.
|
|
47
|
-
@.
|
|
47
|
+
@.ariadna_planning/ROADMAP.md
|
|
48
|
+
@.ariadna_planning/STATE.md
|
|
48
49
|
</context>
|
|
49
50
|
|
|
50
51
|
<process>
|
|
51
52
|
Execute the execute-phase workflow from @~/.claude/ariadna/workflows/execute-phase.md end-to-end.
|
|
52
53
|
Preserve all workflow gates (wave/team execution, checkpoint handling, verification, state updates, routing).
|
|
53
54
|
|
|
54
|
-
**Mode selection:**
|
|
55
|
+
**Mode selection:** Follow the `decide_execution_mode` step in the workflow to determine team vs wave execution based on flags, config, and plan analysis.
|
|
55
56
|
</process>
|
|
@@ -23,8 +23,8 @@ Purpose: Handle urgent work discovered during execution without renumbering enti
|
|
|
23
23
|
<context>
|
|
24
24
|
Arguments: $ARGUMENTS (format: <after-phase-number> <description>)
|
|
25
25
|
|
|
26
|
-
@.
|
|
27
|
-
@.
|
|
26
|
+
@.ariadna_planning/ROADMAP.md
|
|
27
|
+
@.ariadna_planning/STATE.md
|
|
28
28
|
</context>
|
|
29
29
|
|
|
30
30
|
<process>
|
|
@@ -24,10 +24,10 @@ Output: Conversational output only (no file creation) - ends with "What do you t
|
|
|
24
24
|
Phase number: $ARGUMENTS (required)
|
|
25
25
|
|
|
26
26
|
**Load project state first:**
|
|
27
|
-
@.
|
|
27
|
+
@.ariadna_planning/STATE.md
|
|
28
28
|
|
|
29
29
|
**Load roadmap:**
|
|
30
|
-
@.
|
|
30
|
+
@.ariadna_planning/ROADMAP.md
|
|
31
31
|
</context>
|
|
32
32
|
|
|
33
33
|
<process>
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ariadna:map-codebase
|
|
3
|
-
description: Analyze codebase with parallel mapper agents to produce .
|
|
3
|
+
description: Analyze codebase with parallel mapper agents to produce .ariadna_planning/codebase/ documents
|
|
4
4
|
argument-hint: "[optional: specific area to map, e.g., 'api' or 'auth']"
|
|
5
5
|
allowed-tools:
|
|
6
6
|
- Read
|
|
@@ -14,9 +14,9 @@ allowed-tools:
|
|
|
14
14
|
<objective>
|
|
15
15
|
Analyze existing codebase using parallel ariadna-codebase-mapper agents to produce structured codebase documents.
|
|
16
16
|
|
|
17
|
-
Each mapper agent explores a focus area and **writes documents directly** to `.
|
|
17
|
+
Each mapper agent explores a focus area and **writes documents directly** to `.ariadna_planning/codebase/`. The orchestrator only receives confirmations, keeping context usage minimal.
|
|
18
18
|
|
|
19
|
-
Output: .
|
|
19
|
+
Output: .ariadna_planning/codebase/ folder with 7 structured documents about the codebase state.
|
|
20
20
|
</objective>
|
|
21
21
|
|
|
22
22
|
<execution_context>
|
|
@@ -27,7 +27,7 @@ Output: .planning/codebase/ folder with 7 structured documents about the codebas
|
|
|
27
27
|
Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specific subsystem)
|
|
28
28
|
|
|
29
29
|
**Load project state if exists:**
|
|
30
|
-
Check for .
|
|
30
|
+
Check for .ariadna_planning/STATE.md - loads context if project already initialized
|
|
31
31
|
|
|
32
32
|
**This command can run:**
|
|
33
33
|
- Before /ariadna:new-project (brownfield codebases) - creates codebase map first
|
|
@@ -49,8 +49,8 @@ Check for .planning/STATE.md - loads context if project already initialized
|
|
|
49
49
|
</when_to_use>
|
|
50
50
|
|
|
51
51
|
<process>
|
|
52
|
-
1. Check if .
|
|
53
|
-
2. Create .
|
|
52
|
+
1. Check if .ariadna_planning/codebase/ already exists (offer to refresh or skip)
|
|
53
|
+
2. Create .ariadna_planning/codebase/ directory structure
|
|
54
54
|
3. Spawn 4 parallel ariadna-codebase-mapper agents:
|
|
55
55
|
- Agent 1: tech focus → writes STACK.md, INTEGRATIONS.md
|
|
56
56
|
- Agent 2: arch focus → writes ARCHITECTURE.md, STRUCTURE.md
|
|
@@ -63,7 +63,7 @@ Check for .planning/STATE.md - loads context if project already initialized
|
|
|
63
63
|
</process>
|
|
64
64
|
|
|
65
65
|
<success_criteria>
|
|
66
|
-
- [ ] .
|
|
66
|
+
- [ ] .ariadna_planning/codebase/ directory created
|
|
67
67
|
- [ ] All 7 codebase documents written by mapper agents
|
|
68
68
|
- [ ] Documents follow template structure
|
|
69
69
|
- [ ] Parallel agents completed without errors
|
|
@@ -15,11 +15,11 @@ Start a new milestone: questioning → research (optional) → requirements →
|
|
|
15
15
|
Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Gathers "what's next", updates PROJECT.md, then runs requirements → roadmap cycle.
|
|
16
16
|
|
|
17
17
|
**Creates/Updates:**
|
|
18
|
-
- `.
|
|
19
|
-
- `.
|
|
20
|
-
- `.
|
|
21
|
-
- `.
|
|
22
|
-
- `.
|
|
18
|
+
- `.ariadna_planning/PROJECT.md` — updated with new milestone goals
|
|
19
|
+
- `.ariadna_planning/research/` — domain research (optional, NEW features only)
|
|
20
|
+
- `.ariadna_planning/REQUIREMENTS.md` — scoped requirements for this milestone
|
|
21
|
+
- `.ariadna_planning/ROADMAP.md` — phase structure (continues numbering)
|
|
22
|
+
- `.ariadna_planning/STATE.md` — reset for new milestone
|
|
23
23
|
|
|
24
24
|
**After:** `/ariadna:plan-phase [N]` to start execution.
|
|
25
25
|
</objective>
|
|
@@ -36,13 +36,13 @@ Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Ga
|
|
|
36
36
|
Milestone name: $ARGUMENTS (optional - will prompt if not provided)
|
|
37
37
|
|
|
38
38
|
**Load project context:**
|
|
39
|
-
@.
|
|
40
|
-
@.
|
|
41
|
-
@.
|
|
42
|
-
@.
|
|
39
|
+
@.ariadna_planning/PROJECT.md
|
|
40
|
+
@.ariadna_planning/STATE.md
|
|
41
|
+
@.ariadna_planning/MILESTONES.md
|
|
42
|
+
@.ariadna_planning/config.json
|
|
43
43
|
|
|
44
44
|
**Load milestone context (if exists, from /ariadna:discuss-milestone):**
|
|
45
|
-
@.
|
|
45
|
+
@.ariadna_planning/MILESTONE-CONTEXT.md
|
|
46
46
|
</context>
|
|
47
47
|
|
|
48
48
|
<process>
|
|
@@ -19,12 +19,12 @@ allowed-tools:
|
|
|
19
19
|
Initialize a new project through streamlined flow: questioning → requirements → roadmap. Research skipped by default (Rails conventions pre-loaded); use --research for non-standard domains.
|
|
20
20
|
|
|
21
21
|
**Creates:**
|
|
22
|
-
- `.
|
|
23
|
-
- `.
|
|
24
|
-
- `.
|
|
25
|
-
- `.
|
|
26
|
-
- `.
|
|
27
|
-
- `.
|
|
22
|
+
- `.ariadna_planning/PROJECT.md` — project context
|
|
23
|
+
- `.ariadna_planning/config.json` — workflow preferences (opinionated defaults)
|
|
24
|
+
- `.ariadna_planning/research/` — domain research (only with --research flag)
|
|
25
|
+
- `.ariadna_planning/REQUIREMENTS.md` — scoped requirements
|
|
26
|
+
- `.ariadna_planning/ROADMAP.md` — phase structure
|
|
27
|
+
- `.ariadna_planning/STATE.md` — project memory
|
|
28
28
|
|
|
29
29
|
**After this command:** Run `/ariadna:plan-phase 1` to start planning.
|
|
30
30
|
</objective>
|
|
@@ -23,15 +23,15 @@ One command creates all fix phases — no manual `/ariadna:add-phase` per gap.
|
|
|
23
23
|
|
|
24
24
|
<context>
|
|
25
25
|
**Audit results:**
|
|
26
|
-
Glob: .
|
|
26
|
+
Glob: .ariadna_planning/v*-MILESTONE-AUDIT.md (use most recent)
|
|
27
27
|
|
|
28
28
|
**Original intent (for prioritization):**
|
|
29
|
-
@.
|
|
30
|
-
@.
|
|
29
|
+
@.ariadna_planning/PROJECT.md
|
|
30
|
+
@.ariadna_planning/REQUIREMENTS.md
|
|
31
31
|
|
|
32
32
|
**Current state:**
|
|
33
|
-
@.
|
|
34
|
-
@.
|
|
33
|
+
@.ariadna_planning/ROADMAP.md
|
|
34
|
+
@.ariadna_planning/STATE.md
|
|
35
35
|
</context>
|
|
36
36
|
|
|
37
37
|
<process>
|