ariadna 1.2.1 → 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 (115) hide show
  1. checksums.yaml +4 -4
  2. data/data/agents/ariadna-backend-executor.md +5 -5
  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 +5 -5
  6. data/data/agents/ariadna-frontend-executor.md +5 -5
  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 +5 -5
  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/tdd.md +2 -2
  22. data/data/ariadna/templates/DEBUG.md +2 -2
  23. data/data/ariadna/templates/UAT.md +3 -3
  24. data/data/ariadna/templates/codebase/architecture.md +1 -1
  25. data/data/ariadna/templates/codebase/concerns.md +1 -1
  26. data/data/ariadna/templates/codebase/conventions.md +1 -1
  27. data/data/ariadna/templates/codebase/integrations.md +1 -1
  28. data/data/ariadna/templates/codebase/stack.md +1 -1
  29. data/data/ariadna/templates/codebase/structure.md +1 -1
  30. data/data/ariadna/templates/codebase/testing.md +1 -1
  31. data/data/ariadna/templates/context.md +2 -2
  32. data/data/ariadna/templates/continue-here.md +1 -1
  33. data/data/ariadna/templates/debug-subagent-prompt.md +2 -2
  34. data/data/ariadna/templates/discovery.md +2 -2
  35. data/data/ariadna/templates/milestone-archive.md +4 -4
  36. data/data/ariadna/templates/milestone.md +1 -1
  37. data/data/ariadna/templates/phase-prompt.md +19 -19
  38. data/data/ariadna/templates/planner-subagent-prompt.md +9 -9
  39. data/data/ariadna/templates/project.md +2 -2
  40. data/data/ariadna/templates/requirements.md +1 -1
  41. data/data/ariadna/templates/research-project/ARCHITECTURE.md +1 -1
  42. data/data/ariadna/templates/research-project/FEATURES.md +1 -1
  43. data/data/ariadna/templates/research-project/PITFALLS.md +1 -1
  44. data/data/ariadna/templates/research-project/STACK.md +1 -1
  45. data/data/ariadna/templates/research-project/SUMMARY.md +1 -1
  46. data/data/ariadna/templates/research.md +2 -2
  47. data/data/ariadna/templates/roadmap.md +1 -1
  48. data/data/ariadna/templates/state.md +4 -4
  49. data/data/ariadna/templates/summary.md +1 -1
  50. data/data/ariadna/templates/user-setup.md +2 -2
  51. data/data/ariadna/templates/verification-report.md +1 -1
  52. data/data/ariadna/workflows/add-phase.md +5 -5
  53. data/data/ariadna/workflows/add-todo.md +7 -7
  54. data/data/ariadna/workflows/audit-milestone.md +7 -7
  55. data/data/ariadna/workflows/check-todos.md +4 -4
  56. data/data/ariadna/workflows/complete-milestone.md +18 -18
  57. data/data/ariadna/workflows/diagnose-issues.md +4 -4
  58. data/data/ariadna/workflows/discovery-phase.md +4 -4
  59. data/data/ariadna/workflows/discuss-phase.md +2 -2
  60. data/data/ariadna/workflows/execute-phase.md +4 -4
  61. data/data/ariadna/workflows/execute-plan.md +19 -19
  62. data/data/ariadna/workflows/help.md +18 -18
  63. data/data/ariadna/workflows/insert-phase.md +6 -6
  64. data/data/ariadna/workflows/list-phase-assumptions.md +1 -1
  65. data/data/ariadna/workflows/map-codebase.md +22 -22
  66. data/data/ariadna/workflows/new-milestone.md +16 -16
  67. data/data/ariadna/workflows/new-project.md +39 -39
  68. data/data/ariadna/workflows/pause-work.md +4 -4
  69. data/data/ariadna/workflows/plan-milestone-gaps.md +4 -4
  70. data/data/ariadna/workflows/plan-phase.md +3 -3
  71. data/data/ariadna/workflows/progress.md +6 -6
  72. data/data/ariadna/workflows/quick.md +6 -6
  73. data/data/ariadna/workflows/remove-phase.md +3 -3
  74. data/data/ariadna/workflows/research-phase.md +4 -4
  75. data/data/ariadna/workflows/resume-project.md +9 -9
  76. data/data/ariadna/workflows/set-profile.md +2 -2
  77. data/data/ariadna/workflows/settings.md +4 -4
  78. data/data/ariadna/workflows/transition.md +11 -11
  79. data/data/ariadna/workflows/verify-phase.md +2 -2
  80. data/data/ariadna/workflows/verify-work.md +8 -8
  81. data/data/commands/ariadna/add-phase.md +2 -2
  82. data/data/commands/ariadna/add-todo.md +1 -1
  83. data/data/commands/ariadna/audit-milestone.md +6 -6
  84. data/data/commands/ariadna/check-todos.md +2 -2
  85. data/data/commands/ariadna/complete-milestone.md +11 -11
  86. data/data/commands/ariadna/debug.md +3 -3
  87. data/data/commands/ariadna/discuss-phase.md +2 -2
  88. data/data/commands/ariadna/execute-phase.md +2 -2
  89. data/data/commands/ariadna/insert-phase.md +2 -2
  90. data/data/commands/ariadna/list-phase-assumptions.md +2 -2
  91. data/data/commands/ariadna/map-codebase.md +7 -7
  92. data/data/commands/ariadna/new-milestone.md +10 -10
  93. data/data/commands/ariadna/new-project.md +6 -6
  94. data/data/commands/ariadna/pause-work.md +1 -1
  95. data/data/commands/ariadna/plan-milestone-gaps.md +5 -5
  96. data/data/commands/ariadna/quick.md +2 -2
  97. data/data/commands/ariadna/remove-phase.md +2 -2
  98. data/data/commands/ariadna/research-phase.md +6 -6
  99. data/data/commands/ariadna/verify-work.md +2 -2
  100. data/data/statusline/ariadna-statusline.sh +47 -0
  101. data/data/templates.md +1 -1
  102. data/exe/ariadna +2 -1
  103. data/lib/ariadna/installer.rb +30 -1
  104. data/lib/ariadna/tools/config_manager.rb +5 -5
  105. data/lib/ariadna/tools/git_integration.rb +2 -2
  106. data/lib/ariadna/tools/init.rb +61 -61
  107. data/lib/ariadna/tools/phase_manager.rb +11 -11
  108. data/lib/ariadna/tools/roadmap_analyzer.rb +5 -5
  109. data/lib/ariadna/tools/state_manager.rb +14 -14
  110. data/lib/ariadna/tools/template_filler.rb +5 -5
  111. data/lib/ariadna/tools/utilities.rb +4 -4
  112. data/lib/ariadna/tools/verification.rb +4 -4
  113. data/lib/ariadna/uninstaller.rb +17 -0
  114. data/lib/ariadna/version.rb +1 -1
  115. metadata +2 -1
