Skip to content

feat: add ce:plan-beta and deepen-plan-beta skills#272

Merged
tmchow merged 12 commits intomainfrom
feat/ce-plan-rewrite-brainstorm
Mar 17, 2026
Merged

feat: add ce:plan-beta and deepen-plan-beta skills#272
tmchow merged 12 commits intomainfrom
feat/ce-plan-rewrite-brainstorm

Conversation

@tmchow
Copy link
Collaborator

@tmchow tmchow commented Mar 15, 2026

Summary

This PR rethinks how the planning stack produces plans. The core insight: planning should spend effort on decisions the execution agent cannot safely infer on its own, and stop spending effort on speculative implementation details the agent will derive better from the live codebase.

In practice that means:

  • Plans capture requirements trace, boundaries, sequencing, file targets, patterns, risks, and verification
  • Plans stop pre-writing code, exact shell commands, or micro-step choreography
  • Execution is left to ce:work, where the model has direct access to the repo and can adapt

This is not lighter planning. It is higher-leverage planning: less stale pseudo-implementation, more durable guidance for capable downstream agents.

Shipped as beta skills

The new planning workflow ships as separate beta skills (ce:plan-beta and deepen-plan-beta) alongside the unchanged stable versions. This lets users trial the new approach without disrupting existing workflows.

skills/
├── ce-plan/SKILL.md           # Stable (unchanged)
├── ce-plan-beta/SKILL.md      # New decision-first planning
├── deepen-plan/SKILL.md       # Stable (unchanged)
└── deepen-plan-beta/SKILL.md  # New selective stress test

Usage: Invoke /ce:plan-beta or /deepen-plan-beta directly. Beta plan files use a -beta-plan.md suffix so both stable and beta outputs coexist in docs/plans/ for side-by-side comparison.

Tradeoffs: Beta skills are standalone — ce:brainstorm won't auto-handoff to them, and lfg/slfg orchestration continues using stable skills. This is intentional: simplicity over seamless integration during the trial period. Users compare outputs by running both versions on the same input.

Promotion path: When validated, replace stable skill content with beta, remove -beta naming, delete beta directories. See docs/solutions/skill-design/beta-skills-framework.md and the AGENTS.md promotion checklist.

What changed

ce:plan-beta

  • Rewrote the workflow around planning phases, requirements trace, implementation units, verification, and explicit defer-to-implementation boundaries
  • Kept the strong parts: origin-doc carry-forward, repo/learnings research, conditional external research, Proof/tracker handoff
  • Removed issue-template boilerplate, embedded code examples, exact shell recipes, and over-prescriptive implementation choreography

deepen-plan-beta

  • Rewrote from "run lots of agents and add implementation detail" to "identify weak sections, run targeted research, and strengthen only those sections"
  • Made deepening conditional and confidence-driven
  • Aligned boundaries with ce:plan-beta so it no longer regresses into code blocks or generic padding

ce:work (updated, not beta)

  • Updated execution guidance to consume the new plan format directly
  • Added awareness of deferred questions, scope boundaries, per-unit patterns, and verification
  • Tightened final validation around requirements trace and plan coverage

Workflow cleanup

  • lfg/slfg now run deepen-plan only when the plan is risky, deep, or under-grounded
  • Question handling names platform-specific blocking question tools
  • Handoff wording cleaned up to reduce Claude-specific assumptions

Documentation

  • Added beta skills framework pattern to docs/solutions/skill-design/
  • Added Beta Skills section and promotion checklist to AGENTS.md
  • Added Beta Skills section to README.md

Test plan

  • Run /ce:plan — verify stable behavior unchanged
  • Run /ce:plan-beta — verify new decision-first planning workflow
  • Run /ce:plan-beta then /deepen-plan-beta on the output
  • Run /ce:work on a plan from /ce:plan-beta — verify compatibility
  • Compare /ce:plan and /ce:plan-beta output on the same input
  • Verify lfg/slfg still use stable skills and work normally

@tmchow tmchow changed the base branch from main to tmchow/brainstorming-cross-platform-adaptive-flow March 15, 2026 02:08
@tmchow tmchow force-pushed the tmchow/brainstorming-cross-platform-adaptive-flow branch from f0168d7 to 4d80a59 Compare March 15, 2026 02:09
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch from 440b086 to f71d034 Compare March 15, 2026 02:09
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch 3 times, most recently from 68d280b to d47cd76 Compare March 15, 2026 21:27
@tmchow tmchow marked this pull request as ready for review March 15, 2026 21:32
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch 2 times, most recently from 1752460 to f2a3dd6 Compare March 16, 2026 00:58
@tmchow tmchow changed the base branch from tmchow/brainstorming-cross-platform-adaptive-flow to main March 16, 2026 23:43
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch 2 times, most recently from 8142968 to dd21e47 Compare March 17, 2026 07:29
@tmchow tmchow changed the title feat: rewrite ce:plan to separate planning from implementation feat: beta-gated rewrite of ce:plan and deepen-plan Mar 17, 2026
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch 2 times, most recently from dca2f79 to e134ad9 Compare March 17, 2026 16:23
@tmchow tmchow changed the title feat: beta-gated rewrite of ce:plan and deepen-plan feat: add ce:plan-beta and deepen-plan-beta skills Mar 17, 2026
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch from fa2a5f5 to 16fb93a Compare March 17, 2026 16:33
tmchow added 11 commits March 17, 2026 10:32
Captures the requirements, decisions, and scope boundaries for
rewriting ce:plan to separate planning from implementation.
Restructures ce:plan around a decisions-first philosophy:
- Replace issue-template output with durable implementation plans
- Add blocker classification gate for upstream requirements (R11-R13)
- Replace MINIMAL/MORE/A LOT with Lightweight/Standard/Deep
- Add planning bootstrap fallback with ce:brainstorm recommendation
- Remove all implementation code, shell commands, and executor litter
- Make SpecFlow conditional for Standard/Deep plans
- Keep research agents, brainstorm-origin integration, and handoff options
- Restore origin doc completeness checks, user signal gathering,
  research decision examples, filename examples, stakeholder awareness,
  and mermaid diagram nudges from the old skill
- Surface deferred implementation questions and scope boundaries
- Use per-unit Patterns and Verification fields for task execution
- Add execution strategy: inline, serial subagents, or parallel
- Reframe Swarm Mode as Agent Teams with opt-in requirement
- Make tool references platform-agnostic
- Remove plan checkbox editing during execution
Create separate beta skills instead of gating existing ones. Stable
ce:plan and deepen-plan are restored to main versions. Beta skills
reference each other and work standalone outside lfg/slfg orchestration.
- Beta plans use -beta-plan.md suffix to avoid clobbering stable plans
- Fix internal references in beta skills to use beta names consistently
- Add beta skills section to AGENTS.md with promotion checklist
Beta skills now use disable-model-invocation: true to prevent accidental
auto-triggering. Descriptions written as future stable descriptions with
[BETA] prefix for clean promotion. Updated solutions doc and AGENTS.md
promotion checklist to include removing the field.
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch from e90fd73 to 72d4b0d Compare March 17, 2026 17:33
- Fix -plan.md → -beta-plan.md in ce:plan-beta post-generation question
- Remove stale brainstorm doc reference from solutions doc
- Update plugin.json and marketplace.json skill counts (42 → 44)
- Add generic beta skill validation guidance to AGENTS.md and solutions doc
@tmchow tmchow merged commit 04f00e7 into main Mar 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant