plan

Prompt file imported from wuTims/glutton (.claude/commands/plan.md). Fill in {{arguments}} before use. Copyright stays with the author.

The user input to you can be provided directly by the agent or as a command argument - you MUST consider it before proceeding with the prompt (if not empty).

User input:

{{arguments}}

Given the implementation details provided as an argument, do this:

1. Run .specify/scripts/bash/setup-plan.sh --json from the repo root and parse JSON for FEATURE_SPEC, IMPL_PLAN, SPECS_DIR, BRANCH. All future file paths must be absolute.

   • BEFORE proceeding, inspect FEATURE_SPEC for a ## Clarifications section with at least one Session subheading. If missing or clearly ambiguous areas remain (vague adjectives, unresolved critical choices), PAUSE and instruct the user to run /clarify first to reduce rework. Only continue if: (a) Clarifications exist OR (b) an explicit user override is provided (e.g., "proceed without clarification"). Do not attempt to fabricate clarifications yourself.

2. Read and analyze the feature specification to understand:

   • The feature requirements and user stories
   • Functional and non-functional requirements
   • Success criteria and acceptance criteria
   • Any technical constraints or dependencies mentioned

3. Read the constitution at .specify/memory/constitution.md to understand constitutional requirements.

4. Execute the implementation plan template:

   • Load .specify/templates/plan-template.md (already copied to IMPL_PLAN path)
   • Set Input path to FEATURE_SPEC
   • Run the Execution Flow (main) function steps 1-9
   • The template is self-contained and executable
   • Follow error handling and gate checks as specified
   • Let the template guide artifact generation in $SPECS_DIR:
     • Phase 0 generates research.md (with library-usage-researcher agent invocations)
     • Phase 1 generates data-model.md, contracts/, quickstart.md
     • Phase 2 describes task generation approach (NOT executed in /plan)
   • Incorporate user-provided details from arguments into Technical Context: {{arguments}}
   • Update Progress Tracking as you complete each phase

   Phase 0 Library Research Process: For each external library or technical dependency in Technical Context: a. Check if library already documented in research.md (Tier 1: cached) b. Check if library has verified sources in .specify/memory/llms.md (Tier 2) c. If Tier 1 or Tier 2 inadequate, invoke library-usage-researcher agent:

   • Prompt: "Research [library name] v[version] usage for [specific feature requirement from spec.md]"
   • Include specific capabilities needed (e.g., "batch import", "error handling", "async operations")
   • Wait for response with code examples and API patterns
   • Validate research.md updated with library section d. Repeat for all libraries until research.md has comprehensive coverage e. Verify all NEEDS CLARIFICATION resolved before proceeding to Phase 1

5. Verify execution completed:

   • Check Progress Tracking shows all phases complete
   • Ensure all required artifacts were generated
   • Confirm no ERROR states in execution

6. Report results with branch name, file paths, and generated artifacts.

Use absolute paths with the repository root for all file operations to avoid path issues.