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
@@ -4,20 +4,20 @@ Commit planning artifacts using the ariadna-tools CLI, which automatically check
4
4
 
5
5
  ## Commit via CLI
6
6
 
7
- Always use `ariadna-tools commit` for `.planning/` files — it handles `commit_docs` and gitignore checks automatically:
7
+ Always use `ariadna-tools commit` for `.ariadna_planning/` files — it handles `commit_docs` and gitignore checks automatically:
8
8
 
9
9
  ```bash
10
- ariadna-tools commit "docs({scope}): {description}" --files .planning/STATE.md .planning/ROADMAP.md
10
+ ariadna-tools commit "docs({scope}): {description}" --files .ariadna_planning/STATE.md .ariadna_planning/ROADMAP.md
11
11
  ```
12
12
 
13
- The CLI will return `skipped` (with reason) if `commit_docs` is `false` or `.planning/` is gitignored. No manual conditional checks needed.
13
+ The CLI will return `skipped` (with reason) if `commit_docs` is `false` or `.ariadna_planning/` is gitignored. No manual conditional checks needed.
14
14
 
15
15
  ## Amend previous commit
16
16
 
17
- To fold `.planning/` file changes into the previous commit:
17
+ To fold `.ariadna_planning/` file changes into the previous commit:
18
18
 
19
19
  ```bash
20
- ariadna-tools commit "" --files .planning/codebase/*.md --amend
20
+ ariadna-tools commit "" --files .ariadna_planning/codebase/*.md --amend
21
21
  ```
22
22
 
23
23
  ## Commit Message Patterns
