WORK-029
ID:WORK-029Status:done

plan init and plan create Commands

Priority:mediumComplexity:simpleSource:SPEC-022
changeset-release/main View source

Criteria completion

No incremental history — criteria tracking started on Apr 19.

Relationships

Implements 1
Related 2
Branches 3
changeset-release/main current done
main doneclaude/file-naming-convention-LJdwR doneclaude/align-sidenav-styling-4MuxV done
History 5
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. f262d7b
    Content editedby Claude
    Backfill source attributes on all 123 work items
  3. bae844c
    Content editedby Claude
    Implement `plan init` and `plan create` commands (WORK-029)
  4. ebe0c64
    Content editedby Claude
    Migrate plan files to {% ref %} xref syntax (WORK-021)
  5. 30b2ae0
    Created (done)by Claude
    Add 9 work items for SPEC-022 (Plan CLI) implementation

Summary

Scaffolding commands that create plan directories and template files. init sets up the full plan structure in a new project. create scaffolds individual plan items from templates. Neither command needs the scanner — they only write files.

Acceptance Criteria

  • plan init creates plan/work/, plan/spec/, plan/decision/ directories
  • plan init generates example files (work item, decision, spec) and starter index.md
  • plan init appends workflow section to CLAUDE.md (or creates one) including next/update/status commands
  • plan create work --id WORK-XXX --title "..." scaffolds a work item from template
  • plan create supports all 5 types: work, bug, decision, spec, milestone
  • Templates include all required sections per plan/CLAUDE.md structure
  • Tests for directory creation, file generation, and template rendering

Approach

Templates live in runes/plan/src/templates/ as string constants (not separate files). Each template is a function that accepts attributes and returns a Markdoc string. init calls create internally for its example files.

Dependencies

  • WORK-027 (plugin architecture — so commands can be registered)

References

  • SPEC-022 (Plan CLI)
  • plan/CLAUDE.md (required content structure)