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
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 926de51bbb2a1ecfe151263e631a8b56ad0d83cd2adb28c65dde071b3f04c1d3
|
|
4
|
+
data.tar.gz: dc451d582a82b2664f1f10095fa3324965852f1fd4241caddfe80175b2d22c73
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 6a21f498978a0e020900c8c2c84ed5d8396c3c2f541e66d0835e8982d8244fe7b0f3767905825ad9083438dc945c23897e189b5254176ef976fa83e22ea09091
|
|
7
|
+
data.tar.gz: 02b2b683e24525ee69f58cc54d57ef2aba13f70e0d4070fe2b0c7321a7dc7f34e85e37b9e371b7b773c3bf6c630f17efe6c5d08172e218937d3141c90263d561
|
|
@@ -47,11 +47,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `phase_dir`, `plans`, `
|
|
|
47
47
|
|
|
48
48
|
Also read STATE.md for position, decisions, blockers:
|
|
49
49
|
```bash
|
|
50
|
-
cat .
|
|
50
|
+
cat .ariadna_planning/STATE.md 2>/dev/null
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
If STATE.md missing but .
|
|
54
|
-
If .
|
|
53
|
+
If STATE.md missing but .ariadna_planning/ exists: offer to reconstruct or continue without.
|
|
54
|
+
If .ariadna_planning/ missing: Error — project not initialized.
|
|
55
55
|
</step>
|
|
56
56
|
|
|
57
57
|
<step name="load_plan">
|
|
@@ -168,7 +168,7 @@ git commit -m "{type}({phase}-{plan}): {concise task description}
|
|
|
168
168
|
</task_commit_protocol>
|
|
169
169
|
|
|
170
170
|
<summary_creation>
|
|
171
|
-
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.
|
|
171
|
+
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.ariadna_planning/phases/XX-name/`.
|
|
172
172
|
|
|
173
173
|
**Use template:** @~/.claude/ariadna/templates/summary.md
|
|
174
174
|
|
|
@@ -207,7 +207,7 @@ ariadna-tools state record-metric \
|
|
|
207
207
|
|
|
208
208
|
<final_commit>
|
|
209
209
|
```bash
|
|
210
|
-
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .
|
|
210
|
+
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .ariadna_planning/STATE.md
|
|
211
211
|
```
|
|
212
212
|
</final_commit>
|
|
213
213
|
|
|
@@ -6,7 +6,7 @@ color: cyan
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
9
|
-
You are an Ariadna codebase mapper. You explore a codebase for a specific focus area and write analysis documents directly to `.
|
|
9
|
+
You are an Ariadna codebase mapper. You explore a codebase for a specific focus area and write analysis documents directly to `.ariadna_planning/codebase/`.
|
|
10
10
|
|
|
11
11
|
You are spawned by `/ariadna:map-codebase` with one of four focus areas:
|
|
12
12
|
- **tech**: Analyze technology stack and external integrations → write STACK.md and INTEGRATIONS.md
|
|
@@ -135,7 +135,7 @@ Read key files identified during exploration. Use Glob and Grep liberally.
|
|
|
135
135
|
</step>
|
|
136
136
|
|
|
137
137
|
<step name="write_documents">
|
|
138
|
-
Write document(s) to `.
|
|
138
|
+
Write document(s) to `.ariadna_planning/codebase/` using the templates below.
|
|
139
139
|
|
|
140
140
|
**Document naming:** UPPERCASE.md (e.g., STACK.md, ARCHITECTURE.md)
|
|
141
141
|
|
|
@@ -157,8 +157,8 @@ Format:
|
|
|
157
157
|
|
|
158
158
|
**Focus:** {focus}
|
|
159
159
|
**Documents written:**
|
|
160
|
-
- `.
|
|
161
|
-
- `.
|
|
160
|
+
- `.ariadna_planning/codebase/{DOC1}.md` ({N} lines)
|
|
161
|
+
- `.ariadna_planning/codebase/{DOC2}.md` ({N} lines)
|
|
162
162
|
|
|
163
163
|
Ready for orchestrator summary.
|
|
164
164
|
```
|
|
@@ -754,7 +754,7 @@ Ready for orchestrator summary.
|
|
|
754
754
|
<success_criteria>
|
|
755
755
|
- [ ] Focus area parsed correctly
|
|
756
756
|
- [ ] Codebase explored thoroughly for focus area
|
|
757
|
-
- [ ] All documents for focus area written to `.
|
|
757
|
+
- [ ] All documents for focus area written to `.ariadna_planning/codebase/`
|
|
758
758
|
- [ ] Documents follow template structure
|
|
759
759
|
- [ ] File paths included throughout documents
|
|
760
760
|
- [ ] Confirmation returned (not document contents)
|
|
@@ -736,8 +736,8 @@ Can I observe the behavior directly?
|
|
|
736
736
|
## File Location
|
|
737
737
|
|
|
738
738
|
```
|
|
739
|
-
DEBUG_DIR=.
|
|
740
|
-
DEBUG_RESOLVED_DIR=.
|
|
739
|
+
DEBUG_DIR=.ariadna_planning/debug
|
|
740
|
+
DEBUG_RESOLVED_DIR=.ariadna_planning/debug/resolved
|
|
741
741
|
```
|
|
742
742
|
|
|
743
743
|
## File Structure
|
|
@@ -833,7 +833,7 @@ The file IS the debugging brain.
|
|
|
833
833
|
**First:** Check for active debug sessions.
|
|
834
834
|
|
|
835
835
|
```bash
|
|
836
|
-
ls .
|
|
836
|
+
ls .ariadna_planning/debug/*.md 2>/dev/null | grep -v resolved
|
|
837
837
|
```
|
|
838
838
|
|
|
839
839
|
**If active sessions exist AND no $ARGUMENTS:**
|
|
@@ -854,7 +854,7 @@ ls .planning/debug/*.md 2>/dev/null | grep -v resolved
|
|
|
854
854
|
**Create debug file IMMEDIATELY.**
|
|
855
855
|
|
|
856
856
|
1. Generate slug from user input (lowercase, hyphens, max 30 chars)
|
|
857
|
-
2. `mkdir -p .
|
|
857
|
+
2. `mkdir -p .ariadna_planning/debug`
|
|
858
858
|
3. Create file with initial state:
|
|
859
859
|
- status: gathering
|
|
860
860
|
- trigger: verbatim $ARGUMENTS
|
|
@@ -926,7 +926,7 @@ Return structured diagnosis:
|
|
|
926
926
|
```markdown
|
|
927
927
|
## ROOT CAUSE FOUND
|
|
928
928
|
|
|
929
|
-
**Debug Session:** .
|
|
929
|
+
**Debug Session:** .ariadna_planning/debug/{slug}.md
|
|
930
930
|
|
|
931
931
|
**Root Cause:** {from Resolution.root_cause}
|
|
932
932
|
|
|
@@ -945,7 +945,7 @@ If inconclusive:
|
|
|
945
945
|
```markdown
|
|
946
946
|
## INVESTIGATION INCONCLUSIVE
|
|
947
947
|
|
|
948
|
-
**Debug Session:** .
|
|
948
|
+
**Debug Session:** .ariadna_planning/debug/{slug}.md
|
|
949
949
|
|
|
950
950
|
**What Was Checked:**
|
|
951
951
|
- {area}: {finding}
|
|
@@ -982,8 +982,8 @@ Update status to "fixing".
|
|
|
982
982
|
Update status to "resolved".
|
|
983
983
|
|
|
984
984
|
```bash
|
|
985
|
-
mkdir -p .
|
|
986
|
-
mv .
|
|
985
|
+
mkdir -p .ariadna_planning/debug/resolved
|
|
986
|
+
mv .ariadna_planning/debug/{slug}.md .ariadna_planning/debug/resolved/
|
|
987
987
|
```
|
|
988
988
|
|
|
989
989
|
**Check planning config using state load (commit_docs is available from the output):**
|
|
@@ -1006,7 +1006,7 @@ Root cause: {root_cause}"
|
|
|
1006
1006
|
|
|
1007
1007
|
Then commit planning docs via CLI (respects `commit_docs` config automatically):
|
|
1008
1008
|
```bash
|
|
1009
|
-
ariadna-tools commit "docs: resolve debug {slug}" --files .
|
|
1009
|
+
ariadna-tools commit "docs: resolve debug {slug}" --files .ariadna_planning/debug/resolved/{slug}.md
|
|
1010
1010
|
```
|
|
1011
1011
|
|
|
1012
1012
|
Report completion and offer next steps.
|
|
@@ -1029,7 +1029,7 @@ Return a checkpoint when:
|
|
|
1029
1029
|
## CHECKPOINT REACHED
|
|
1030
1030
|
|
|
1031
1031
|
**Type:** [human-verify | human-action | decision]
|
|
1032
|
-
**Debug Session:** .
|
|
1032
|
+
**Debug Session:** .ariadna_planning/debug/{slug}.md
|
|
1033
1033
|
**Progress:** {evidence_count} evidence entries, {eliminated_count} hypotheses eliminated
|
|
1034
1034
|
|
|
1035
1035
|
### Investigation State
|
|
@@ -1100,7 +1100,7 @@ Orchestrator presents checkpoint to user, gets response, spawns fresh continuati
|
|
|
1100
1100
|
```markdown
|
|
1101
1101
|
## ROOT CAUSE FOUND
|
|
1102
1102
|
|
|
1103
|
-
**Debug Session:** .
|
|
1103
|
+
**Debug Session:** .ariadna_planning/debug/{slug}.md
|
|
1104
1104
|
|
|
1105
1105
|
**Root Cause:** {specific cause with evidence}
|
|
1106
1106
|
|
|
@@ -1121,7 +1121,7 @@ Orchestrator presents checkpoint to user, gets response, spawns fresh continuati
|
|
|
1121
1121
|
```markdown
|
|
1122
1122
|
## DEBUG COMPLETE
|
|
1123
1123
|
|
|
1124
|
-
**Debug Session:** .
|
|
1124
|
+
**Debug Session:** .ariadna_planning/debug/resolved/{slug}.md
|
|
1125
1125
|
|
|
1126
1126
|
**Root Cause:** {what was wrong}
|
|
1127
1127
|
**Fix Applied:** {what was changed}
|
|
@@ -1139,7 +1139,7 @@ Orchestrator presents checkpoint to user, gets response, spawns fresh continuati
|
|
|
1139
1139
|
```markdown
|
|
1140
1140
|
## INVESTIGATION INCONCLUSIVE
|
|
1141
1141
|
|
|
1142
|
-
**Debug Session:** .
|
|
1142
|
+
**Debug Session:** .ariadna_planning/debug/{slug}.md
|
|
1143
1143
|
|
|
1144
1144
|
**What Was Checked:**
|
|
1145
1145
|
- {area 1}: {finding}
|
|
@@ -26,11 +26,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `phase_dir`, `plans`, `
|
|
|
26
26
|
|
|
27
27
|
Also read STATE.md for position, decisions, blockers:
|
|
28
28
|
```bash
|
|
29
|
-
cat .
|
|
29
|
+
cat .ariadna_planning/STATE.md 2>/dev/null
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
If STATE.md missing but .
|
|
33
|
-
If .
|
|
32
|
+
If STATE.md missing but .ariadna_planning/ exists: offer to reconstruct or continue without.
|
|
33
|
+
If .ariadna_planning/ missing: Error — project not initialized.
|
|
34
34
|
</step>
|
|
35
35
|
|
|
36
36
|
<step name="load_plan">
|
|
@@ -272,7 +272,7 @@ git commit -m "{type}({phase}-{plan}): {concise task description}
|
|
|
272
272
|
</task_commit_protocol>
|
|
273
273
|
|
|
274
274
|
<summary_creation>
|
|
275
|
-
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.
|
|
275
|
+
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.ariadna_planning/phases/XX-name/`.
|
|
276
276
|
|
|
277
277
|
**Use template:** @~/.claude/ariadna/templates/summary.md
|
|
278
278
|
|
|
@@ -365,7 +365,7 @@ ariadna-tools state add-blocker "Blocker description"
|
|
|
365
365
|
|
|
366
366
|
<final_commit>
|
|
367
367
|
```bash
|
|
368
|
-
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .
|
|
368
|
+
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .ariadna_planning/STATE.md
|
|
369
369
|
```
|
|
370
370
|
|
|
371
371
|
Separate from per-task commits — captures execution results only.
|
|
@@ -46,11 +46,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `phase_dir`, `plans`, `
|
|
|
46
46
|
|
|
47
47
|
Also read STATE.md for position, decisions, blockers:
|
|
48
48
|
```bash
|
|
49
|
-
cat .
|
|
49
|
+
cat .ariadna_planning/STATE.md 2>/dev/null
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
If STATE.md missing but .
|
|
53
|
-
If .
|
|
52
|
+
If STATE.md missing but .ariadna_planning/ exists: offer to reconstruct or continue without.
|
|
53
|
+
If .ariadna_planning/ missing: Error — project not initialized.
|
|
54
54
|
</step>
|
|
55
55
|
|
|
56
56
|
<step name="load_plan">
|
|
@@ -166,7 +166,7 @@ git commit -m "{type}({phase}-{plan}): {concise task description}
|
|
|
166
166
|
</task_commit_protocol>
|
|
167
167
|
|
|
168
168
|
<summary_creation>
|
|
169
|
-
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.
|
|
169
|
+
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.ariadna_planning/phases/XX-name/`.
|
|
170
170
|
|
|
171
171
|
**Use template:** @~/.claude/ariadna/templates/summary.md
|
|
172
172
|
|
|
@@ -205,7 +205,7 @@ ariadna-tools state record-metric \
|
|
|
205
205
|
|
|
206
206
|
<final_commit>
|
|
207
207
|
```bash
|
|
208
|
-
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .
|
|
208
|
+
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .ariadna_planning/STATE.md
|
|
209
209
|
```
|
|
210
210
|
</final_commit>
|
|
211
211
|
|
|
@@ -57,7 +57,7 @@ For each phase, extract what it provides and what it should consume.
|
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
59
|
# Key modules and classes from each phase
|
|
60
|
-
for summary in .
|
|
60
|
+
for summary in .ariadna_planning/phases/*/*-SUMMARY.md; do
|
|
61
61
|
echo "=== $summary ==="
|
|
62
62
|
grep -A 10 "Key Files\|Exports\|Provides" "$summary" 2>/dev/null
|
|
63
63
|
done
|
|
@@ -177,7 +177,7 @@ Priority: Context7 > Official Docs > Official GitHub > Verified WebSearch > Unve
|
|
|
177
177
|
|
|
178
178
|
## RESEARCH.md Structure
|
|
179
179
|
|
|
180
|
-
**Location:** `.
|
|
180
|
+
**Location:** `.ariadna_planning/phases/XX-name/{phase}-RESEARCH.md`
|
|
181
181
|
|
|
182
182
|
```markdown
|
|
183
183
|
# Phase [X]: [Name] - Research
|
|
@@ -471,9 +471,9 @@ Output: [Artifacts created]
|
|
|
471
471
|
</execution_context>
|
|
472
472
|
|
|
473
473
|
<context>
|
|
474
|
-
@.
|
|
475
|
-
@.
|
|
476
|
-
@.
|
|
474
|
+
@.ariadna_planning/PROJECT.md
|
|
475
|
+
@.ariadna_planning/ROADMAP.md
|
|
476
|
+
@.ariadna_planning/STATE.md
|
|
477
477
|
|
|
478
478
|
# Only reference prior plan SUMMARYs if genuinely needed
|
|
479
479
|
@path/to/relevant/source.rb
|
|
@@ -500,7 +500,7 @@ Output: [Artifacts created]
|
|
|
500
500
|
</success_criteria>
|
|
501
501
|
|
|
502
502
|
<output>
|
|
503
|
-
After completion, create `.
|
|
503
|
+
After completion, create `.ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
|
|
504
504
|
</output>
|
|
505
505
|
```
|
|
506
506
|
|
|
@@ -853,7 +853,7 @@ Triggered when orchestrator provides `<revision_context>` with checker issues. N
|
|
|
853
853
|
### Step 1: Load Existing Plans
|
|
854
854
|
|
|
855
855
|
```bash
|
|
856
|
-
cat .
|
|
856
|
+
cat .ariadna_planning/phases/$PHASE-*/$PHASE-*-PLAN.md
|
|
857
857
|
```
|
|
858
858
|
|
|
859
859
|
Build mental model of current plan structure, existing tasks, must_haves.
|
|
@@ -901,7 +901,7 @@ Group by plan, dimension, severity.
|
|
|
901
901
|
### Step 6: Commit
|
|
902
902
|
|
|
903
903
|
```bash
|
|
904
|
-
ariadna-tools commit "fix($PHASE): revise plans based on checker feedback" --files .
|
|
904
|
+
ariadna-tools commit "fix($PHASE): revise plans based on checker feedback" --files .ariadna_planning/phases/$PHASE-*/$PHASE-*-PLAN.md
|
|
905
905
|
```
|
|
906
906
|
|
|
907
907
|
### Step 7: Return Revision Summary
|
|
@@ -920,8 +920,8 @@ ariadna-tools commit "fix($PHASE): revise plans based on checker feedback" --fil
|
|
|
920
920
|
|
|
921
921
|
### Files Updated
|
|
922
922
|
|
|
923
|
-
- .
|
|
924
|
-
- .
|
|
923
|
+
- .ariadna_planning/phases/16-xxx/16-01-PLAN.md
|
|
924
|
+
- .ariadna_planning/phases/16-xxx/16-02-PLAN.md
|
|
925
925
|
|
|
926
926
|
{If any issues NOT addressed:}
|
|
927
927
|
|
|
@@ -947,17 +947,17 @@ Extract from init JSON: `planner_model`, `researcher_model`, `checker_model`, `c
|
|
|
947
947
|
|
|
948
948
|
Also read STATE.md for position, decisions, blockers:
|
|
949
949
|
```bash
|
|
950
|
-
cat .
|
|
950
|
+
cat .ariadna_planning/STATE.md 2>/dev/null
|
|
951
951
|
```
|
|
952
952
|
|
|
953
|
-
If STATE.md missing but .
|
|
953
|
+
If STATE.md missing but .ariadna_planning/ exists, offer to reconstruct or continue without.
|
|
954
954
|
</step>
|
|
955
955
|
|
|
956
956
|
<step name="load_codebase_context">
|
|
957
957
|
Check for codebase map:
|
|
958
958
|
|
|
959
959
|
```bash
|
|
960
|
-
ls .
|
|
960
|
+
ls .ariadna_planning/codebase/*.md 2>/dev/null
|
|
961
961
|
```
|
|
962
962
|
|
|
963
963
|
If exists, load relevant documents by phase type:
|
|
@@ -976,8 +976,8 @@ If exists, load relevant documents by phase type:
|
|
|
976
976
|
|
|
977
977
|
<step name="identify_phase">
|
|
978
978
|
```bash
|
|
979
|
-
cat .
|
|
980
|
-
ls .
|
|
979
|
+
cat .ariadna_planning/ROADMAP.md
|
|
980
|
+
ls .ariadna_planning/phases/
|
|
981
981
|
```
|
|
982
982
|
|
|
983
983
|
If multiple phases available, ask which to plan. If obvious (first incomplete), proceed.
|
|
@@ -1011,7 +1011,7 @@ Select top 2-4 phases. Skip phases with no relevance signal.
|
|
|
1011
1011
|
|
|
1012
1012
|
**Step 3 — Read full SUMMARYs for selected phases:**
|
|
1013
1013
|
```bash
|
|
1014
|
-
cat .
|
|
1014
|
+
cat .ariadna_planning/phases/{selected-phase}/*-SUMMARY.md
|
|
1015
1015
|
```
|
|
1016
1016
|
|
|
1017
1017
|
From full SUMMARYs extract:
|
|
@@ -1103,7 +1103,7 @@ Present breakdown with wave structure. Wait for confirmation in interactive mode
|
|
|
1103
1103
|
<step name="write_phase_prompt">
|
|
1104
1104
|
Use template structure for each PLAN.md.
|
|
1105
1105
|
|
|
1106
|
-
Write to `.
|
|
1106
|
+
Write to `.ariadna_planning/phases/XX-name/{phase}-{NN}-PLAN.md`
|
|
1107
1107
|
|
|
1108
1108
|
Include all frontmatter fields.
|
|
1109
1109
|
</step>
|
|
@@ -1139,7 +1139,7 @@ Returns JSON: `{ valid, errors, warnings, task_count, tasks }`
|
|
|
1139
1139
|
<step name="update_roadmap">
|
|
1140
1140
|
Update ROADMAP.md to finalize phase placeholders:
|
|
1141
1141
|
|
|
1142
|
-
1. Read `.
|
|
1142
|
+
1. Read `.ariadna_planning/ROADMAP.md`
|
|
1143
1143
|
2. Find phase entry (`### Phase {N}:`)
|
|
1144
1144
|
3. Update placeholders:
|
|
1145
1145
|
|
|
@@ -1162,7 +1162,7 @@ Plans:
|
|
|
1162
1162
|
|
|
1163
1163
|
<step name="git_commit">
|
|
1164
1164
|
```bash
|
|
1165
|
-
ariadna-tools commit "docs($PHASE): create phase plan" --files .
|
|
1165
|
+
ariadna-tools commit "docs($PHASE): create phase plan" --files .ariadna_planning/phases/$PHASE-*/$PHASE-*-PLAN.md .ariadna_planning/ROADMAP.md
|
|
1166
1166
|
```
|
|
1167
1167
|
</step>
|
|
1168
1168
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ariadna-project-researcher
|
|
3
|
-
description: Researches domain ecosystem before roadmap creation. Produces files in .
|
|
3
|
+
description: Researches domain ecosystem before roadmap creation. Produces files in .ariadna_planning/research/ consumed during roadmap creation. Spawned by /ariadna:new-project or /ariadna:new-milestone orchestrators.
|
|
4
4
|
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
|
|
5
5
|
color: cyan
|
|
6
6
|
---
|
|
@@ -8,7 +8,7 @@ color: cyan
|
|
|
8
8
|
<role>
|
|
9
9
|
You are an Ariadna project researcher spawned by `/ariadna:new-project` or `/ariadna:new-milestone` (Phase 6: Research).
|
|
10
10
|
|
|
11
|
-
Answer "What does this domain ecosystem look like?" Write research files in `.
|
|
11
|
+
Answer "What does this domain ecosystem look like?" Write research files in `.ariadna_planning/research/` that inform roadmap creation.
|
|
12
12
|
|
|
13
13
|
Your files feed the roadmap:
|
|
14
14
|
|
|
@@ -167,7 +167,7 @@ Never present LOW confidence findings as authoritative.
|
|
|
167
167
|
|
|
168
168
|
<output_formats>
|
|
169
169
|
|
|
170
|
-
All files → `.
|
|
170
|
+
All files → `.ariadna_planning/research/`
|
|
171
171
|
|
|
172
172
|
## SUMMARY.md
|
|
173
173
|
|
|
@@ -515,7 +515,7 @@ Run pre-submission checklist (see verification_protocol).
|
|
|
515
515
|
|
|
516
516
|
## Step 5: Write Output Files
|
|
517
517
|
|
|
518
|
-
In `.
|
|
518
|
+
In `.ariadna_planning/research/`:
|
|
519
519
|
1. **SUMMARY.md** — Always
|
|
520
520
|
2. **STACK.md** — Always
|
|
521
521
|
3. **FEATURES.md** — Always
|
|
@@ -549,11 +549,11 @@ In `.planning/research/`:
|
|
|
549
549
|
|
|
550
550
|
| File | Purpose |
|
|
551
551
|
|------|---------|
|
|
552
|
-
| .
|
|
553
|
-
| .
|
|
554
|
-
| .
|
|
555
|
-
| .
|
|
556
|
-
| .
|
|
552
|
+
| .ariadna_planning/research/SUMMARY.md | Executive summary with roadmap implications |
|
|
553
|
+
| .ariadna_planning/research/STACK.md | Technology recommendations |
|
|
554
|
+
| .ariadna_planning/research/FEATURES.md | Feature landscape |
|
|
555
|
+
| .ariadna_planning/research/ARCHITECTURE.md | Architecture patterns |
|
|
556
|
+
| .ariadna_planning/research/PITFALLS.md | Domain pitfalls |
|
|
557
557
|
|
|
558
558
|
### Confidence Assessment
|
|
559
559
|
|
|
@@ -608,7 +608,7 @@ Research is complete when:
|
|
|
608
608
|
- [ ] Domain pitfalls catalogued
|
|
609
609
|
- [ ] Source hierarchy followed (Context7 → Official → WebSearch)
|
|
610
610
|
- [ ] All findings have confidence levels
|
|
611
|
-
- [ ] Output files created in `.
|
|
611
|
+
- [ ] Output files created in `.ariadna_planning/research/`
|
|
612
612
|
- [ ] SUMMARY.md includes roadmap implications
|
|
613
613
|
- [ ] Files written (DO NOT commit — orchestrator handles this)
|
|
614
614
|
- [ ] Structured return provided to orchestrator
|
|
@@ -44,10 +44,10 @@ Your SUMMARY.md is consumed by the ariadna-roadmapper agent which uses it to:
|
|
|
44
44
|
Read all 4 research files:
|
|
45
45
|
|
|
46
46
|
```bash
|
|
47
|
-
cat .
|
|
48
|
-
cat .
|
|
49
|
-
cat .
|
|
50
|
-
cat .
|
|
47
|
+
cat .ariadna_planning/research/STACK.md
|
|
48
|
+
cat .ariadna_planning/research/FEATURES.md
|
|
49
|
+
cat .ariadna_planning/research/ARCHITECTURE.md
|
|
50
|
+
cat .ariadna_planning/research/PITFALLS.md
|
|
51
51
|
|
|
52
52
|
# Planning config loaded via ariadna-tools in commit step
|
|
53
53
|
```
|
|
@@ -121,14 +121,14 @@ Identify gaps that couldn't be resolved and need attention during planning.
|
|
|
121
121
|
|
|
122
122
|
Use template: ~/.claude/ariadna/templates/research-project/SUMMARY.md
|
|
123
123
|
|
|
124
|
-
Write to `.
|
|
124
|
+
Write to `.ariadna_planning/research/SUMMARY.md`
|
|
125
125
|
|
|
126
126
|
## Step 7: Commit All Research
|
|
127
127
|
|
|
128
128
|
The 4 parallel researcher agents write files but do NOT commit. You commit everything together.
|
|
129
129
|
|
|
130
130
|
```bash
|
|
131
|
-
ariadna-tools commit "docs: complete project research" --files .
|
|
131
|
+
ariadna-tools commit "docs: complete project research" --files .ariadna_planning/research/
|
|
132
132
|
```
|
|
133
133
|
|
|
134
134
|
## Step 8: Return Summary
|
|
@@ -160,12 +160,12 @@ When SUMMARY.md is written and committed:
|
|
|
160
160
|
## SYNTHESIS COMPLETE
|
|
161
161
|
|
|
162
162
|
**Files synthesized:**
|
|
163
|
-
- .
|
|
164
|
-
- .
|
|
165
|
-
- .
|
|
166
|
-
- .
|
|
163
|
+
- .ariadna_planning/research/STACK.md
|
|
164
|
+
- .ariadna_planning/research/FEATURES.md
|
|
165
|
+
- .ariadna_planning/research/ARCHITECTURE.md
|
|
166
|
+
- .ariadna_planning/research/PITFALLS.md
|
|
167
167
|
|
|
168
|
-
**Output:** .
|
|
168
|
+
**Output:** .ariadna_planning/research/SUMMARY.md
|
|
169
169
|
|
|
170
170
|
### Executive Summary
|
|
171
171
|
|
|
@@ -446,11 +446,11 @@ When files are written and returning to orchestrator:
|
|
|
446
446
|
## ROADMAP CREATED
|
|
447
447
|
|
|
448
448
|
**Files written:**
|
|
449
|
-
- .
|
|
450
|
-
- .
|
|
449
|
+
- .ariadna_planning/ROADMAP.md
|
|
450
|
+
- .ariadna_planning/STATE.md
|
|
451
451
|
|
|
452
452
|
**Updated:**
|
|
453
|
-
- .
|
|
453
|
+
- .ariadna_planning/REQUIREMENTS.md (traceability section)
|
|
454
454
|
|
|
455
455
|
### Summary
|
|
456
456
|
|
|
@@ -476,8 +476,8 @@ When files are written and returning to orchestrator:
|
|
|
476
476
|
### Files Ready for Review
|
|
477
477
|
|
|
478
478
|
User can review actual files:
|
|
479
|
-
- `cat .
|
|
480
|
-
- `cat .
|
|
479
|
+
- `cat .ariadna_planning/ROADMAP.md`
|
|
480
|
+
- `cat .ariadna_planning/STATE.md`
|
|
481
481
|
|
|
482
482
|
{If gaps found during creation:}
|
|
483
483
|
|
|
@@ -500,9 +500,9 @@ After incorporating user feedback and updating files:
|
|
|
500
500
|
- {change 2}
|
|
501
501
|
|
|
502
502
|
**Files updated:**
|
|
503
|
-
- .
|
|
504
|
-
- .
|
|
505
|
-
- .
|
|
503
|
+
- .ariadna_planning/ROADMAP.md
|
|
504
|
+
- .ariadna_planning/STATE.md (if needed)
|
|
505
|
+
- .ariadna_planning/REQUIREMENTS.md (if traceability changed)
|
|
506
506
|
|
|
507
507
|
### Updated Summary
|
|
508
508
|
|
|
@@ -48,11 +48,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `phase_dir`, `plans`, `
|
|
|
48
48
|
|
|
49
49
|
Also read STATE.md for position, decisions, blockers:
|
|
50
50
|
```bash
|
|
51
|
-
cat .
|
|
51
|
+
cat .ariadna_planning/STATE.md 2>/dev/null
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
If STATE.md missing but .
|
|
55
|
-
If .
|
|
54
|
+
If STATE.md missing but .ariadna_planning/ exists: offer to reconstruct or continue without.
|
|
55
|
+
If .ariadna_planning/ missing: Error — project not initialized.
|
|
56
56
|
</step>
|
|
57
57
|
|
|
58
58
|
<step name="load_plan">
|
|
@@ -167,7 +167,7 @@ git commit -m "{type}({phase}-{plan}): {concise task description}
|
|
|
167
167
|
</task_commit_protocol>
|
|
168
168
|
|
|
169
169
|
<summary_creation>
|
|
170
|
-
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.
|
|
170
|
+
After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.ariadna_planning/phases/XX-name/`.
|
|
171
171
|
|
|
172
172
|
**Use template:** @~/.claude/ariadna/templates/summary.md
|
|
173
173
|
|
|
@@ -211,7 +211,7 @@ ariadna-tools state record-metric \
|
|
|
211
211
|
|
|
212
212
|
<final_commit>
|
|
213
213
|
```bash
|
|
214
|
-
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .
|
|
214
|
+
ariadna-tools commit "docs({phase}-{plan}): complete [plan-name] plan" --files .ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .ariadna_planning/STATE.md
|
|
215
215
|
```
|
|
216
216
|
</final_commit>
|
|
217
217
|
|
|
@@ -55,7 +55,7 @@ Set `is_re_verification = false`, proceed with Step 1.
|
|
|
55
55
|
ls "$PHASE_DIR"/*-PLAN.md 2>/dev/null
|
|
56
56
|
ls "$PHASE_DIR"/*-SUMMARY.md 2>/dev/null
|
|
57
57
|
ariadna-tools roadmap get-phase "$PHASE_NUM"
|
|
58
|
-
grep -E "^| $PHASE_NUM" .
|
|
58
|
+
grep -E "^| $PHASE_NUM" .ariadna_planning/REQUIREMENTS.md 2>/dev/null
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
Extract phase goal from ROADMAP.md — this is the outcome to verify, not the tasks.
|
|
@@ -231,7 +231,7 @@ Status: WIRED (associations + migration) | PARTIAL (model exists, no migration o
|
|
|
231
231
|
If REQUIREMENTS.md has requirements mapped to this phase:
|
|
232
232
|
|
|
233
233
|
```bash
|
|
234
|
-
grep -E "Phase $PHASE_NUM" .
|
|
234
|
+
grep -E "Phase $PHASE_NUM" .ariadna_planning/REQUIREMENTS.md 2>/dev/null
|
|
235
235
|
```
|
|
236
236
|
|
|
237
237
|
For each requirement: parse description → identify supporting truths/artifacts → determine status.
|
|
@@ -454,7 +454,7 @@ gaps:
|
|
|
454
454
|
|
|
455
455
|
## Create VERIFICATION.md
|
|
456
456
|
|
|
457
|
-
Create `.
|
|
457
|
+
Create `.ariadna_planning/phases/{phase_dir}/{phase}-VERIFICATION.md`:
|
|
458
458
|
|
|
459
459
|
```markdown
|
|
460
460
|
---
|
|
@@ -576,7 +576,7 @@ Return with:
|
|
|
576
576
|
|
|
577
577
|
**Status:** {passed | gaps_found | human_needed}
|
|
578
578
|
**Score:** {N}/{M} must-haves verified
|
|
579
|
-
**Report:** .
|
|
579
|
+
**Report:** .ariadna_planning/phases/{phase_dir}/{phase}-VERIFICATION.md
|
|
580
580
|
|
|
581
581
|
{If passed:}
|
|
582
582
|
All must-haves verified. Phase goal achieved. Ready to proceed.
|
|
@@ -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=".
|
|
61
|
+
PHASE_DIR=".ariadna_planning/phases/${DECIMAL_PHASE}-${SLUG}"
|
|
62
62
|
mkdir -p "$PHASE_DIR"
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
Example: `.
|
|
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 .
|
|
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: .
|
|
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 .
|
|
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 .
|
|
152
|
+
ariadna-tools commit "wip: [phase-name] paused at task [X]/[Y]" --files .ariadna_planning/
|
|
153
153
|
```
|
|
154
154
|
|
|
155
155
|
</format>
|