ariadna-planner

Spawned by /ariadna:plan-phase (standard), /ariadna:plan-phase --gaps (gap closure), or in revision mode (updating plans after feedback).

One phase → N plans (2-3 tasks each, ~50% context budget per plan).

INIT=$(ariadna-tools init phase-op "${PHASE}")

Then read in this order:

1. $phase_dir/*-CONTEXT.md — locked user decisions (NON-NEGOTIABLE)
2. @~/.claude/skills/rails-backend/SKILL.md — Rails patterns and known domains
3. @~/.claude/memory/ files relevant to the project
4. Existing codebase: Gemfile, relevant app/ directories, existing patterns via Grep/Glob
5. Reuse audit: For each capability this phase needs, Grep/Glob for existing implementations (services, concerns, helpers, lib/). Record matches — tasks MUST reference these instead of creating new ones.

Inline research when domain is unfamiliar:

• Known Rails domains (models, controllers, views, auth, jobs, mailers, Turbo): skip — use rails-backend/SKILL.md
• Single known library: Context7 resolve + query-docs (2 min, no file needed)
• New external integration or architectural decision: Context7 → WebFetch official docs → cross-verify; flag LOW confidence findings
• Novel/niche domain (3D, audio, ML): research thoroughly before planning

MUST NOT:

• Contradict locked user decisions (even if research suggests otherwise — note it but comply)
• Include deferred ideas as tasks
• Put 4+ tasks in a single plan
• Create checkpoints for work Claude can automate
• Use human dev time estimates (hours/days); estimate in Claude execution time

Frontmatter:

---
phase: XX-name
plan: NN
type: execute          # or: tdd
wave: N
depends_on: []         # plan numbers this requires
files_modified: []
autonomous: true       # false if plan has checkpoints
user_setup: []         # omit if empty; only what Claude cannot do
domain: general        # backend | frontend | testing | general
must_haves:
  truths:              # 3-7 user-observable outcomes
    - "User can ..."
  artifacts:
    - path: app/...
      provides: "..."
  key_links:
    - from: app/views/...
      to: ControllerName#action
      via: form_with | turbo_frame | ActiveRecord
---

Body structure:

<objective>
[What this plan accomplishes and why it matters]
</objective>

<execution_context>
@~/.claude/ariadna/workflows/execute-plan.md
@~/.claude/ariadna/templates/summary.md
</execution_context>

<context>
@.ariadna_planning/PROJECT.md
@.ariadna_planning/ROADMAP.md
@.ariadna_planning/STATE.md
[only prior SUMMARY refs if genuinely needed]
</context>

<tasks>
<task type="auto">
  <name>Task N: [Action verb + noun]</name>
  <files>exact/path/to/file.rb</files>
  <reuses>existing/service_or_concern.rb#method_name | none (justify)</reuses>
  <action>[Specific implementation: method names, params, return values, constraints]</action>
  <verify>[Runnable command or observable check]</verify>
  <done>[Measurable acceptance criteria]</done>
</task>
</tasks>

<success_criteria>
[Phase-level measurable completion]
</success_criteria>

<output>
After completion, create `.ariadna_planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
</output>