Skip to content

Releases: shihwesley/interactive-planning

interactive-planning 5.1.0

Choose a tag to compare

@shihwesley shihwesley released this 05 Mar 17:26

Added

  • Workflow contract (workflow.md): declarative execution config with YAML frontmatter for retry behavior, between-phase gates, progress enforcement, and Liquid-style prompt templates.
  • Handoff file (handoff.md): fixed-size inter-agent communication file (<150 lines) that phase runners read on start and overwrite on finish. Carries architecture decisions, last phase summary, and workspace state.
  • Progress log (progress-log.md): append-only session history with structured entries. Phase agents never read it; TLDR hook summarizes for humans.
  • Project type gate: Gate 1 now asks greenfield/brownfield/prototype.
  • Continuation prompts: retry logic passes attempt number and previous failure reason so agents don't restart from scratch.
  • Between-phase gates: configurable auto/manual/review modes in workflow.md.
  • Progress enforcement: strict/warn/none modes that validate handoff.md was updated.
  • Three new templates: workflow-template.md, handoff-template.md, progress-log-template.md.

Inspired by OpenAI Symphony workflow contract pattern.

All changes backward compatible — existing plans without workflow.md work as before.

interactive-planning 5.0.0

Choose a tag to compare

@shihwesley shihwesley released this 04 Mar 00:24

5.0.0 (2026-03-03)

Breaking Changes

  • Plan files now live in docs/plans/{category}/{name}/ instead of flat docs/plans/. Legacy flat-path plans are detected and resumable but not migrated automatically.
  • findings.md and progress.md moved inside the plan directory (no longer at project root).

Added

  • Categorized plan directories: 7 categories (general, feat, fix, refactor, review, test, polish) for multi-plan coexistence.
  • Auto-detection (Phase 0.5): Category and plan name inferred from user's request via keyword heuristics — no extra gate question.
  • Multi-plan session recovery: Phase 0 scans docs/plans/*/*/ and lists all active plans when multiple exist.
  • Targeted commands: resume feat/auth, status fix/login-crash, reset refactor/data-layer — operate on specific plans.
  • list subcommand: Table view of all active planning sessions with mode, category, and status.
  • PLAN_DIR variable: All file paths in SKILL.md are parameterized, no more hardcoded docs/plans/.

Changed

  • Session hook scans categorized directories recursively instead of checking fixed paths.
  • Manifest template includes category, plan_name, plan_dir in frontmatter.
  • Spec template includes plan field linking to its parent plan.
  • Planning advisor scans categorized directories and suggests category in output.

Upgrade Notes

Existing plans at docs/plans/manifest.md or task_plan.md at project root are still detected and resumable. No migration required — legacy plans work in-place. New plans will use the categorized structure.

Reinstall: claude plugins update shihwesley-plugins/interactive-planning