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
@@ -58,8 +58,8 @@ Decimal phase directories use the full decimal number:
58
58
 
59
59
  ```bash
60
60
  SLUG=$(ariadna-tools generate-slug "$DESCRIPTION" --raw)
61
- PHASE_DIR=".planning/phases/${DECIMAL_PHASE}-${SLUG}"
61
+ PHASE_DIR=".ariadna_planning/phases/${DECIMAL_PHASE}-${SLUG}"
62
62
  mkdir -p "$PHASE_DIR"
63
63
  ```
64
64
 
65
- Example: `.planning/phases/06.1-fix-critical-auth-bug/`
65
+ Example: `.ariadna_planning/phases/06.1-fix-critical-auth-bug/`
@@ -51,7 +51,7 @@ Phases:
51
51
  What to commit:
52
52
 
53
53
  ```bash
54
- ariadna-tools commit "docs: initialize [project-name] ([N] phases)" --files .planning/
54
+ ariadna-tools commit "docs: initialize [project-name] ([N] phases)" --files .ariadna_planning/
55
55
  ```
56
56
 
57
57
  </format>
@@ -123,13 +123,13 @@ Tasks completed: [N]/[N]
123
123
  - [Task 2 name]
124
124
  - [Task 3 name]
125
125
 
126
- SUMMARY: .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md
126
+ SUMMARY: .ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md
127
127
  ```
128
128
 
129
129
  What to commit:
130
130
 
131
131
  ```bash
132
- ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .planning/phases/XX-name/{phase}-{plan}-PLAN.md .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .planning/STATE.md .planning/ROADMAP.md
132
+ ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .ariadna_planning/phases/XX-name/{phase}-{plan}-PLAN.md .ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .ariadna_planning/STATE.md .ariadna_planning/ROADMAP.md
133
133
  ```
134
134
 
135
135
  **Note:** Code files NOT included - already committed per-task.
@@ -149,7 +149,7 @@ Current: [task name]
149
149
  What to commit:
150
150
 
151
151
  ```bash
152
- ariadna-tools commit "wip: [phase-name] paused at task [X]/[Y]" --files .planning/
152
+ ariadna-tools commit "wip: [phase-name] paused at task [X]/[Y]" --files .ariadna_planning/
153
153
  ```
154
154
 
155
155
  </format>
@@ -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
 
@@ -216,6 +216,7 @@ class UserTest < ActiveSupport::TestCase
216
216
 
217
217
  test "validates email presence" do
218
218
  user = User.new(name: "Test")
219
+
219
220
  assert_not user.valid?
220
221
  assert_includes user.errors[:email], "can't be blank"
221
222
  end
@@ -238,6 +239,7 @@ class PostsControllerTest < ActionDispatch::IntegrationTest
238
239
 
239
240
  test "index returns posts" do
240
241
  get posts_url
242
+
241
243
  assert_response :success
242
244
  assert_select "h2", posts(:first).title
243
245
  end
@@ -341,11 +343,16 @@ Tasks:
341
343
  ### Add Turbo/Hotwire Feature
342
344
  ```
343
345
  Tasks:
344
- 1. Add Turbo Frame wrapping + controller turbo_stream response
346
+ 1. Add Turbo Frame wrapping to target views + controller turbo_stream responses
345
347
  Files: app/views/[model]/*.html.erb, app/controllers/[model]_controller.rb
348
+ Conventions: 422 for validation errors, 303 for redirects, dom_id for frame IDs
346
349
  2. Add Stimulus controller (if interactive behavior needed)
347
350
  Files: app/javascript/controllers/[name]_controller.js
348
- 3. Add system test for real-time behavior
351
+ Conventions: static values/targets/outlets first, connect/disconnect symmetry
352
+ 3. Add Turbo Stream broadcasts (if real-time updates needed)
353
+ Files: app/models/[model].rb (after_create_commit callbacks)
354
+ Conventions: prefer default stream actions, broadcast_append_to/replace_to
355
+ 4. Add system test for Turbo/Stimulus behavior
349
356
  Files: test/system/[feature]_test.rb
350
357
  ```
351
358
 
@@ -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