@theglitchking/persistent-planning 2.0.0 → 3.0.1

package/templates/lg/notes.md

@@ -0,0 +1,40 @@
+---
+title: NOTES_TITLE_PLACEHOLDER
+tier: plan
+domains:
+  - planning
+status: active
+last_updated: "NOTES_DATE_PLACEHOLDER"
+plan_kind: notes
+scope: NOTES_SCOPE_PLACEHOLDER
+---
+
+# Notes: NOTES_TITLE_PLACEHOLDER
+
+**Scope**: `NOTES_SCOPE_PLACEHOLDER` (which phase / task this notes file is attached to)
+
+## Key Findings
+[Findings that emerged during plan implementation. Things that didn't fit cleanly into
+a task or atom but matter for context.]
+
+## Research Sources
+[External references, internal docs, conversations that informed decisions.]
+
+## Synthesized Findings
+[Patterns, themes, distilled understanding from the research.]
+
+## Decisions Made
+[Notes-level decisions that affect the parent task or phase. Promote to the parent's
+Decisions Made section if they have wider impact.]
+
+## Errors & Solutions
+[Errors encountered + how they were resolved. Useful for future similar work.]
+
+---
+
+## Append-Only Log
+[Chronological record of progress. Each entry is dated. Useful for handoff and
+reconstructing context after time away.]
+
+### NOTES_DATE_PLACEHOLDER — Initialized
+- Notes file created

package/templates/lg/phase.md

@@ -0,0 +1,42 @@
+---
+title: PHASE_TITLE_PLACEHOLDER
+tier: plan
+domains:
+  - planning
+status: draft
+last_updated: "PHASE_DATE_PLACEHOLDER"
+plan_kind: phase
+parent: null
+---
+
+# Phase: PHASE_TITLE_PLACEHOLDER
+
+## Goal
+[One sentence describing what this phase achieves and the strategic boundary it represents.]
+
+## Tasks
+[Tasks created with `/start-task --parent PHASE_SLUG_PLACEHOLDER` will be tracked here.
+Each task is a bounded deliverable. Tasks default to dependencies-first scheduling.
+Tasks with no inter-dependencies can be marked `parallelizable: true` in their frontmatter
+so subagent teams can pick them up concurrently.]
+
+- [ ] (no tasks yet — run `/start-task "Task name" --parent PHASE_SLUG_PLACEHOLDER`)
+
+## Decisions Made
+[Phase-level decisions that affect multiple tasks. Format: `**Decision**: rationale`.]
+
+## Status
+**Currently draft** — phase has been initialized but no tasks defined.
+
+Status enum: `draft | active | paused | done | archived`
+
+When all tasks are `done`, mark this phase `done`. When archived, this directory and
+its tasks/atoms move to `.planning/archive/PHASE_SLUG_PLACEHOLDER/`.
+
+---
+
+## Layer reference (lg mode)
+- **Phase** (this file): strategic grouping of related tasks
+- **Task** (`.planning/PHASE_SLUG_PLACEHOLDER/<task-slug>/task.md`): bounded deliverable
+- **Atom** (`.planning/PHASE_SLUG_PLACEHOLDER/<task-slug>/atoms/<atom-slug>.md`): subagent hand-off unit
+- **Notes** (`.planning/PHASE_SLUG_PLACEHOLDER/notes.md` or per-task `notes.md`): cross-cutting references

package/templates/lg/task.md

@@ -0,0 +1,54 @@
+---
+title: TASK_TITLE_PLACEHOLDER
+tier: plan
+domains:
+  - planning
+status: draft
+last_updated: "TASK_DATE_PLACEHOLDER"
+plan_kind: task
+parent: PHASE_SLUG_PLACEHOLDER
+depends_on: []
+parallelizable: false
+---
+
+# Task: TASK_TITLE_PLACEHOLDER
+
+**Phase**: `PHASE_SLUG_PLACEHOLDER`
+
+## Goal
+[One sentence describing the deliverable end-state for this task.]
+
+## Atoms
+[Atomic checkbox items that will be picked up by subagents. Each atom should be
+something a single subagent can complete in one focused pass.
+
+For complex atoms that need explicit subagent context, spawn a standalone atom file
+via `/start-atom "Atom name" --parent TASK_SLUG_PLACEHOLDER` — these become files
+under `atoms/` that subagents read via the planning MCP.
+
+Inline checkbox vs. standalone atom file — see anti-pattern doc:
+docs/atom-granularity.md.]
+
+- [ ] (no atoms yet — add inline checkboxes here for simple atoms,
+      or run `/start-atom "Atom name" --parent TASK_SLUG_PLACEHOLDER` for complex ones)
+
+## Decisions Made
+[Task-level decisions. Format: `**Decision**: rationale`.]
+
+## Status
+**Currently draft** — task has been initialized but no atoms defined.
+
+Status enum: `draft | active | paused | done | archived`
+
+## Dependencies
+This task does not currently depend on other tasks. Edit `depends_on:` in frontmatter
+to declare dependencies on other tasks within the same phase. Tasks with no
+inter-dependencies should set `parallelizable: true`.
+
+---
+
+## Layer reference
+- **Phase** (`../phase.md`): the strategic grouping this task belongs to
+- **This task**: the bounded deliverable
+- **Atoms** (`atoms/<atom-slug>.md`): subagent hand-off units (sequential within this task)
+- **Notes** (`notes.md`): cross-cutting references for this task's implementation