@@ -34,5 +34,5 @@ ariadna-tools commit "" --files .planning/codebase/*.md --amend
34
34
  ## When to Skip
35
35
 
36
36
  - `commit_docs: false` in config
37
- - `.planning/` is gitignored
38
- - No changes to commit (check with `git status --porcelain .planning/`)
37
+ - `.ariadna_planning/` is gitignored
38
+ - No changes to commit (check with `git status --porcelain .ariadna_planning/`)
@@ -5,7 +5,7 @@ Resolve model profile once at the start of orchestration, then use it for all Ta
5
5
  ## Resolution Pattern
6
6
 
7
7
  ```bash
8
- MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
8
+ MODEL_PROFILE=$(cat .ariadna_planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
9
9
  ```
10
10
 
11
11
  Default: `balanced` if not set or config missing.
@@ -41,7 +41,7 @@ Model profiles control which Claude model each Ariadna agent uses. This allows b
41
41
  Orchestrators resolve model before spawning:
42
42
 
43
43
  ```
44
- 1. Read .planning/config.json
44
+ 1. Read .ariadna_planning/config.json
45
45
  2. Get model_profile (default: "balanced")
46
46
  3. Look up agent in table above
47
47
  4. Pass model parameter to Task call
@@ -51,7 +51,7 @@ Orchestrators resolve model before spawning:
51
51
 
52
52
  Runtime: `/ariadna:set-profile <profile>`
53
53
 
54
- Per-project default: Set in `.planning/config.json`:
54
+ Per-project default: Set in `.ariadna_planning/config.json`:
55
55
  ```json
56
56
  {
57
57
  "model_profile": "balanced"
@@ -1,6 +1,6 @@
1
1
  <planning_config>
2
2
 
3
- Configuration options for `.planning/` directory behavior.
3
+ Configuration options for `.ariadna_planning/` directory behavior.
4
4
 
5
5
  <config_schema>
6
6
  ```json
@@ -32,15 +32,15 @@ Configuration options for `.planning/` directory behavior.
32
32
  - Full history of planning decisions preserved
33
33
 
34
34
  **When `commit_docs: false`:**
35
- - Skip all `git add`/`git commit` for `.planning/` files
36
- - User must add `.planning/` to `.gitignore`
35
+ - Skip all `git add`/`git commit` for `.ariadna_planning/` files
36
+ - User must add `.ariadna_planning/` to `.gitignore`
37
37
  - Useful for: OSS contributions, client projects, keeping planning private
38
38
 
39
39
  **Using ariadna-tools (preferred):**
40
40
 
41
41
  ```bash
42
42
  # Commit with automatic commit_docs + gitignore checks:
43
- ariadna-tools commit "docs: update state" --files .planning/STATE.md
43
+ ariadna-tools commit "docs: update state" --files .ariadna_planning/STATE.md
44
44
 
45
45
  # Load config via state load (returns JSON):
46
46
  INIT=$(ariadna-tools state load)
@@ -51,12 +51,12 @@ INIT=$(ariadna-tools init execute-phase "1")
51
51
  # commit_docs is included in all init command outputs
52
52
  ```
53
53
 
54
- **Auto-detection:** If `.planning/` is gitignored, `commit_docs` is automatically `false` regardless of config.json. This prevents git errors when users have `.planning/` in `.gitignore`.
54
+ **Auto-detection:** If `.ariadna_planning/` is gitignored, `commit_docs` is automatically `false` regardless of config.json. This prevents git errors when users have `.ariadna_planning/` in `.gitignore`.
55
55
 
56
56
  **Commit via CLI (handles checks automatically):**
57
57
 
58
58
  ```bash
59
- ariadna-tools commit "docs: update state" --files .planning/STATE.md
59
+ ariadna-tools commit "docs: update state" --files .ariadna_planning/STATE.md
60
60
  ```
61
61
 
62
62
  The CLI checks `commit_docs` config and gitignore status internally — no manual conditionals needed.
@@ -67,12 +67,12 @@ The CLI checks `commit_docs` config and gitignore status internally — no manua
67
67
 
68
68
  **When `search_gitignored: false` (default):**
69
69
  - Standard rg behavior (respects .gitignore)
70
- - Direct path searches work: `rg "pattern" .planning/` finds files
71
- - Broad searches skip gitignored: `rg "pattern"` skips `.planning/`
70
+ - Direct path searches work: `rg "pattern" .ariadna_planning/` finds files
71
+ - Broad searches skip gitignored: `rg "pattern"` skips `.ariadna_planning/`
72
72
 
73
73
  **When `search_gitignored: true`:**
74
- - Add `--no-ignore` to broad rg searches that should include `.planning/`
75
- - Only needed when searching entire repo and expecting `.planning/` matches
74
+ - Add `--no-ignore` to broad rg searches that should include `.ariadna_planning/`
75
+ - Only needed when searching entire repo and expecting `.ariadna_planning/` matches
76
76
 
77
77
  **Note:** Most Ariadna operations use direct file reads or explicit paths, which work regardless of gitignore status.
78
78
 
@@ -92,12 +92,12 @@ To use uncommitted mode:
92
92
 
93
93
  2. **Add to .gitignore:**
94
94
  ```
95
- .planning/
95
+ .ariadna_planning/
96
96
  ```
97
97
 
98
- 3. **Existing tracked files:** If `.planning/` was previously tracked:
98
+ 3. **Existing tracked files:** If `.ariadna_planning/` was previously tracked:
99
99
  ```bash
100
- git rm -r --cached .planning/
100
+ git rm -r --cached .ariadna_planning/
101
101
  git commit -m "chore: stop tracking planning docs"
102
102
  ```
103
103
 
@@ -50,8 +50,8 @@ Output: [Working, tested feature]
50
50
  </objective>
51
51
 
52
52
  <context>
53
- @.planning/PROJECT.md
54
- @.planning/ROADMAP.md
53
+ @.ariadna_planning/PROJECT.md
54
+ @.ariadna_planning/ROADMAP.md
55
55
  @relevant/source/files.rb
56
56
  </context>
57
57
 
@@ -1,6 +1,6 @@
1
1
  # Debug Template
2
2
 
3
- Template for `.planning/debug/[slug].md` — active debug session tracking.
3
+ Template for `.ariadna_planning/debug/[slug].md` — active debug session tracking.
4
4
 
5
5
  ---
6
6
 
@@ -129,7 +129,7 @@ files_changed: []
129
129
 
130
130
  **On resolution:**
131
131
  - status → "resolved"
132
- - Move file to .planning/debug/resolved/
132
+ - Move file to .ariadna_planning/debug/resolved/
133
133
 
134
134
  </lifecycle>
135
135
 
@@ -1,6 +1,6 @@
1
1
  # UAT Template
2
2
 
3
- Template for `.planning/phases/XX-name/{phase}-UAT.md` — persistent UAT session tracking.
3
+ Template for `.ariadna_planning/phases/XX-name/{phase}-UAT.md` — persistent UAT session tracking.
4
4
 
5
5
  ---
6
6
 
@@ -129,7 +129,7 @@ skipped: [N]
129
129
  issue: "after_commit not invalidating counter cache"
130
130
  missing:
131
131
  - "Add counter cache invalidation to after_commit callback"
132
- debug_session: ".planning/debug/comment-not-refreshing.md"
132
+ debug_session: ".ariadna_planning/debug/comment-not-refreshing.md"
133
133
  ```
134
134
 
135
135
  </diagnosis_lifecycle>
@@ -242,6 +242,6 @@ skipped: 0
242
242
  issue: "after_commit not invalidating counter cache"
243
243
  missing:
244
244
  - "Add counter cache invalidation to after_commit callback"
245
- debug_session: ".planning/debug/comment-not-refreshing.md"
245
+ debug_session: ".ariadna_planning/debug/comment-not-refreshing.md"
246
246
  ```
247
247
  </good_example>
@@ -1,6 +1,6 @@
1
1
  # Architecture Template
2
2
 
3
- Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code organization.
3
+ Template for `.ariadna_planning/codebase/ARCHITECTURE.md` - captures conceptual code organization.
4
4
 
5
5
  **Purpose:** Document how the code is organized at a conceptual level. Complements STRUCTURE.md (which shows physical file locations).
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Codebase Concerns Template
2
2
 
3
- Template for `.planning/codebase/CONCERNS.md` - captures known issues and areas requiring care.
3
+ Template for `.ariadna_planning/codebase/CONCERNS.md` - captures known issues and areas requiring care.
4
4
 
5
5
  **Purpose:** Surface actionable warnings about the codebase. Focused on "what to watch out for when making changes."
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Coding Conventions Template
2
2
 
3
- Template for `.planning/codebase/CONVENTIONS.md` - captures coding style and patterns.
3
+ Template for `.ariadna_planning/codebase/CONVENTIONS.md` - captures coding style and patterns.
4
4
 
5
5
  **Purpose:** Document how code is written in this codebase. Prescriptive guide for Claude to match existing style.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # External Integrations Template
2
2
 
3
- Template for `.planning/codebase/INTEGRATIONS.md` - captures external service dependencies.
3
+ Template for `.ariadna_planning/codebase/INTEGRATIONS.md` - captures external service dependencies.
4
4
 
5
5
  **Purpose:** Document what external systems this codebase communicates with. Focused on "what lives outside our code that we depend on."
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Technology Stack Template
2
2
 
3
- Template for `.planning/codebase/STACK.md` - captures the technology foundation.
3
+ Template for `.ariadna_planning/codebase/STACK.md` - captures the technology foundation.
4
4
 
5
5
  **Purpose:** Document what technologies run this codebase. Focused on "what executes when you run the code."
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Structure Template
2
2
 
3
- Template for `.planning/codebase/STRUCTURE.md` - captures physical file organization.
3
+ Template for `.ariadna_planning/codebase/STRUCTURE.md` - captures physical file organization.
4
4
 
5
5
  **Purpose:** Document where things physically live in the codebase. Answers "where do I put X?"
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Testing Patterns Template
2
2
 
3
- Template for `.planning/codebase/TESTING.md` - captures test framework and patterns.
3
+ Template for `.ariadna_planning/codebase/TESTING.md` - captures test framework and patterns.
4
4
 
5
5
  **Purpose:** Document how tests are written and run. Guide for adding tests that match existing patterns.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Phase Context Template
2
2
 
3
- Template for `.planning/phases/XX-name/{phase}-CONTEXT.md` - captures implementation decisions for a phase.
3
+ Template for `.ariadna_planning/phases/XX-name/{phase}-CONTEXT.md` - captures implementation decisions for a phase.
4
4
 
5
5
  **Purpose:** Document decisions that downstream agents need. Researcher uses this to know WHAT to investigate. Planner uses this to know WHAT choices are locked vs flexible.
6
6
 
@@ -276,7 +276,7 @@ The output should answer: "What does the researcher need to investigate? What ch
276
276
  - "Easy to use"
277
277
 
278
278
  **After creation:**
279
- - File lives in phase directory: `.planning/phases/XX-name/{phase}-CONTEXT.md`
279
+ - File lives in phase directory: `.ariadna_planning/phases/XX-name/{phase}-CONTEXT.md`
280
280
  - `ariadna-phase-researcher` uses decisions to focus investigation
281
281
  - `ariadna-planner` uses decisions + research to create executable tasks
282
282
  - Downstream agents should NOT need to ask the user again about captured decisions
@@ -1,6 +1,6 @@
1
1
  # Continue-Here Template
2
2
 
3
- Copy and fill this structure for `.planning/phases/XX-name/.continue-here.md`:
3
+ Copy and fill this structure for `.ariadna_planning/phases/XX-name/.continue-here.md`:
4
4
 
5
5
  ```yaml
6
6
  ---
@@ -27,7 +27,7 @@ goal: {find_root_cause_only | find_and_fix}
27
27
  </mode>
28
28
 
29
29
  <debug_file>
30
- Create: .planning/debug/{slug}.md
30
+ Create: .ariadna_planning/debug/{slug}.md
31
31
  </debug_file>
32
32
  ```
33
33
 
@@ -77,7 +77,7 @@ Continue debugging {slug}. Evidence is in the debug file.
77
77
  </objective>
78
78
 
79
79
  <prior_state>
80
- Debug file: @.planning/debug/{slug}.md
80
+ Debug file: @.ariadna_planning/debug/{slug}.md
81
81
  </prior_state>
82
82
 
83
83
  <checkpoint_response>
@@ -1,6 +1,6 @@
1
1
  # Discovery Template
2
2
 
3
- Template for `.planning/phases/XX-name/DISCOVERY.md` - shallow research for library/option decisions.
3
+ Template for `.ariadna_planning/phases/XX-name/DISCOVERY.md` - shallow research for library/option decisions.
4
4
 
5
5
  **Purpose:** Answer "which library/option should we use" questions during mandatory discovery in plan-phase.
6
6
 
@@ -71,7 +71,7 @@ Before completing discovery, verify:
71
71
 
72
72
 
73
73
  <output_structure>
74
- Create `.planning/phases/XX-name/DISCOVERY.md`:
74
+ Create `.ariadna_planning/phases/XX-name/DISCOVERY.md`:
75
75
 
76
76
  ```markdown
77
77
  # [Topic] Discovery
@@ -1,6 +1,6 @@
1
1
  # Milestone Archive Template
2
2
 
3
- This template is used by the complete-milestone workflow to create archive files in `.planning/milestones/`.
3
+ This template is used by the complete-milestone workflow to create archive files in `.ariadna_planning/milestones/`.
4
4
 
5
5
  ---
6
6
 
@@ -89,7 +89,7 @@ Plans:
89
89
 
90
90
  ---
91
91
 
92
- _For current project status, see .planning/ROADMAP.md_
92
+ _For current project status, see .ariadna_planning/ROADMAP.md_
93
93
 
94
94
  ---
95
95
 
@@ -112,8 +112,8 @@ _For current project status, see .planning/ROADMAP.md_
112
112
 
113
113
  **Archive location:**
114
114
 
115
- - Save to `.planning/milestones/v{VERSION}-{NAME}.md`
116
- - Example: `.planning/milestones/v1.0-mvp.md`
115
+ - Save to `.ariadna_planning/milestones/v{VERSION}-{NAME}.md`
116
+ - Example: `.ariadna_planning/milestones/v1.0-mvp.md`
117
117
 
118
118
  **After archiving:**
119
119
 
@@ -1,6 +1,6 @@
1
1
  # Milestone Entry Template
2
2
 
3
- Add this entry to `.planning/MILESTONES.md` when completing a milestone:
3
+ Add this entry to `.ariadna_planning/MILESTONES.md` when completing a milestone:
4
4
 
5
5
  ```markdown
6
6
  ## v[X.Y] [Name] (Shipped: YYYY-MM-DD)
@@ -3,7 +3,7 @@
3
3
  > **Note:** Planning methodology is in `agents/ariadna-planner.md`.
4
4
  > This template defines the PLAN.md output format that the agent produces.
5
5
 
6
- Template for `.planning/phases/XX-name/{phase}-{plan}-PLAN.md` - executable phase plans optimized for parallel execution.
6
+ Template for `.ariadna_planning/phases/XX-name/{phase}-{plan}-PLAN.md` - executable phase plans optimized for parallel execution.
7
7
 
8
8
  **Naming:** Use `{phase}-{plan}-PLAN.md` format (e.g., `01-02-PLAN.md` for Phase 1, Plan 2)
9
9
 
@@ -46,9 +46,9 @@ Output: [What artifacts will be created]
46
46
  </execution_context>
47
47
 
48
48
  <context>
49
- @.planning/PROJECT.md
50
- @.planning/ROADMAP.md
51
- @.planning/STATE.md
49
+ @.ariadna_planning/PROJECT.md
50
+ @.ariadna_planning/ROADMAP.md
51
+ @.ariadna_planning/STATE.md
52
52
 
53
53
  # Only reference prior plan SUMMARYs if genuinely needed:
54
54
  # - This plan uses types/exports from prior plan
@@ -114,7 +114,7 @@ Before declaring plan complete:
114
114
  </success_criteria>
115
115
 
116
116
  <output>
117
- After completion, create `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
117
+ After completion, create `.ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
118
118
  </output>
119
119
  ```
120
120
 
@@ -248,9 +248,9 @@ Backend plans run in Wave 1. Frontend and testing plans run in Wave 2 (parallel,
248
248
 
249
249
  ```markdown
250
250
  <context>
251
- @.planning/PROJECT.md
252
- @.planning/ROADMAP.md
253
- @.planning/STATE.md
251
+ @.ariadna_planning/PROJECT.md
252
+ @.ariadna_planning/ROADMAP.md
253
+ @.ariadna_planning/STATE.md
254
254
 
255
255
  # Only include SUMMARY refs if genuinely needed:
256
256
  # - This plan imports types from prior plan
@@ -267,8 +267,8 @@ Backend plans run in Wave 1. Frontend and testing plans run in Wave 2 (parallel,
267
267
  **Bad pattern (creates false dependencies):**
268
268
  ```markdown
269
269
  <context>
270
- @.planning/phases/03-features/03-01-SUMMARY.md # Just because it's earlier
271
- @.planning/phases/03-features/03-02-SUMMARY.md # Reflexive chaining
270
+ @.ariadna_planning/phases/03-features/03-01-SUMMARY.md # Just because it's earlier
271
+ @.ariadna_planning/phases/03-features/03-02-SUMMARY.md # Reflexive chaining
272
272
  </context>
273
273
  ```
274
274
 
@@ -355,9 +355,9 @@ Output: User model, controller, and view templates.
355
355
  </objective>
356
356
 
357
357
  <context>
358
- @.planning/PROJECT.md
359
- @.planning/ROADMAP.md
360
- @.planning/STATE.md
358
+ @.ariadna_planning/PROJECT.md
359
+ @.ariadna_planning/ROADMAP.md
360
+ @.ariadna_planning/STATE.md
361
361
  </context>
362
362
 
363
363
  <tasks>
@@ -389,7 +389,7 @@ Output: User model, controller, and view templates.
389
389
  </success_criteria>
390
390
 
391
391
  <output>
392
- After completion, create `.planning/phases/03-features/03-01-SUMMARY.md`
392
+ After completion, create `.ariadna_planning/phases/03-features/03-01-SUMMARY.md`
393
393
  </output>
394
394
  ```
395
395
 
@@ -420,10 +420,10 @@ Output: Working dashboard controller and view.
420
420
  </execution_context>
421
421
 
422
422
  <context>
423
- @.planning/PROJECT.md
424
- @.planning/ROADMAP.md
425
- @.planning/phases/03-features/03-01-SUMMARY.md
426
- @.planning/phases/03-features/03-02-SUMMARY.md
423
+ @.ariadna_planning/PROJECT.md
424
+ @.ariadna_planning/ROADMAP.md
425
+ @.ariadna_planning/phases/03-features/03-01-SUMMARY.md
426
+ @.ariadna_planning/phases/03-features/03-02-SUMMARY.md
427
427
  </context>
428
428
 
429
429
  <tasks>
@@ -460,7 +460,7 @@ Output: Working dashboard controller and view.
460
460
  </success_criteria>
461
461
 
462
462
  <output>
463
- After completion, create `.planning/phases/03-features/03-03-SUMMARY.md`
463
+ After completion, create `.ariadna_planning/phases/03-features/03-03-SUMMARY.md`
464
464
  </output>
465
465
  ```
466
466
 
@@ -13,23 +13,23 @@ Template for spawning ariadna-planner agent. The agent contains all planning exp
13
13
  **Mode:** {standard | gap_closure}
14
14
 
15
15
  **Project State:**
16
- @.planning/STATE.md
16
+ @.ariadna_planning/STATE.md
17
17
 
18
18
  **Roadmap:**
19
- @.planning/ROADMAP.md
19
+ @.ariadna_planning/ROADMAP.md
20
20
 
21
21
  **Requirements (if exists):**
22
- @.planning/REQUIREMENTS.md
22
+ @.ariadna_planning/REQUIREMENTS.md
23
23
 
24
24
  **Phase Context (if exists):**
25
- @.planning/phases/{phase_dir}/{phase}-CONTEXT.md
25
+ @.ariadna_planning/phases/{phase_dir}/{phase}-CONTEXT.md
26
26
 
27
27
  **Research (if exists):**
28
- @.planning/phases/{phase_dir}/{phase}-RESEARCH.md
28
+ @.ariadna_planning/phases/{phase_dir}/{phase}-RESEARCH.md
29
29
 
30
30
  **Gap Closure (if --gaps mode):**
31
- @.planning/phases/{phase_dir}/{phase}-VERIFICATION.md
32
- @.planning/phases/{phase_dir}/{phase}-UAT.md
31
+ @.ariadna_planning/phases/{phase_dir}/{phase}-VERIFICATION.md
32
+ @.ariadna_planning/phases/{phase_dir}/{phase}-UAT.md
33
33
 
34
34
  </planning_context>
35
35
 
@@ -98,8 +98,8 @@ Continue planning for Phase {phase_number}: {phase_name}
98
98
  </objective>
99
99
 
100
100
  <prior_state>
101
- Phase directory: @.planning/phases/{phase_dir}/
102
- Existing plans: @.planning/phases/{phase_dir}/*-PLAN.md
101
+ Phase directory: @.ariadna_planning/phases/{phase_dir}/
102
+ Existing plans: @.ariadna_planning/phases/{phase_dir}/*-PLAN.md
103
103
  </prior_state>
104
104
 
105
105
  <checkpoint_response>
@@ -1,6 +1,6 @@
1
1
  # PROJECT.md Template
2
2
 
3
- Template for `.planning/PROJECT.md` — the living project context document.
3
+ Template for `.ariadna_planning/PROJECT.md` — the living project context document.
4
4
 
5
5
  <template>
6
6
 
@@ -173,7 +173,7 @@ STATE.md references PROJECT.md:
173
173
  ```markdown
174
174
  ## Project Reference
175
175
 
176
- See: .planning/PROJECT.md (updated [date])
176
+ See: .ariadna_planning/PROJECT.md (updated [date])
177
177
 
178
178
  **Core value:** [One-liner from Core Value section]
179
179
  **Current focus:** [Current phase name]
@@ -1,6 +1,6 @@
1
1
  # Requirements Template
2
2
 
3
- Template for `.planning/REQUIREMENTS.md` — checkable requirements that define "done."
3
+ Template for `.ariadna_planning/REQUIREMENTS.md` — checkable requirements that define "done."
4
4
 
5
5
  <template>
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Architecture Research Template
2
2
 
3
- Template for `.planning/research/ARCHITECTURE.md` — Rails application architecture discovery for the project.
3
+ Template for `.ariadna_planning/research/ARCHITECTURE.md` — Rails application architecture discovery for the project.
4
4
 
5
5
  <template>
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Features Research Template
2
2
 
3
- Template for `.planning/research/FEATURES.md` — feature landscape for the project domain.
3
+ Template for `.ariadna_planning/research/FEATURES.md` — feature landscape for the project domain.
4
4
 
5
5
  <template>
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Pitfalls Research Template
2
2
 
3
- Template for `.planning/research/PITFALLS.md` — common mistakes to avoid in Ruby on Rails applications.
3
+ Template for `.ariadna_planning/research/PITFALLS.md` — common mistakes to avoid in Ruby on Rails applications.
4
4
 
5
5
  <template>
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Stack Research Template
2
2
 
3
- Template for `.planning/research/STACK.md` — discovered technology stack for the Rails project.
3
+ Template for `.ariadna_planning/research/STACK.md` — discovered technology stack for the Rails project.
4
4
 
5
5
  <template>
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Research Summary Template
2
2
 
3
- Template for `.planning/research/SUMMARY.md` — executive summary of project research with roadmap implications for Ruby on Rails applications.
3
+ Template for `.ariadna_planning/research/SUMMARY.md` — executive summary of project research with roadmap implications for Ruby on Rails applications.
4
4
 
5
5
  <template>
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Research Template
2
2
 
3
- Template for `.planning/phases/XX-name/{phase}-RESEARCH.md` - comprehensive ecosystem research before planning.
3
+ Template for `.ariadna_planning/phases/XX-name/{phase}-RESEARCH.md` - comprehensive ecosystem research before planning.
4
4
 
5
5
  **Purpose:** Document what Claude needs to know to implement a phase well - not just "which library" but "how do experts build this."
6
6
 
@@ -531,6 +531,6 @@ end
531
531
  - Code examples can be referenced in task actions
532
532
 
533
533
  **After creation:**
534
- - File lives in phase directory: `.planning/phases/XX-name/{phase}-RESEARCH.md`
534
+ - File lives in phase directory: `.ariadna_planning/phases/XX-name/{phase}-RESEARCH.md`
535
535
  - Referenced during planning workflow
536
536
  - plan-phase loads it automatically when present
@@ -1,6 +1,6 @@
1
1
  # Roadmap Template
2
2
 
3
- Template for `.planning/ROADMAP.md`.
3
+ Template for `.ariadna_planning/ROADMAP.md`.
4
4
 
5
5
  ## Initial Roadmap (v1.0 Greenfield)
6
6
 
@@ -1,6 +1,6 @@
1
1
  # State Template
2
2
 
3
- Template for `.planning/STATE.md` — the project's living memory.
3
+ Template for `.ariadna_planning/STATE.md` — the project's living memory.
4
4
 
5
5
  ---
6
6
 
@@ -11,7 +11,7 @@ Template for `.planning/STATE.md` — the project's living memory.
11
11
 
12
12
  ## Project Reference
13
13
 
14
- See: .planning/PROJECT.md (updated [date])
14
+ See: .ariadna_planning/PROJECT.md (updated [date])
15
15
 
16
16
  **Core value:** [One-liner from PROJECT.md Core Value section]
17
17
  **Current focus:** [Current phase name]
@@ -56,7 +56,7 @@ Recent decisions affecting current work:
56
56
 
57
57
  ### Pending Todos
58
58
 
59
- [From .planning/todos/pending/ — ideas captured during sessions]
59
+ [From .ariadna_planning/todos/pending/ — ideas captured during sessions]
60
60
 
61
61
  None yet.
62
62
 
@@ -147,7 +147,7 @@ Updated after each plan completion.
147
147
 
148
148
  **Pending Todos:** Ideas captured via /ariadna:add-todo
149
149
  - Count of pending todos
150
- - Reference to .planning/todos/pending/
150
+ - Reference to .ariadna_planning/todos/pending/
151
151
  - Brief list if few, count if many (e.g., "5 pending todos — see /ariadna:check-todos")
152
152
 
153
153
  **Blockers/Concerns:** From "Next Phase Readiness" sections
@@ -1,6 +1,6 @@
1
1
  # Summary Template
2
2
 
3
- Template for `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md` - phase completion documentation.
3
+ Template for `.ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md` - phase completion documentation.
4
4
 
5
5
  ---
6
6