@dreki-gg/pi-plan-mode 0.23.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +48 -5
  3. package/bin/clean-plans.js +67 -49
  4. package/extensions/plan-mode/__tests__/initiative-readiness.test.ts +159 -0
  5. package/extensions/plan-mode/__tests__/initiative-status.test.ts +98 -0
  6. package/extensions/plan-mode/__tests__/initiatives-manifest.test.ts +89 -0
  7. package/extensions/plan-mode/__tests__/list-initiatives.test.ts +59 -0
  8. package/extensions/plan-mode/__tests__/reconcile.test.ts +38 -1
  9. package/extensions/plan-mode/__tests__/revise-plan.test.ts +38 -0
  10. package/extensions/plan-mode/__tests__/schema.test.ts +88 -0
  11. package/extensions/plan-mode/__tests__/submit-initiative.test.ts +58 -0
  12. package/extensions/plan-mode/__tests__/submit-plan.test.ts +97 -0
  13. package/extensions/plan-mode/__tests__/update-initiative.test.ts +72 -0
  14. package/extensions/plan-mode/commands/list-initiatives.ts +148 -0
  15. package/extensions/plan-mode/constants.ts +5 -0
  16. package/extensions/plan-mode/index.ts +22 -0
  17. package/extensions/plan-mode/initiative.ts +168 -0
  18. package/extensions/plan-mode/prompts.ts +4 -0
  19. package/extensions/plan-mode/reconcile.ts +65 -0
  20. package/extensions/plan-mode/schema.ts +28 -0
  21. package/extensions/plan-mode/storage/initiatives-manifest.ts +112 -0
  22. package/extensions/plan-mode/storage/plan-storage.ts +11 -0
  23. package/extensions/plan-mode/storage/plans-manifest.ts +16 -1
  24. package/extensions/plan-mode/tools/initiative-status.ts +191 -0
  25. package/extensions/plan-mode/tools/reconcile-plans.ts +33 -6
  26. package/extensions/plan-mode/tools/revise-plan.ts +22 -0
  27. package/extensions/plan-mode/tools/submit-initiative.ts +86 -0
  28. package/extensions/plan-mode/tools/submit-plan.ts +37 -4
  29. package/extensions/plan-mode/tools/update-initiative.ts +120 -0
  30. package/extensions/plan-mode/tools/update-plan.ts +3 -0
  31. package/extensions/plan-mode/types.ts +3 -0
  32. package/package.json +1 -1
  33. package/skills/planning-context/SKILL.md +11 -0
@@ -37,6 +37,17 @@ Caveman-lite: professional, tight, no filler. Bullet points over prose. Update i
37
37
 
38
38
  `context.md` is the input to `submit_plan`, not a duplicate of it. Before finalizing, re-read it: every open question resolved, every decision justified. The handoff is the distilled conclusion; `context.md` is the reasoning that earned it.
39
39
 
40
+ ## Large work: initiatives
41
+
42
+ When the work is too large for a single coherent execution session, or spans several
43
+ subsystems with dependencies between chunks, do not force it into one general plan. Create
44
+ an **initiative** (`submit_initiative`) and decompose the work into multiple plans, each
45
+ linked with `initiative` and ordered with `depends_on_plans`. The initiative's status is a
46
+ projection of its member plans; `initiative_status` shows which plans are *ready* (all
47
+ dependencies done) so work can be divided across sessions or subagents. Keep the
48
+ initiative-level deliberation (why this breakdown, the ordering, what each plan owns) in
49
+ the initiative's `INITIATIVE.md` overview; each member plan keeps its own `context.md`.
50
+
40
51
  ## Relationship to prototypes
41
52
 
42
53
  For visual/UI work, a prototype is the visual sibling of `context.md` — see the `visual-prototype` skill. Both are deliberation artifacts. Written reasoning lives here; visual reasoning lives in the prototype.