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