Fix Plan

Schema and lifecycle management for fix_plan.md (Ralph convention) and checklist.md (non-Ralph workspaces). Vendor-agnostic — extracted from Ralph integration to be reusable across environments.

Topics

Topic Dependencies

fix-plan (schema + lifecycle)
  ├─→ format (entry — section structure + markers)
  ├─→ priority (new convention — BLOCKED P0-P3 + reason)
  ├─→ add (authoring)
  ├─→ move (completion → Completed)
  │     └─→ optional --rag=\x3Cskill>:\x3Ctopic> dispatch for semantic indexing (caller-supplied)
  ├─→ sync (GitHub state polling) — depends on github-flow gh CLI conventions
  └─→ issue-drafts (lifecycle of draft files)

• All topics are independently invocable
• move topic optionally dispatches to a RAG receiver if the caller supplies --rag=\x3Cskill>:\x3Ctopic> — generic skill stays vendor-agnostic; receiver implementation lives in the caller (e.g., ralph wrapper)
• sync topic uses gh CLI per github-flow skill's conventions

Configuration

Quick Reference

Schema (format)

# Fix Plan

## Progress

- [ ] {Action}
  - **Why**: {motivation}
  - **How to apply**: {procedure}
- [BLOCKED:P0:external] {Action} (awaiting X)
- [x] {Completed item — pending move}

## Completed

- 2026-06-07 12:00 — {one-line summary} (commit {sha}, PR #{N})

See format.md for full schema.

BLOCKED priority + reason (priority — NEW convention)

- [BLOCKED:P0:external] PR #45 user merge decision
- [BLOCKED:P1:selfable] consolidate Step 2.4 PR create (branch + body ready)
- [BLOCKED:P2:external] CodeRabbit re-review awaiting

• P0–P3: GitHub priority label-aligned (P0 highest)
• external: true external dependency
• selfable: progressable now (P-rank for immediate action)

See priority.md for full convention.

Add new item

- [ ] {one-sentence Action}
  - **Why**: {motivation 1-2 sentences}
  - **How to apply**: {procedure / tools / commands}

See add.md for length budget + deliverable separation.

Move to Completed

After [x] checked, summarize to one line + move to Completed section. See move.md.

Sync GitHub state

gh pr view \x3CN> --json state,mergedAt   # PR
gh issue view \x3CN> --json state,closedAt # Issue

MERGED PR or CLOSED issue → auto [x]. PR CLOSED-without-merge → [BLOCKED:P2:external]. See sync.md.

Issue Drafts lifecycle

issue-drafts/\x3Cslug>.md → gh issue create → archive to .bak/ → delete from fix_plan. See issue-drafts.md.

See Also

• github-flow (depends-on) — gh CLI conventions for sync + register
• Ralph integration is a separate workstream maintained outside this published skill. A Ralph wrapper, when present, owns Ralph-specific concerns: the ## REPEAT persistent-item section, autonomous-loop [BLOCKED] skip semantics, and the caller-side --rag=\x3Cskill>:\x3Ctopic> dispatch (this skill exposes only the abstract flag contract). See the Ralph project's documentation for wrapper details