@@ -38,7 +38,7 @@ One command takes you from idea to ready-for-planning:
38
38
  - Requirements definition with v1/v2/out-of-scope scoping
39
39
  - Roadmap creation with phase breakdown and success criteria
40
40
 
41
- Creates all `.planning/` artifacts:
41
+ Creates all `.ariadna_planning/` artifacts:
42
42
  - `PROJECT.md` — vision and requirements
43
43
  - `config.json` — workflow mode (interactive/yolo)
44
44
  - `research/` — domain research (if selected)
@@ -52,7 +52,7 @@ Usage: `/ariadna:new-project`
52
52
  Map an existing codebase for brownfield projects.
53
53
 
54
54
  - Analyzes codebase with parallel Explore agents
55
- - Creates `.planning/codebase/` with 7 focused documents
55
+ - Creates `.ariadna_planning/codebase/` with 7 focused documents
56
56
  - Covers stack, architecture, structure, conventions, testing, integrations, concerns
57
57
  - Use before `/ariadna:new-project` on existing codebases
58
58
 
@@ -91,13 +91,13 @@ Usage: `/ariadna:list-phase-assumptions 3`
91
91
  **`/ariadna:plan-phase <number>`**
92
92
  Create detailed execution plan for a specific phase.
93
93
 
94
- - Generates `.planning/phases/XX-phase-name/XX-YY-PLAN.md`
94
+ - Generates `.ariadna_planning/phases/XX-phase-name/XX-YY-PLAN.md`
95
95
  - Breaks phase into concrete, actionable tasks
96
96
  - Includes verification criteria and success measures
97
97
  - Multiple plans per phase supported (XX-01, XX-02, etc.)
98
98
 
99
99
  Usage: `/ariadna:plan-phase 1`
100
- Result: Creates `.planning/phases/01-foundation/01-01-PLAN.md`
100
+ Result: Creates `.ariadna_planning/phases/01-foundation/01-01-PLAN.md`
101
101
 
102
102
  ### Execution
103
103
 
@@ -118,13 +118,13 @@ Execute small, ad-hoc tasks with Ariadna guarantees but skip optional agents.
118
118
 
119
119
  Quick mode uses the same system with a shorter path:
120
120
  - Spawns planner + executor (skips researcher, checker, verifier)
121
- - Quick tasks live in `.planning/quick/` separate from planned phases
121
+ - Quick tasks live in `.ariadna_planning/quick/` separate from planned phases
122
122
  - Updates STATE.md tracking (not ROADMAP.md)
123
123
 
124
124
  Use when you know exactly what to do and the task is small enough to not need research or verification.
125
125
 
126
126
  Usage: `/ariadna:quick`
127
- Result: Creates `.planning/quick/NNN-slug/PLAN.md`, `.planning/quick/NNN-slug/SUMMARY.md`
127
+ Result: Creates `.ariadna_planning/quick/NNN-slug/PLAN.md`, `.ariadna_planning/quick/NNN-slug/SUMMARY.md`
128
128
 
129
129
  ### Roadmap Management
130
130
 
@@ -222,10 +222,10 @@ Usage: `/ariadna:pause-work`
222
222
  Systematic debugging with persistent state across context resets.
223
223
 
224
224
  - Gathers symptoms through adaptive questioning
225
- - Creates `.planning/debug/[slug].md` to track investigation
225
+ - Creates `.ariadna_planning/debug/[slug].md` to track investigation
226
226
  - Investigates using scientific method (evidence → hypothesis → test)
227
227
  - Survives `/clear` — run `/ariadna:debug` with no args to resume
228
- - Archives resolved issues to `.planning/debug/resolved/`
228
+ - Archives resolved issues to `.ariadna_planning/debug/resolved/`
229
229
 
