Imported from tiagoluizpoli/luna-ai-skills (.agents/skills/luna-ai/luna-to-issues/SKILL.md). Install upstream with npx skills add tiagoluizpoli/luna-ai-skills --skill luna-to-issues. Copyright stays with the author.

Luna To Issues

Convert a plan or PRD into the project's .plan epic and task structure.

This skill wraps to-issues for decomposition, but writes the approved output into the Ralph Loop execution tree instead of a generic issue tracker.

Output Structure

.plan/
├── index.md
├── PRD.md
├── prds/
├── epics/
│   └── <num>-<slug>/
│       ├── epic.md
│       └── tasks/
│           └── <num>-<slug>.md
└── shared/
    ├── epic-template.md
    └── task-template.md

Contract

• Resolve the current PRD from .plan/PRD.md before decomposition.
• Resolve the current PRD source in this order:
  • explicit user-provided PRD handoff or PRD file
  • .plan/handoffs/.current-prd-handoff via .plan/helper-scripts/get-current-prd-handoff.sh
  • .plan/prds/.current-prd via .plan/helper-scripts/get-current-prd.sh
  • CURRENT row in .plan/PRD.md as the final fallback
• Load the full PRD body from the resolved canonical PRD file.
• Use to-issues first for the vertical slice breakdown.
• Only write .plan files after the user approves the slice structure.
• Create one epic directory per approved epic.
• Create one task file per approved slice.
• Emit task-level default-model.
• Emit sub-task-level status, model, escalate-if, blocked-by, what-to-do, files-to-touch, and verification.
• Use medium as the default model unless the slice clearly justifies high.
• If you are uncertain about escalation tier, default to medium.

Index Synchronization

After writing or updating epic/task files:

1. update the epic's task table
2. update .plan/index.md
3. keep IDs stable

The canonical atomic execution state lives in sub-task entries inside task files. Epic and task aggregate state is derived later by helper scripts.

Naming

Epic naming

• Directory: <num>-<kebab-case-slug>/
• Epic file: epic.md
• Epic ID: E-<num>

Task naming

• File: <num>-<kebab-case-slug>.md
• Task ID: T-<num>
• Sub-task IDs: ST-01, ST-02, ...

PRD Rules

• Treat .plan/PRD.md as the thin index.
• Treat .plan/prds/*.md as the full versioned PRD bodies.
• Only one PRD row may be marked CURRENT.
• Use the PRD handoff pointer and PRD pointer before falling back to the CURRENT row.
• Load the full PRD body from the resolved canonical source path.
• Do not inline the full PRD into .plan/PRD.md.

Templates

• Use .plan/shared/epic-template.md for new epic files.
• Use .plan/shared/task-template.md for new task files.

References

• PRD Merging
• Task Schema