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.
- checksums.yaml +4 -4
- data/data/agents/ariadna-backend-executor.md +5 -5
- data/data/agents/ariadna-codebase-mapper.md +5 -5
- data/data/agents/ariadna-debugger.md +13 -13
- data/data/agents/ariadna-executor.md +5 -5
- data/data/agents/ariadna-frontend-executor.md +5 -5
- data/data/agents/ariadna-integration-checker.md +1 -1
- data/data/agents/ariadna-phase-researcher.md +1 -1
- data/data/agents/ariadna-planner.md +17 -17
- data/data/agents/ariadna-project-researcher.md +10 -10
- data/data/agents/ariadna-research-synthesizer.md +11 -11
- data/data/agents/ariadna-roadmapper.md +8 -8
- data/data/agents/ariadna-test-executor.md +5 -5
- data/data/agents/ariadna-verifier.md +4 -4
- data/data/ariadna/references/decimal-phase-calculation.md +2 -2
- data/data/ariadna/references/git-integration.md +4 -4
- data/data/ariadna/references/git-planning-commit.md +7 -7
- data/data/ariadna/references/model-profile-resolution.md +1 -1
- data/data/ariadna/references/model-profiles.md +2 -2
- data/data/ariadna/references/planning-config.md +13 -13
- data/data/ariadna/references/tdd.md +2 -2
- data/data/ariadna/templates/DEBUG.md +2 -2
- data/data/ariadna/templates/UAT.md +3 -3
- data/data/ariadna/templates/codebase/architecture.md +1 -1
- data/data/ariadna/templates/codebase/concerns.md +1 -1
- data/data/ariadna/templates/codebase/conventions.md +1 -1
- data/data/ariadna/templates/codebase/integrations.md +1 -1
- data/data/ariadna/templates/codebase/stack.md +1 -1
- data/data/ariadna/templates/codebase/structure.md +1 -1
- data/data/ariadna/templates/codebase/testing.md +1 -1
- data/data/ariadna/templates/context.md +2 -2
- data/data/ariadna/templates/continue-here.md +1 -1
- data/data/ariadna/templates/debug-subagent-prompt.md +2 -2
- data/data/ariadna/templates/discovery.md +2 -2
- data/data/ariadna/templates/milestone-archive.md +4 -4
- data/data/ariadna/templates/milestone.md +1 -1
- data/data/ariadna/templates/phase-prompt.md +19 -19
- data/data/ariadna/templates/planner-subagent-prompt.md +9 -9
- data/data/ariadna/templates/project.md +2 -2
- data/data/ariadna/templates/requirements.md +1 -1
- data/data/ariadna/templates/research-project/ARCHITECTURE.md +1 -1
- data/data/ariadna/templates/research-project/FEATURES.md +1 -1
- data/data/ariadna/templates/research-project/PITFALLS.md +1 -1
- data/data/ariadna/templates/research-project/STACK.md +1 -1
- data/data/ariadna/templates/research-project/SUMMARY.md +1 -1
- data/data/ariadna/templates/research.md +2 -2
- data/data/ariadna/templates/roadmap.md +1 -1
- data/data/ariadna/templates/state.md +4 -4
- data/data/ariadna/templates/summary.md +1 -1
- data/data/ariadna/templates/user-setup.md +2 -2
- data/data/ariadna/templates/verification-report.md +1 -1
- data/data/ariadna/workflows/add-phase.md +5 -5
- data/data/ariadna/workflows/add-todo.md +7 -7
- data/data/ariadna/workflows/audit-milestone.md +7 -7
- data/data/ariadna/workflows/check-todos.md +4 -4
- data/data/ariadna/workflows/complete-milestone.md +18 -18
- data/data/ariadna/workflows/diagnose-issues.md +4 -4
- data/data/ariadna/workflows/discovery-phase.md +4 -4
- data/data/ariadna/workflows/discuss-phase.md +2 -2
- data/data/ariadna/workflows/execute-phase.md +4 -4
- data/data/ariadna/workflows/execute-plan.md +19 -19
- data/data/ariadna/workflows/help.md +18 -18
- data/data/ariadna/workflows/insert-phase.md +6 -6
- data/data/ariadna/workflows/list-phase-assumptions.md +1 -1
- data/data/ariadna/workflows/map-codebase.md +22 -22
- data/data/ariadna/workflows/new-milestone.md +16 -16
- data/data/ariadna/workflows/new-project.md +39 -39
- data/data/ariadna/workflows/pause-work.md +4 -4
- data/data/ariadna/workflows/plan-milestone-gaps.md +4 -4
- data/data/ariadna/workflows/plan-phase.md +3 -3
- data/data/ariadna/workflows/progress.md +6 -6
- data/data/ariadna/workflows/quick.md +6 -6
- data/data/ariadna/workflows/remove-phase.md +3 -3
- data/data/ariadna/workflows/research-phase.md +4 -4
- data/data/ariadna/workflows/resume-project.md +9 -9
- data/data/ariadna/workflows/set-profile.md +2 -2
- data/data/ariadna/workflows/settings.md +4 -4
- data/data/ariadna/workflows/transition.md +11 -11
- data/data/ariadna/workflows/verify-phase.md +2 -2
- data/data/ariadna/workflows/verify-work.md +8 -8
- data/data/commands/ariadna/add-phase.md +2 -2
- data/data/commands/ariadna/add-todo.md +1 -1
- data/data/commands/ariadna/audit-milestone.md +6 -6
- data/data/commands/ariadna/check-todos.md +2 -2
- data/data/commands/ariadna/complete-milestone.md +11 -11
- data/data/commands/ariadna/debug.md +3 -3
- data/data/commands/ariadna/discuss-phase.md +2 -2
- data/data/commands/ariadna/execute-phase.md +2 -2
- data/data/commands/ariadna/insert-phase.md +2 -2
- data/data/commands/ariadna/list-phase-assumptions.md +2 -2
- data/data/commands/ariadna/map-codebase.md +7 -7
- data/data/commands/ariadna/new-milestone.md +10 -10
- data/data/commands/ariadna/new-project.md +6 -6
- data/data/commands/ariadna/pause-work.md +1 -1
- data/data/commands/ariadna/plan-milestone-gaps.md +5 -5
- data/data/commands/ariadna/quick.md +2 -2
- data/data/commands/ariadna/remove-phase.md +2 -2
- data/data/commands/ariadna/research-phase.md +6 -6
- data/data/commands/ariadna/verify-work.md +2 -2
- data/data/statusline/ariadna-statusline.sh +47 -0
- data/data/templates.md +1 -1
- data/exe/ariadna +2 -1
- data/lib/ariadna/installer.rb +30 -1
- data/lib/ariadna/tools/config_manager.rb +5 -5
- data/lib/ariadna/tools/git_integration.rb +2 -2
- data/lib/ariadna/tools/init.rb +61 -61
- data/lib/ariadna/tools/phase_manager.rb +11 -11
- data/lib/ariadna/tools/roadmap_analyzer.rb +5 -5
- data/lib/ariadna/tools/state_manager.rb +14 -14
- data/lib/ariadna/tools/template_filler.rb +5 -5
- data/lib/ariadna/tools/utilities.rb +4 -4
- data/lib/ariadna/tools/verification.rb +4 -4
- data/lib/ariadna/uninstaller.rb +17 -0
- data/lib/ariadna/version.rb +1 -1
- metadata +2 -1
|
@@ -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 `.
|
|
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 .
|
|
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 `.
|
|
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 `.
|
|
17
|
+
To fold `.ariadna_planning/` file changes into the previous commit:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
ariadna-tools commit "" --files .
|
|
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
|
-
- `.
|
|
38
|
-
- No changes to commit (check with `git status --porcelain .
|
|
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 .
|
|
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 .
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
36
|
-
- User must add `.
|
|
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 .
|
|
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 `.
|
|
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 .
|
|
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" .
|
|
71
|
-
- Broad searches skip gitignored: `rg "pattern"` skips `.
|
|
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 `.
|
|
75
|
-
- Only needed when searching entire repo and expecting `.
|
|
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
|
-
.
|
|
95
|
+
.ariadna_planning/
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
3. **Existing tracked files:** If `.
|
|
98
|
+
3. **Existing tracked files:** If `.ariadna_planning/` was previously tracked:
|
|
99
99
|
```bash
|
|
100
|
-
git rm -r --cached .
|
|
100
|
+
git rm -r --cached .ariadna_planning/
|
|
101
101
|
git commit -m "chore: stop tracking planning docs"
|
|
102
102
|
```
|
|
103
103
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Debug Template
|
|
2
2
|
|
|
3
|
-
Template for `.
|
|
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 .
|
|
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 `.
|
|
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: ".
|
|
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: ".
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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: `.
|
|
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
|
|
@@ -27,7 +27,7 @@ goal: {find_root_cause_only | find_and_fix}
|
|
|
27
27
|
</mode>
|
|
28
28
|
|
|
29
29
|
<debug_file>
|
|
30
|
-
Create: .
|
|
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: @.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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 .
|
|
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 `.
|
|
116
|
-
- Example: `.
|
|
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
|
|
|
@@ -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 `.
|
|
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
|
-
@.
|
|
50
|
-
@.
|
|
51
|
-
@.
|
|
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 `.
|
|
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
|
-
@.
|
|
252
|
-
@.
|
|
253
|
-
@.
|
|
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
|
-
@.
|
|
271
|
-
@.
|
|
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
|
-
@.
|
|
359
|
-
@.
|
|
360
|
-
@.
|
|
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 `.
|
|
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
|
-
@.
|
|
424
|
-
@.
|
|
425
|
-
@.
|
|
426
|
-
@.
|
|
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 `.
|
|
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
|
-
@.
|
|
16
|
+
@.ariadna_planning/STATE.md
|
|
17
17
|
|
|
18
18
|
**Roadmap:**
|
|
19
|
-
@.
|
|
19
|
+
@.ariadna_planning/ROADMAP.md
|
|
20
20
|
|
|
21
21
|
**Requirements (if exists):**
|
|
22
|
-
@.
|
|
22
|
+
@.ariadna_planning/REQUIREMENTS.md
|
|
23
23
|
|
|
24
24
|
**Phase Context (if exists):**
|
|
25
|
-
@.
|
|
25
|
+
@.ariadna_planning/phases/{phase_dir}/{phase}-CONTEXT.md
|
|
26
26
|
|
|
27
27
|
**Research (if exists):**
|
|
28
|
-
@.
|
|
28
|
+
@.ariadna_planning/phases/{phase_dir}/{phase}-RESEARCH.md
|
|
29
29
|
|
|
30
30
|
**Gap Closure (if --gaps mode):**
|
|
31
|
-
@.
|
|
32
|
-
@.
|
|
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: @.
|
|
102
|
-
Existing plans: @.
|
|
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 `.
|
|
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: .
|
|
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
|
# Architecture Research Template
|
|
2
2
|
|
|
3
|
-
Template for `.
|
|
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
|
# Research Summary Template
|
|
2
2
|
|
|
3
|
-
Template for `.
|
|
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 `.
|
|
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: `.
|
|
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
|
# State Template
|
|
2
2
|
|
|
3
|
-
Template for `.
|
|
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: .
|
|
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 .
|
|
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 .
|
|
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
|