230
230
  Usage: `/ariadna:debug "login button doesn't work"`
231
231
  Usage: `/ariadna:debug` (resume active session)
@@ -236,7 +236,7 @@ Usage: `/ariadna:debug` (resume active session)
236
236
  Capture idea or task as todo from current conversation.
237
237
 
238
238
  - Extracts context from conversation (or uses provided description)
239
- - Creates structured todo file in `.planning/todos/pending/`
239
+ - Creates structured todo file in `.ariadna_planning/todos/pending/`
240
240
  - Infers area from file paths for grouping
241
241
  - Checks for duplicates before creating
242
242
  - Updates STATE.md todo count
@@ -297,7 +297,7 @@ Configure workflow toggles and model profile interactively.
297
297
 
298
298
  - Toggle researcher, plan checker, verifier agents
299
299
  - Select model profile (quality/balanced/budget)
300
- - Updates `.planning/config.json`
300
+ - Updates `.ariadna_planning/config.json`
301
301
 
302
302
  Usage: `/ariadna:settings`
303
303
 
@@ -337,7 +337,7 @@ Usage: `/ariadna:join-discord`
337
337
  ## Files & Structure
338
338
 
339
339
  ```
340
- .planning/
340
+ .ariadna_planning/
341
341
  ├── PROJECT.md # Project vision
342
342
  ├── ROADMAP.md # Current phase breakdown
343
343
  ├── STATE.md # Project memory & context
@@ -380,24 +380,24 @@ Set during `/ariadna:new-project`:
380
380
  - Executes plans without confirmation
381
381
  - Only stops for critical checkpoints
382
382
 
383
- Change anytime by editing `.planning/config.json`
383
+ Change anytime by editing `.ariadna_planning/config.json`
384
384
 
385
385
  ## Planning Configuration
386
386
 
387
- Configure how planning artifacts are managed in `.planning/config.json`:
387
+ Configure how planning artifacts are managed in `.ariadna_planning/config.json`:
388
388
 
389
389
  **`planning.commit_docs`** (default: `true`)
390
390
  - `true`: Planning artifacts committed to git (standard workflow)
391
391
  - `false`: Planning artifacts kept local-only, not committed
392
392
 
393
393
  When `commit_docs: false`:
394
- - Add `.planning/` to your `.gitignore`
394
+ - Add `.ariadna_planning/` to your `.gitignore`
395
395
  - Useful for OSS contributions, client projects, or keeping planning private
396
396
  - All planning files still work normally, just not tracked in git
397
397
 
398
398
  **`planning.search_gitignored`** (default: `false`)
399
399
  - `true`: Add `--no-ignore` to broad ripgrep searches
400
- - Only needed when `.planning/` is gitignored and you want project-wide searches to include it
400
+ - Only needed when `.ariadna_planning/` is gitignored and you want project-wide searches to include it
401
401
 
402
402
  Example config:
403
403
  ```json
@@ -463,8 +463,8 @@ Example config:
463
463
 
464
464
  ## Getting Help
465
465
 
466
- - Read `.planning/PROJECT.md` for project vision
467
- - Read `.planning/STATE.md` for current context
468
- - Check `.planning/ROADMAP.md` for phase status
466
+ - Read `.ariadna_planning/PROJECT.md` for project vision
467
+ - Read `.ariadna_planning/STATE.md` for current context
468
+ - Check `.ariadna_planning/ROADMAP.md` for phase status
469
469
  - Run `/ariadna:progress` to check where you're up to
470
470
  </reference>
@@ -39,7 +39,7 @@ INIT=$(ariadna-tools init phase-op "${after_phase}")
39
39
 
40
40
  Check `roadmap_exists` from init JSON. If false:
41
41
  ```
42
- ERROR: No roadmap found (.planning/ROADMAP.md)
42
+ ERROR: No roadmap found (.ariadna_planning/ROADMAP.md)
43
43
  ```
44
44
  Exit.
45
45
  </step>
@@ -55,7 +55,7 @@ The CLI handles:
55
55
  - Verifying target phase exists in ROADMAP.md
56
56
  - Calculating next decimal phase number (checking existing decimals on disk)
57
57
  - Generating slug from description
58
- - Creating the phase directory (`.planning/phases/{N.M}-{slug}/`)
58
+ - Creating the phase directory (`.ariadna_planning/phases/{N.M}-{slug}/`)
59
59
  - Inserting the phase entry into ROADMAP.md after the target phase with (INSERTED) marker
60
60
 
61
61
  Extract from result: `phase_number`, `after_phase`, `name`, `slug`, `directory`.
@@ -64,7 +64,7 @@ Extract from result: `phase_number`, `after_phase`, `name`, `slug`, `directory`.
64
64
  <step name="update_project_state">
65
65
  Update STATE.md to reflect the inserted phase:
66
66
 
67
- 1. Read `.planning/STATE.md`
67
+ 1. Read `.ariadna_planning/STATE.md`
68
68
  2. Under "## Accumulated Context" → "### Roadmap Evolution" add entry:
69
69
  ```
70
70
  - Phase {decimal_phase} inserted after Phase {after_phase}: {description} (URGENT)
@@ -79,12 +79,12 @@ Present completion summary:
79
79
  ```
80
80
  Phase {decimal_phase} inserted after Phase {after_phase}:
