feat: add optional high-level technical design to plan-beta skills#322
Merged
Conversation
…epen-plan-beta User feedback indicated that seeing pseudo-code, DSL grammars, or architectural diagrams in plans helps reviewers validate the approach direction — without crossing into prescriptive implementation code that downstream agents take as gospel. Changes to ce-plan-beta: - Soften "decisions, not code" principle to allow pseudo-code/DSL sketches framed as directional guidance - Add Phase 3.4 "High-Level Technical Design" with a decision table for choosing the right medium (pseudo-code, mermaid, data flow, state diagram) - Add optional per-unit "Technical design" field for unit-level sketches - Update template with the new optional section and non-prescriptive framing - Clarify Standard/Deep depth guidance that optional sections should be omitted when they add no value Changes to deepen-plan-beta: - Add confidence gap checklists for technical design (when present and absent) - Add agent mapping for validating/strengthening technical design sections - Expand allowed changes to cover both top-level and per-unit technical design - Align guardrails to explicitly permit pseudo-code in both locations
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Technical plans are often valuable when they include pseudo-code, DSL grammars, or architectural diagrams in plans to validate the approach direction — without the plan crossing into prescriptive implementation code that downstream implementing agents take as gospel.
This PR adds optional "High-Level Technical Design" support at two levels:
Both levels carry explicit non-prescriptive framing: "This is directional guidance for review, not implementation specification."
Ultimately this paves a nice path to promote this to stable sometime soon.
Why this matters
There's a gap between "decisions, not code" (current plan-beta) and literal implementation code. Pseudo-code/DSL sketches sit in that gap — they let a reviewer say "yes, this direction is right" without dictating what the implementing agent should produce. The key concern driving the design: avoid specific code that the next implementation agent takes as gospel and reproduces verbatim.
Changes
ce-plan-beta:
deepen-plan-beta: