From 6830f685d6cd9b0d8db11a40ca4b53950e2cdbab Mon Sep 17 00:00:00 2001 From: Justin Parker Date: Sun, 4 Oct 2026 18:44:23 -0700 Subject: [PATCH] Hoist the Phase Checklist and Parallel Execution Groups to directly under the Summary in Document's overview.md template, so the phases are found without scrolling AI Assisted --- CHANGELOG.md | 1 + skills/plan2code-2-document/SKILL.md | 5 +++-- src/plan2code-2-document.md | 5 +++-- 3 files changed, 7 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3c48898..d2b7a2d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -37,6 +37,7 @@ All notable changes to Plan2Code will be documented in this file. - **finalize**: `feedback-payload.mjs` counts the same phase files `specs.mjs` does, `submit` refuses an oversize URL when `gh` is unavailable (`oversize`), and a bare spec name present in both `specs/` and `specs--completed/` is refused as ambiguous. - Every script was checked against real specs and Pathfinder maps in other repositories and by four independent reviews; each issue found has a regression test. +- **document**: `overview.md` puts the Phase Checklist and Parallel Execution Groups directly under the Summary, ahead of the Tech Stack, Architecture, Risks and Success Criteria, so the phases are found without scrolling. Every script finds these sections by heading, so specs written in the old order keep working. - **install.js**: the closing message beside Planny now names the dashboard first: `plan2code` from any project, or `/plan2code` in your agent when the command could not be installed. The docs link moves to the line under it. - **web-console**: User Preferences opens from a gear button instead of the three swatches, and the default highlight color is now ocean blue instead of rust. - **web-console**: the dashboard rail marks the suggested next step with a small dot, since the center pane's Suggested pill can scroll out of view. Send pulses only while it is the primary button. diff --git a/skills/plan2code-2-document/SKILL.md b/skills/plan2code-2-document/SKILL.md index 5d6ba1c..6271945 100644 --- a/skills/plan2code-2-document/SKILL.md +++ b/skills/plan2code-2-document/SKILL.md @@ -107,11 +107,12 @@ Line numbers may only appear as SUPPLEMENTAL context alongside a semantic refere 5. **Use existing** `specs//` directory 6. **Write** `overview.md` first, copying from PLAN-DRAFT: - Summary (from Executive Summary) + - Phase Checklist (Implementation Phases), directly under Summary + - Parallel Execution Groups (filled in step 8) - Tech Stack table (exact copy) - Architecture Pattern and Component Overview (section 4) - Risks and Mitigations table (section 6) - Success Criteria (plain bullet list, no checkboxes) (section 7) - - Phase Checklist (Implementation Phases) - Quick Reference (Key Files, Environment Variables, External Dependencies) 7. **Write** each `phase-X.md` with detailed tasks — run the complexity check per task; split any that fail, combine adjacent trivial tasks 8. **Analyze** parallel execution eligibility @@ -187,7 +188,7 @@ Use kebab-case for feature name (e.g., `user-authentication`). Header: Title, Created date, Source (PLAN-DRAFT path), Status on its own line as `**Status:** ` (Not Started | In Progress | Complete). -Sections: Summary (from Executive Summary), Tech Stack table (exact copy from PLAN-DRAFT), Architecture (Pattern + Component Overview table), Risks and Mitigations table, Success Criteria checklist, Phase Checklist, Parallel Execution Groups table (from analysis), Quick Reference (Key Files, Environment Variables, External Dependencies), Completion Summary (filled during finalization). +Sections, in this order: Summary (from Executive Summary), Phase Checklist, Parallel Execution Groups table (from analysis), Tech Stack table (exact copy from PLAN-DRAFT), Architecture (Pattern + Component Overview table), Risks and Mitigations table, Success Criteria checklist, Quick Reference (Key Files, Environment Variables, External Dependencies), Completion Summary (filled during finalization). ### phase-X.md diff --git a/src/plan2code-2-document.md b/src/plan2code-2-document.md index 7c06c38..2ef4f73 100644 --- a/src/plan2code-2-document.md +++ b/src/plan2code-2-document.md @@ -101,11 +101,12 @@ Line numbers may only appear as SUPPLEMENTAL context alongside a semantic refere 5. **Use existing** `specs//` directory 6. **Write** `overview.md` first, copying from PLAN-DRAFT: - Summary (from Executive Summary) + - Phase Checklist (Implementation Phases), directly under Summary + - Parallel Execution Groups (filled in step 8) - Tech Stack table (exact copy) - Architecture Pattern and Component Overview (section 4) - Risks and Mitigations table (section 6) - Success Criteria (plain bullet list, no checkboxes) (section 7) - - Phase Checklist (Implementation Phases) - Quick Reference (Key Files, Environment Variables, External Dependencies) 7. **Write** each `phase-X.md` with detailed tasks — run the complexity check per task; split any that fail, combine adjacent trivial tasks 8. **Analyze** parallel execution eligibility @@ -181,7 +182,7 @@ Use kebab-case for feature name (e.g., `user-authentication`). Header: Title, Created date, Source (PLAN-DRAFT path), Status on its own line as `**Status:** ` (Not Started | In Progress | Complete). -Sections: Summary (from Executive Summary), Tech Stack table (exact copy from PLAN-DRAFT), Architecture (Pattern + Component Overview table), Risks and Mitigations table, Success Criteria checklist, Phase Checklist, Parallel Execution Groups table (from analysis), Quick Reference (Key Files, Environment Variables, External Dependencies), Completion Summary (filled during finalization). +Sections, in this order: Summary (from Executive Summary), Phase Checklist, Parallel Execution Groups table (from analysis), Tech Stack table (exact copy from PLAN-DRAFT), Architecture (Pattern + Component Overview table), Risks and Mitigations table, Success Criteria checklist, Quick Reference (Key Files, Environment Variables, External Dependencies), Completion Summary (filled during finalization). ### phase-X.md