81
81
  - Description: {description}
82
- - Directory: .planning/phases/{decimal-phase}-{slug}/
82
+ - Directory: .ariadna_planning/phases/{decimal-phase}-{slug}/
83
83
  - Status: Not planned yet
84
84
  - Marker: (INSERTED) - indicates urgent work
85
85
 
86
- Roadmap updated: .planning/ROADMAP.md
87
- Project state updated: .planning/STATE.md
86
+ Roadmap updated: .ariadna_planning/ROADMAP.md
87
+ Project state updated: .ariadna_planning/STATE.md
88
88
 
89
89
  ---
90
90
 
@@ -24,7 +24,7 @@ Exit workflow.
24
24
  Validate phase exists in roadmap:
25
25
 
26
26
  ```bash
27
- cat .planning/ROADMAP.md | grep -i "Phase ${PHASE}"
27
+ cat .ariadna_planning/ROADMAP.md | grep -i "Phase ${PHASE}"
28
28
  ```
29
29
 
30
30
  **If phase not found:**
@@ -1,9 +1,9 @@
1
1
  <purpose>
2
- Orchestrate parallel codebase mapper agents to analyze codebase and produce structured documents in .planning/codebase/
2
+ Orchestrate parallel codebase mapper agents to analyze codebase and produce structured documents in .ariadna_planning/codebase/
3
3
 
4
4
  Each agent has fresh context, explores a specific focus area, and **writes documents directly**. The orchestrator only receives confirmation + line counts, then writes a summary.
5
5
 
6
- Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
6
+ Output: .ariadna_planning/codebase/ folder with 7 structured documents about the codebase state.
7
7
  </purpose>
8
8
 
9
9
  <philosophy>
@@ -33,17 +33,17 @@ Extract from init JSON: `mapper_model`, `commit_docs`, `codebase_dir`, `existing
33
33
  </step>
34
34
 
35
35
  <step name="check_existing">
36
- Check if .planning/codebase/ already exists using `has_maps` from init context.
36
+ Check if .ariadna_planning/codebase/ already exists using `has_maps` from init context.
37
37
 
38
38
  If `codebase_dir_exists` is true:
39
39
  ```bash
40
- ls -la .planning/codebase/
40
+ ls -la .ariadna_planning/codebase/
41
41
  ```
42
42
 
43
43
  **If exists:**
44
44
 
45
45
  ```
46
- .planning/codebase/ already exists with these documents:
46
+ .ariadna_planning/codebase/ already exists with these documents:
47
47
  [List files found]
48
48
 
49
49
  What's next?
@@ -54,7 +54,7 @@ What's next?
54
54
 
55
55
  Wait for user response.
56
56
 
57
- If "Refresh": Delete .planning/codebase/, continue to create_structure
57
+ If "Refresh": Delete .ariadna_planning/codebase/, continue to create_structure
58
58
  If "Update": Ask which documents to update, continue to spawn_agents (filtered)
59
59
  If "Skip": Exit workflow
60
60
 
@@ -63,10 +63,10 @@ Continue to create_structure.
63
63
  </step>
64
64
 
65
65
  <step name="create_structure">
66
- Create .planning/codebase/ directory:
66
+ Create .ariadna_planning/codebase/ directory:
67
67
 
68
68
  ```bash
69
- mkdir -p .planning/codebase
69
+ mkdir -p .ariadna_planning/codebase
70
70
  ```
71
71
 
72
72
  **Expected output files:**
@@ -104,7 +104,7 @@ Focus: tech
104
104
 
105
105
  Analyze this codebase for technology stack and external integrations.
106
106
 
107
- Write these documents to .planning/codebase/:
107
+ Write these documents to .ariadna_planning/codebase/:
108
108
  - STACK.md - Languages, runtime, frameworks, dependencies, configuration
109
109
  - INTEGRATIONS.md - External APIs, databases, auth providers, webhooks
110
110
 
@@ -127,7 +127,7 @@ Focus: arch
127
127
 
128
128
  Analyze this codebase architecture and directory structure.
129
129
 
130
- Write these documents to .planning/codebase/:
130
+ Write these documents to .ariadna_planning/codebase/:
131
131
  - ARCHITECTURE.md - Pattern, layers, data flow, abstractions, entry points
132
132
  - STRUCTURE.md - Directory layout, key locations, naming conventions
133
133
 
@@ -150,7 +150,7 @@ Focus: quality
150
150
 
151
151
  Analyze this codebase for coding conventions and testing patterns.
152
152
 
153
- Write these documents to .planning/codebase/:
153
+ Write these documents to .ariadna_planning/codebase/:
154
154
  - CONVENTIONS.md - Code style, naming, patterns, error handling
155
155
  - TESTING.md - Framework, structure, mocking, coverage
156
156
 
@@ -173,7 +173,7 @@ Focus: concerns
173
173
 
174
174
  Analyze this codebase for technical debt, known issues, and areas of concern.
175
175
 
176
- Write this document to .planning/codebase/:
176
+ Write this document to .ariadna_planning/codebase/:
177
177
  - CONCERNS.md - Tech debt, bugs, security, performance, fragile areas
178
178
 
179
179
  Explore thoroughly. Write document directly using template. Return confirmation only.
@@ -193,8 +193,8 @@ Read each agent's output file to collect confirmations.
193
193
 
