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.
Files changed (117) hide show
  1. checksums.yaml +4 -4
  2. data/data/agents/ariadna-backend-executor.md +9 -6
  3. data/data/agents/ariadna-codebase-mapper.md +5 -5
  4. data/data/agents/ariadna-debugger.md +13 -13
  5. data/data/agents/ariadna-executor.md +9 -6
  6. data/data/agents/ariadna-frontend-executor.md +9 -6
  7. data/data/agents/ariadna-integration-checker.md +1 -1
  8. data/data/agents/ariadna-phase-researcher.md +1 -1
  9. data/data/agents/ariadna-planner.md +17 -17
  10. data/data/agents/ariadna-project-researcher.md +10 -10
  11. data/data/agents/ariadna-research-synthesizer.md +11 -11
  12. data/data/agents/ariadna-roadmapper.md +8 -8
  13. data/data/agents/ariadna-test-executor.md +9 -6
  14. data/data/agents/ariadna-verifier.md +4 -4
  15. data/data/ariadna/references/decimal-phase-calculation.md +2 -2
  16. data/data/ariadna/references/git-integration.md +4 -4
  17. data/data/ariadna/references/git-planning-commit.md +7 -7
  18. data/data/ariadna/references/model-profile-resolution.md +1 -1
  19. data/data/ariadna/references/model-profiles.md +2 -2
  20. data/data/ariadna/references/planning-config.md +13 -13
  21. data/data/ariadna/references/rails-conventions.md +9 -2
  22. data/data/ariadna/references/tdd.md +2 -2
  23. data/data/ariadna/templates/DEBUG.md +2 -2
  24. data/data/ariadna/templates/UAT.md +3 -3
  25. data/data/ariadna/templates/codebase/architecture.md +1 -1
  26. data/data/ariadna/templates/codebase/concerns.md +1 -1
  27. data/data/ariadna/templates/codebase/conventions.md +1 -1
  28. data/data/ariadna/templates/codebase/integrations.md +1 -1
  29. data/data/ariadna/templates/codebase/stack.md +1 -1
  30. data/data/ariadna/templates/codebase/structure.md +1 -1
  31. data/data/ariadna/templates/codebase/testing.md +1 -1
  32. data/data/ariadna/templates/context.md +2 -2
  33. data/data/ariadna/templates/continue-here.md +1 -1
  34. data/data/ariadna/templates/debug-subagent-prompt.md +2 -2
  35. data/data/ariadna/templates/discovery.md +2 -2
  36. data/data/ariadna/templates/milestone-archive.md +4 -4
  37. data/data/ariadna/templates/milestone.md +1 -1
  38. data/data/ariadna/templates/phase-prompt.md +19 -19
  39. data/data/ariadna/templates/planner-subagent-prompt.md +9 -9
  40. data/data/ariadna/templates/project.md +2 -2
  41. data/data/ariadna/templates/requirements.md +1 -1
  42. data/data/ariadna/templates/research-project/ARCHITECTURE.md +1 -1
  43. data/data/ariadna/templates/research-project/FEATURES.md +1 -1
  44. data/data/ariadna/templates/research-project/PITFALLS.md +1 -1
  45. data/data/ariadna/templates/research-project/STACK.md +1 -1
  46. data/data/ariadna/templates/research-project/SUMMARY.md +1 -1
  47. data/data/ariadna/templates/research.md +2 -2
  48. data/data/ariadna/templates/roadmap.md +1 -1
  49. data/data/ariadna/templates/state.md +4 -4
  50. data/data/ariadna/templates/summary.md +12 -1
  51. data/data/ariadna/templates/user-setup.md +2 -2
  52. data/data/ariadna/templates/verification-report.md +1 -1
  53. data/data/ariadna/workflows/add-phase.md +5 -5
  54. data/data/ariadna/workflows/add-todo.md +7 -7
  55. data/data/ariadna/workflows/audit-milestone.md +7 -7
  56. data/data/ariadna/workflows/check-todos.md +4 -4
  57. data/data/ariadna/workflows/complete-milestone.md +18 -18
  58. data/data/ariadna/workflows/diagnose-issues.md +4 -4
  59. data/data/ariadna/workflows/discovery-phase.md +4 -4
  60. data/data/ariadna/workflows/discuss-phase.md +2 -2
  61. data/data/ariadna/workflows/execute-phase.md +97 -9
  62. data/data/ariadna/workflows/execute-plan.md +30 -19
  63. data/data/ariadna/workflows/help.md +18 -18
  64. data/data/ariadna/workflows/insert-phase.md +6 -6
  65. data/data/ariadna/workflows/list-phase-assumptions.md +1 -1
  66. data/data/ariadna/workflows/map-codebase.md +22 -22
  67. data/data/ariadna/workflows/new-milestone.md +16 -16
  68. data/data/ariadna/workflows/new-project.md +39 -39
  69. data/data/ariadna/workflows/pause-work.md +4 -4
  70. data/data/ariadna/workflows/plan-milestone-gaps.md +4 -4
  71. data/data/ariadna/workflows/plan-phase.md +43 -19
  72. data/data/ariadna/workflows/progress.md +6 -6
  73. data/data/ariadna/workflows/quick.md +6 -6
  74. data/data/ariadna/workflows/remove-phase.md +3 -3
  75. data/data/ariadna/workflows/research-phase.md +4 -4
  76. data/data/ariadna/workflows/resume-project.md +9 -9
  77. data/data/ariadna/workflows/set-profile.md +2 -2
  78. data/data/ariadna/workflows/settings.md +4 -4
  79. data/data/ariadna/workflows/transition.md +11 -11
  80. data/data/ariadna/workflows/verify-phase.md +2 -2
  81. data/data/ariadna/workflows/verify-work.md +8 -8
  82. data/data/commands/ariadna/add-phase.md +2 -2
  83. data/data/commands/ariadna/add-todo.md +1 -1
  84. data/data/commands/ariadna/audit-milestone.md +6 -6
  85. data/data/commands/ariadna/check-todos.md +2 -2
  86. data/data/commands/ariadna/complete-milestone.md +11 -11
  87. data/data/commands/ariadna/debug.md +3 -3
  88. data/data/commands/ariadna/discuss-phase.md +2 -2
  89. data/data/commands/ariadna/execute-phase.md +6 -5
  90. data/data/commands/ariadna/insert-phase.md +2 -2
  91. data/data/commands/ariadna/list-phase-assumptions.md +2 -2
  92. data/data/commands/ariadna/map-codebase.md +7 -7
  93. data/data/commands/ariadna/new-milestone.md +10 -10
  94. data/data/commands/ariadna/new-project.md +6 -6
  95. data/data/commands/ariadna/pause-work.md +1 -1
  96. data/data/commands/ariadna/plan-milestone-gaps.md +5 -5
  97. data/data/commands/ariadna/quick.md +2 -2
  98. data/data/commands/ariadna/remove-phase.md +2 -2
  99. data/data/commands/ariadna/research-phase.md +6 -6
  100. data/data/commands/ariadna/verify-work.md +2 -2
  101. data/data/guides/frontend.md +1044 -9
  102. data/data/statusline/ariadna-statusline.sh +47 -0
  103. data/data/templates.md +1 -1
  104. data/exe/ariadna +2 -1
  105. data/lib/ariadna/installer.rb +30 -1
  106. data/lib/ariadna/tools/config_manager.rb +12 -6
  107. data/lib/ariadna/tools/git_integration.rb +2 -2
  108. data/lib/ariadna/tools/init.rb +66 -61
  109. data/lib/ariadna/tools/phase_manager.rb +31 -13
  110. data/lib/ariadna/tools/roadmap_analyzer.rb +5 -5
  111. data/lib/ariadna/tools/state_manager.rb +14 -14
  112. data/lib/ariadna/tools/template_filler.rb +5 -5
  113. data/lib/ariadna/tools/utilities.rb +4 -4
  114. data/lib/ariadna/tools/verification.rb +4 -4
  115. data/lib/ariadna/uninstaller.rb +17 -0
  116. data/lib/ariadna/version.rb +1 -1
  117. 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 .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
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 .planning/REQUIREMENTS.md 2>/dev/null
40
- cat .planning/phases/${PHASE}-*/*-CONTEXT.md 2>/dev/null
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: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
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 .planning/ already exists
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 .planning/STATE.md
39
- cat .planning/PROJECT.md
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 .planning/phases/*/.continue-here*.md 2>/dev/null
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 .planning/phases/*/*-PLAN.md; do
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 .planning/phases/XX-name/*-CONTEXT.md 2>/dev/null
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 .planning/todos/pending/, present summary
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 .planning/todos/pending/
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 .planning/ state
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 `.planning/config.json` with defaults if missing and loads current config.
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 `.planning/config.json`.
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 .planning/config.json with user preferences.
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 `.planning/config.json` with defaults if missing and loads current config values.
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 .planning/config.json
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 `.planning/config.json`.
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. `.planning/STATE.md`
6
- 2. `.planning/PROJECT.md`
7
- 3. `.planning/ROADMAP.md`
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 .planning/STATE.md 2>/dev/null
29
- cat .planning/PROJECT.md 2>/dev/null
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 .planning/phases/XX-current/*-PLAN.md 2>/dev/null | sort
43
- ls .planning/phases/XX-current/*-SUMMARY.md 2>/dev/null | sort
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 .planning/config.json 2>/dev/null
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 .planning/phases/XX-current/.continue-here*.md 2>/dev/null
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 .planning/phases/XX-current/*-SUMMARY.md
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: .planning/PROJECT.md (updated [today])
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}" .planning/REQUIREMENTS.md 2>/dev/null
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}" .planning/REQUIREMENTS.md 2>/dev/null
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 .planning/phases -name "*-UAT.md" -type f 2>/dev/null | head -5
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 `.planning/phases/XX-name/{phase}-UAT.md`
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 ".planning/phases/XX-name/{phase}-UAT.md"
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
- @.planning/phases/{phase_dir}/{phase}-UAT.md
369
+ @.ariadna_planning/phases/{phase_dir}/{phase}-UAT.md
370
370
 
371
371
  **Project State:**
372
- @.planning/STATE.md
372
+ @.ariadna_planning/STATE.md
373
373
 
374
374
  **Roadmap:**
375
- @.planning/ROADMAP.md
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
- @.planning/phases/{phase_dir}/*-PLAN.md
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
- @.planning/phases/{phase_dir}/*-PLAN.md
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
- @.planning/ROADMAP.md
23
- @.planning/STATE.md
22
+ @.ariadna_planning/ROADMAP.md
23
+ @.ariadna_planning/STATE.md
24
24
  @~/.claude/ariadna/workflows/add-phase.md
25
25
  </execution_context>
26
26
 
@@ -23,7 +23,7 @@ Routes to the add-todo workflow which handles:
23
23
  </objective>
24
24
 
25
25
  <execution_context>
26
- @.planning/STATE.md
26
+ @.ariadna_planning/STATE.md
27
27
  @~/.claude/ariadna/workflows/add-todo.md
28
28
  </execution_context>
29
29
 
@@ -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
- @.planning/PROJECT.md
28
- @.planning/REQUIREMENTS.md
27
+ @.ariadna_planning/PROJECT.md
28
+ @.ariadna_planning/REQUIREMENTS.md
29
29
 
30
30
  **Planned Work:**
31
- @.planning/ROADMAP.md
32
- @.planning/config.json (if exists)
31
+ @.ariadna_planning/ROADMAP.md
32
+ @.ariadna_planning/config.json (if exists)
33
33
 
34
34
  **Completed Work:**
35
- Glob: .planning/phases/*/*-SUMMARY.md
36
- Glob: .planning/phases/*/*-VERIFICATION.md
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
- @.planning/STATE.md
25
- @.planning/ROADMAP.md
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
- - `.planning/ROADMAP.md`
29
- - `.planning/REQUIREMENTS.md`
30
- - `.planning/STATE.md`
31
- - `.planning/PROJECT.md`
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 `.planning/v{{version}}-MILESTONE-AUDIT.md`
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 `.planning/milestones/v{{version}}-ROADMAP.md`
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 `.planning/milestones/v{{version}}-REQUIREMENTS.md`
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 `.planning/REQUIREMENTS.md` (fresh one created for next milestone)
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 `.planning/milestones/v{{version}}-ROADMAP.md`
118
- - Requirements archived to `.planning/milestones/v{{version}}-REQUIREMENTS.md`
119
- - `.planning/REQUIREMENTS.md` deleted (fresh for next milestone)
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 .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
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: .planning/debug/{slug}.md
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: @.planning/debug/{slug}.md
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
- @.planning/STATE.md
35
+ @.ariadna_planning/STATE.md
36
36
 
37
37
  **Load roadmap:**
38
- @.planning/ROADMAP.md
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 or `team_execution: true` in config):** Creates a team with domain-specialized executor agents that coordinate via shared task list. Better for large phases with domain-split plans.
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
- @.planning/ROADMAP.md
47
- @.planning/STATE.md
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:** If `--team` flag is present or `team_execution: true` in config, use the `team_execution` step. Otherwise use the standard `execute_waves` step.
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
- @.planning/ROADMAP.md
27
- @.planning/STATE.md
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
- @.planning/STATE.md
27
+ @.ariadna_planning/STATE.md
28
28
 
29
29
  **Load roadmap:**
30
- @.planning/ROADMAP.md
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 .planning/codebase/ documents
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 `.planning/codebase/`. The orchestrator only receives confirmations, keeping context usage minimal.
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: .planning/codebase/ folder with 7 structured documents about the codebase state.
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 .planning/STATE.md - loads context if project already initialized
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 .planning/codebase/ already exists (offer to refresh or skip)
53
- 2. Create .planning/codebase/ directory structure
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
- - [ ] .planning/codebase/ directory created
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
- - `.planning/PROJECT.md` — updated with new milestone goals
19
- - `.planning/research/` — domain research (optional, NEW features only)
20
- - `.planning/REQUIREMENTS.md` — scoped requirements for this milestone
21
- - `.planning/ROADMAP.md` — phase structure (continues numbering)
22
- - `.planning/STATE.md` — reset for new milestone
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
- @.planning/PROJECT.md
40
- @.planning/STATE.md
41
- @.planning/MILESTONES.md
42
- @.planning/config.json
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
- @.planning/MILESTONE-CONTEXT.md
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
- - `.planning/PROJECT.md` — project context
23
- - `.planning/config.json` — workflow preferences (opinionated defaults)
24
- - `.planning/research/` — domain research (only with --research flag)
25
- - `.planning/REQUIREMENTS.md` — scoped requirements
26
- - `.planning/ROADMAP.md` — phase structure
27
- - `.planning/STATE.md` — project memory
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>
@@ -19,7 +19,7 @@ Routes to the pause-work workflow which handles:
19
19
  </objective>
20
20
 
21
21
  <execution_context>
22
- @.planning/STATE.md
22
+ @.ariadna_planning/STATE.md
23
23
  @~/.claude/ariadna/workflows/pause-work.md
24
24
  </execution_context>
25
25
 
@@ -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: .planning/v*-MILESTONE-AUDIT.md (use most recent)
26
+ Glob: .ariadna_planning/v*-MILESTONE-AUDIT.md (use most recent)
27
27
 
28
28
  **Original intent (for prioritization):**
29
- @.planning/PROJECT.md
30
- @.planning/REQUIREMENTS.md
29
+ @.ariadna_planning/PROJECT.md
30
+ @.ariadna_planning/REQUIREMENTS.md
31
31
 
32
32
  **Current state:**
33
- @.planning/ROADMAP.md
34
- @.planning/STATE.md
33
+ @.ariadna_planning/ROADMAP.md
34
+ @.ariadna_planning/STATE.md
35
35
  </context>
36
36
 
37
37
  <process>