194
194
  **Focus:** {focus}
195
195
  **Documents written:**
196
- - `.planning/codebase/{DOC1}.md` ({N} lines)
197
- - `.planning/codebase/{DOC2}.md` ({N} lines)
196
+ - `.ariadna_planning/codebase/{DOC1}.md` ({N} lines)
197
+ - `.ariadna_planning/codebase/{DOC2}.md` ({N} lines)
198
198
 
199
199
  Ready for orchestrator summary.
200
200
  ```
@@ -210,8 +210,8 @@ Continue to verify_output.
210
210
  Verify all documents created successfully:
211
211
 
212
212
  ```bash
213
- ls -la .planning/codebase/
214
- wc -l .planning/codebase/*.md
213
+ ls -la .ariadna_planning/codebase/
214
+ wc -l .ariadna_planning/codebase/*.md
215
215
  ```
216
216
 
217
217
  **Verification checklist:**
@@ -230,7 +230,7 @@ Run secret pattern detection:
230
230
 
231
231
  ```bash
232
232
  # Check for common API key patterns in generated docs
233
- grep -E '(sk-[a-zA-Z0-9]{20,}|sk_live_[a-zA-Z0-9]+|sk_test_[a-zA-Z0-9]+|ghp_[a-zA-Z0-9]{36}|gho_[a-zA-Z0-9]{36}|glpat-[a-zA-Z0-9_-]+|AKIA[A-Z0-9]{16}|xox[baprs]-[a-zA-Z0-9-]+|-----BEGIN.*PRIVATE KEY|eyJ[a-zA-Z0-9_-]+\.eyJ[a-zA-Z0-9_-]+\.)' .planning/codebase/*.md 2>/dev/null && SECRETS_FOUND=true || SECRETS_FOUND=false
233
+ grep -E '(sk-[a-zA-Z0-9]{20,}|sk_live_[a-zA-Z0-9]+|sk_test_[a-zA-Z0-9]+|ghp_[a-zA-Z0-9]{36}|gho_[a-zA-Z0-9]{36}|glpat-[a-zA-Z0-9_-]+|AKIA[A-Z0-9]{16}|xox[baprs]-[a-zA-Z0-9-]+|-----BEGIN.*PRIVATE KEY|eyJ[a-zA-Z0-9_-]+\.eyJ[a-zA-Z0-9_-]+\.)' .ariadna_planning/codebase/*.md 2>/dev/null && SECRETS_FOUND=true || SECRETS_FOUND=false
234
234
  ```
235
235
 
236
236
  **If SECRETS_FOUND=true:**
@@ -262,7 +262,7 @@ Continue to commit_codebase_map.
262
262
  Commit the codebase map:
263
263
 
264
264
  ```bash
265
- ariadna-tools commit "docs: map existing codebase" --files .planning/codebase/*.md
265
+ ariadna-tools commit "docs: map existing codebase" --files .ariadna_planning/codebase/*.md
266
266
  ```
267
267
 
268
268
  Continue to offer_next.
@@ -273,7 +273,7 @@ Present completion summary and next steps.
273
273
 
274
274
  **Get line counts:**
275
275
  ```bash
276
- wc -l .planning/codebase/*.md
276
+ wc -l .ariadna_planning/codebase/*.md
277
277
  ```
278
278
 
279
279
  **Output format:**
@@ -281,7 +281,7 @@ wc -l .planning/codebase/*.md
281
281
  ```
282
282
  Codebase mapping complete.
283
283
 
284
- Created .planning/codebase/:
284
+ Created .ariadna_planning/codebase/:
285
285
  - STACK.md ([N] lines) - Technologies and dependencies
286
286
  - ARCHITECTURE.md ([N] lines) - System design and patterns
287
287
  - STRUCTURE.md ([N] lines) - Directory layout and organization
@@ -305,7 +305,7 @@ Created .planning/codebase/:
305
305
 
306
306
  **Also available:**
307
307
  - Re-run mapping: `/ariadna:map-codebase`
308
- - Review specific file: `cat .planning/codebase/STACK.md`
308
+ - Review specific file: `cat .ariadna_planning/codebase/STACK.md`
309
309
  - Edit any document before proceeding
310
310
 
311
311
  ---
@@ -317,7 +317,7 @@ End workflow.
317
317
  </process>
318
318
 
319
319
  <success_criteria>
320
- - .planning/codebase/ directory created
320
+ - .ariadna_planning/codebase/ directory created
321
321
  - 4 parallel ariadna-codebase-mapper agents spawned with run_in_background=true
322
322
  - Agents write documents directly (orchestrator doesn't receive document contents)
323
323
  - Read agent output files to collect confirmations
@@ -71,7 +71,7 @@ Keep Accumulated Context section from previous milestone.
71
71
  Delete MILESTONE-CONTEXT.md if exists (consumed).
72
72
 
73
73
  ```bash
74
- ariadna-tools commit "docs: start milestone v[X.Y] [Name]" --files .planning/PROJECT.md .planning/STATE.md
74
+ ariadna-tools commit "docs: start milestone v[X.Y] [Name]" --files .ariadna_planning/PROJECT.md .ariadna_planning/STATE.md
75
75
  ```
76
76
 
77
77
  ## 7. Load Context and Resolve Models
@@ -110,7 +110,7 @@ ariadna-tools config-set workflow.research false
110
110
  ```
111
111
 
112
112
  ```bash
113
- mkdir -p .planning/research
113
+ mkdir -p .ariadna_planning/research
114
114
  ```
115
115
 
116
116
  Spawn 4 parallel ariadna-project-researcher agents. Each uses this template with dimension-specific fields:
@@ -135,7 +135,7 @@ Focus ONLY on what's needed for the NEW features.
135
135
  <quality_gate>{GATES}</quality_gate>
136
136
 
137
137
  <output>
138
- Write to: .planning/research/{FILE}
138
+ Write to: .ariadna_planning/research/{FILE}
139
139
  Use template: ~/.claude/ariadna/templates/research-project/{FILE}
140
140
  </output>
141
141
  ", subagent_type="ariadna-project-researcher", model="{researcher_model}", description="{DIMENSION} research")
@@ -157,9 +157,9 @@ After all 4 complete, spawn synthesizer:
157
157
  Task(prompt="
158
158
  Synthesize research outputs into SUMMARY.md.
159
159
 
160
- Read: .planning/research/STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md
160
+ Read: .ariadna_planning/research/STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md
161
161
 
162
- Write to: .planning/research/SUMMARY.md
162
+ Write to: .ariadna_planning/research/SUMMARY.md
163
163
  Use template: ~/.claude/ariadna/templates/research-project/SUMMARY.md
164
164
  Commit after writing.
165
165
  ", subagent_type="ariadna-research-synthesizer", model="{synthesizer_model}", description="Synthesize research")
@@ -246,7 +246,7 @@ If "adjust": Return to scoping.
246
246
 
247
247
  **Commit requirements:**
248
248
  ```bash
249
- ariadna-tools commit "docs: define milestone v[X.Y] requirements" --files .planning/REQUIREMENTS.md
249
+ ariadna-tools commit "docs: define milestone v[X.Y] requirements" --files .ariadna_planning/REQUIREMENTS.md
250
250
  ```
251
251
 
252
252
  ## 10. Create Roadmap
@@ -264,11 +264,11 @@ ariadna-tools commit "docs: define milestone v[X.Y] requirements" --files .plann
264
264
  ```
265
265
  Task(prompt="
266
266
  <planning_context>
267
- @.planning/PROJECT.md
268
- @.planning/REQUIREMENTS.md
269
- @.planning/research/SUMMARY.md (if exists)
270
- @.planning/config.json
271
- @.planning/MILESTONES.md
267
+ @.ariadna_planning/PROJECT.md
268
+ @.ariadna_planning/REQUIREMENTS.md
269
+ @.ariadna_planning/research/SUMMARY.md (if exists)
270
+ @.ariadna_planning/config.json
271
+ @.ariadna_planning/MILESTONES.md
272
272
  </planning_context>
273
273
 
274
274
  <instructions>
@@ -321,7 +321,7 @@ Success criteria:
321
321
 
322
322
  **Commit roadmap** (after approval):
323
323
  ```bash
324
- ariadna-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files .planning/ROADMAP.md .planning/STATE.md .planning/REQUIREMENTS.md
324
+ ariadna-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files .ariadna_planning/ROADMAP.md .ariadna_planning/STATE.md .ariadna_planning/REQUIREMENTS.md
325
325
  ```
326
326
 
327
327
  ## 11. Done
@@ -335,10 +335,10 @@ ariadna-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --file
335
335
 
336
336
  | Artifact | Location |
337
337
  |----------------|-----------------------------|
338
- | Project | `.planning/PROJECT.md` |
339
- | Research | `.planning/research/` |
340
- | Requirements | `.planning/REQUIREMENTS.md` |
341
- | Roadmap | `.planning/ROADMAP.md` |
338
+ | Project | `.ariadna_planning/PROJECT.md` |
339
+ | Research | `.ariadna_planning/research/` |
340
+ | Requirements | `.ariadna_planning/REQUIREMENTS.md` |
341
+ | Roadmap | `.ariadna_planning/ROADMAP.md` |
342
342
 
343
343
  **[N] phases** | **[X] requirements** | Ready to build ✓
344
344
 
@@ -133,7 +133,7 @@ Loop until "Create PROJECT.md" selected.
133
133
 
134
134
  **If auto mode:** Synthesize from provided document. No "Ready?" gate was shown — proceed directly to commit.
135
135
 
136
- Synthesize all context into `.planning/PROJECT.md` using the template from `templates/project.md`.
136
+ Synthesize all context into `.ariadna_planning/PROJECT.md` using the template from `templates/project.md`.
137
137
 
138
138
  **For greenfield projects:**
139
139
 
@@ -164,7 +164,7 @@ All Active requirements are hypotheses until shipped and validated.
164
164
 
165
165
  Infer Validated requirements from existing code:
166
166
 
167
- 1. Read `.planning/codebase/ARCHITECTURE.md` and `STACK.md`
167
+ 1. Read `.ariadna_planning/codebase/ARCHITECTURE.md` and `STACK.md`
168
168
  2. Identify what the codebase already does
169
169
  3. These become the initial Validated set
170
170
 
@@ -211,15 +211,15 @@ Do not compress. Capture everything gathered.
211
211
  **Commit PROJECT.md:**
212
212
 
213
213
  ```bash
214
- mkdir -p .planning
215
- ariadna-tools commit "docs: initialize project" --files .planning/PROJECT.md
214
+ mkdir -p .ariadna_planning
215
+ ariadna-tools commit "docs: initialize project" --files .ariadna_planning/PROJECT.md
216
216
  ```
217
217
 
218
218
  ## 5. Workflow Configuration
219
219
 
220
220
  **Use opinionated defaults. Only ask if user wants to customize.**
221
221
 
222
- Apply these defaults directly to `.planning/config.json`:
222
+ Apply these defaults directly to `.ariadna_planning/config.json`:
223
223
 
224
224
  ```json
225
225
  {
@@ -253,12 +253,12 @@ questions: [
253
253
  ]
254
254
  ```
255
255
 
256
- Create `.planning/config.json` with the defaults above, applying the user's depth selection.
256
+ Create `.ariadna_planning/config.json` with the defaults above, applying the user's depth selection.
257
257
 
258
258
  **Commit config.json:**
259
259
 
260
260
  ```bash
261
- ariadna-tools commit "chore: add project config" --files .planning/config.json
261
+ ariadna-tools commit "chore: add project config" --files .ariadna_planning/config.json
262
262
  ```
263
263
 
264
264
  **Note:** Run `/ariadna:settings` anytime to update these preferences (research, model profile, parallelization, etc.).
@@ -293,7 +293,7 @@ Researching [domain] ecosystem...
293
293
 
294
294
  Create research directory:
295
295
  ```bash
296
- mkdir -p .planning/research
296
+ mkdir -p .ariadna_planning/research
297
297
  ```
298
298
 
299
299
  **Determine milestone context:**
@@ -349,7 +349,7 @@ Your STACK.md feeds into roadmap creation. Be prescriptive:
349
349
  </quality_gate>
350
350
 
351
351
  <output>
352
- Write to: .planning/research/STACK.md
352
+ Write to: .ariadna_planning/research/STACK.md
353
353
  Use template: ~/.claude/ariadna/templates/research-project/STACK.md
354
354
  </output>
355
355
  ", subagent_type="general-purpose", model="{researcher_model}", description="Stack research")
@@ -389,7 +389,7 @@ Your FEATURES.md feeds into requirements definition. Categorize clearly:
389
389
  </quality_gate>
390
390
 
391
391
  <output>
392
- Write to: .planning/research/FEATURES.md
392
+ Write to: .ariadna_planning/research/FEATURES.md
393
393
  Use template: ~/.claude/ariadna/templates/research-project/FEATURES.md
394
394
  </output>
395
395
  ", subagent_type="general-purpose", model="{researcher_model}", description="Features research")
@@ -429,7 +429,7 @@ Your ARCHITECTURE.md informs phase structure in roadmap. Include:
429
429
  </quality_gate>
430
430
 
431
431
  <output>
432
- Write to: .planning/research/ARCHITECTURE.md
432
+ Write to: .ariadna_planning/research/ARCHITECTURE.md
433
433
  Use template: ~/.claude/ariadna/templates/research-project/ARCHITECTURE.md
434
434
  </output>
435
435
  ", subagent_type="general-purpose", model="{researcher_model}", description="Architecture research")
@@ -469,7 +469,7 @@ Your PITFALLS.md prevents mistakes in roadmap/planning. For each pitfall:
469
469
  </quality_gate>
470
470
 
471
471
  <output>
472
- Write to: .planning/research/PITFALLS.md
472
+ Write to: .ariadna_planning/research/PITFALLS.md
473
473
  Use template: ~/.claude/ariadna/templates/research-project/PITFALLS.md
474
474
  </output>
475
475
  ", subagent_type="general-purpose", model="{researcher_model}", description="Pitfalls research")
@@ -485,14 +485,14 @@ Synthesize research outputs into SUMMARY.md.
485
485
 
486
486
  <research_files>
487
487
  Read these files:
488
- - .planning/research/STACK.md
489
- - .planning/research/FEATURES.md
490
- - .planning/research/ARCHITECTURE.md
491
- - .planning/research/PITFALLS.md
488
+ - .ariadna_planning/research/STACK.md
489
+ - .ariadna_planning/research/FEATURES.md
490
+ - .ariadna_planning/research/ARCHITECTURE.md
491
+ - .ariadna_planning/research/PITFALLS.md
492
492
  </research_files>
493
493
 
494
494
  <output>
495
- Write to: .planning/research/SUMMARY.md
495
+ Write to: .ariadna_planning/research/SUMMARY.md
496
496
  Use template: ~/.claude/ariadna/templates/research-project/SUMMARY.md
497
497
  Commit after writing.
498
498
  </output>
@@ -511,7 +511,7 @@ Display research complete banner and key findings:
511
511
  **Table Stakes:** [from SUMMARY.md]
512
512
  **Watch Out For:** [from SUMMARY.md]
513
513
 
514
- Files: `.planning/research/`
514
+ Files: `.ariadna_planning/research/`
515
515
  ```
516
516
 
517
517
  **If research not requested:** Continue to Step 7.
@@ -610,7 +610,7 @@ Cross-check requirements against Core Value from PROJECT.md. If gaps detected, s
610
610
 
611
611
  **Generate REQUIREMENTS.md:**
612
612
 
613
- Create `.planning/REQUIREMENTS.md` with:
613
+ Create `.ariadna_planning/REQUIREMENTS.md` with:
614
614
  - v1 Requirements grouped by category (checkboxes, REQ-IDs)
615
615
  - v2 Requirements (deferred)
616
616
  - Out of Scope (explicit exclusions with reasoning)
@@ -658,7 +658,7 @@ If "adjust": Return to scoping.
658
658
  **Commit requirements:**
659
659
 
660
660
  ```bash
661
- ariadna-tools commit "docs: define v1 requirements" --files .planning/REQUIREMENTS.md
661
+ ariadna-tools commit "docs: define v1 requirements" --files .ariadna_planning/REQUIREMENTS.md
662
662
  ```
663
663
 
664
664
  ## 8. Create Roadmap
@@ -679,19 +679,19 @@ Task(prompt="
679
679
  <planning_context>
680
680
 
681
681
  **Project:**
682
- @.planning/PROJECT.md
682
+ @.ariadna_planning/PROJECT.md
683
683
 
684
684
  **Requirements:**
685
- @.planning/REQUIREMENTS.md
685
+ @.ariadna_planning/REQUIREMENTS.md
686
686
 
687
687
  **Research (if exists):**
688
- @.planning/research/SUMMARY.md
688
+ @.ariadna_planning/research/SUMMARY.md
689
689
 
690
690
  **Rails Conventions (pre-loaded domain knowledge):**
691
691
  @~/.claude/ariadna/references/rails-conventions.md
692
692
 
693
693
  **Config:**
694
- @.planning/config.json
694
+ @.ariadna_planning/config.json
695
695
 
696
696
  </planning_context>
697
697
 
@@ -780,7 +780,7 @@ Use AskUserQuestion:
780
780
  User feedback on roadmap:
781
781
  [user's notes]
782
782
 
783
- Current ROADMAP.md: @.planning/ROADMAP.md
783
+ Current ROADMAP.md: @.ariadna_planning/ROADMAP.md
784
784
 
785
785
  Update the roadmap based on feedback. Edit files in place.
786
786
  Return ROADMAP REVISED with changes made.
@@ -790,12 +790,12 @@ Use AskUserQuestion:
790
790
  - Present revised roadmap
791
791
  - Loop until user approves
792
792
 
793
- **If "Review full file":** Display raw `cat .planning/ROADMAP.md`, then re-ask.
793
+ **If "Review full file":** Display raw `cat .ariadna_planning/ROADMAP.md`, then re-ask.
794
794
 
795
795
  **Commit roadmap (after approval or auto mode):**
796
796
 
797
797
  ```bash
798
- ariadna-tools commit "docs: create roadmap ([N] phases)" --files .planning/ROADMAP.md .planning/STATE.md .planning/REQUIREMENTS.md
798
+ ariadna-tools commit "docs: create roadmap ([N] phases)" --files .ariadna_planning/ROADMAP.md .ariadna_planning/STATE.md .ariadna_planning/REQUIREMENTS.md
799
799
  ```
800
800
 
801
801
  ## 9. Done
@@ -811,11 +811,11 @@ Present completion with next steps:
811
811
 
812
812
  | Artifact | Location |
813
813
  |----------------|-----------------------------|
814
- | Project | `.planning/PROJECT.md` |
815
- | Config | `.planning/config.json` |
816
- | Research | `.planning/research/` |
817
- | Requirements | `.planning/REQUIREMENTS.md` |
818
- | Roadmap | `.planning/ROADMAP.md` |
814
+ | Project | `.ariadna_planning/PROJECT.md` |
815
+ | Config | `.ariadna_planning/config.json` |
816
+ | Research | `.ariadna_planning/research/` |
817
+ | Requirements | `.ariadna_planning/REQUIREMENTS.md` |
818
+ | Roadmap | `.ariadna_planning/ROADMAP.md` |
819
819
 
820
820
  **[N] phases** | **[X] requirements** | Ready to build ✓
821
821
 
@@ -842,23 +842,23 @@ Present completion with next steps:
842
842
 
843
843
  <output>
844
844
 
845
- - `.planning/PROJECT.md`
846
- - `.planning/config.json`
847
- - `.planning/research/` (if research selected)
845
+ - `.ariadna_planning/PROJECT.md`
846
+ - `.ariadna_planning/config.json`
847
+ - `.ariadna_planning/research/` (if research selected)
848
848
  - `STACK.md`
849
849
  - `FEATURES.md`
850
850
  - `ARCHITECTURE.md`
851
851
  - `PITFALLS.md`
852
852
  - `SUMMARY.md`
853
- - `.planning/REQUIREMENTS.md`
854
- - `.planning/ROADMAP.md`
855
- - `.planning/STATE.md`
853
+ - `.ariadna_planning/REQUIREMENTS.md`
854
+ - `.ariadna_planning/ROADMAP.md`
855
+ - `.ariadna_planning/STATE.md`
856
856
 
857
857
  </output>
858
858
 
859
859
  <success_criteria>
860
860
 
861
- - [ ] .planning/ directory created
861
+ - [ ] .ariadna_planning/ directory created
862
862
  - [ ] Git repo initialized
863
863
  - [ ] Brownfield detection completed
864
864
  - [ ] Deep questioning completed (threads followed, not rushed)