feat: promote ce:plan-beta and deepen-plan-beta to stable (#355)
This commit is contained in:
Trevin Chow
@@ -0,0 +1,132 @@
|
||||
---
|
||||
title: "feat: promote ce:plan-beta and deepen-plan-beta to stable"
|
||||
type: feat
|
||||
status: completed
|
||||
date: 2026-03-23
|
||||
---
|
||||
|
||||
# Promote ce:plan-beta and deepen-plan-beta to stable
|
||||
|
||||
## Overview
|
||||
|
||||
Replace the stable `ce:plan` and `deepen-plan` skills with their validated beta counterparts, following the documented 9-step promotion path from `docs/solutions/skill-design/beta-skills-framework.md`.
|
||||
|
||||
## Problem Statement
|
||||
|
||||
The beta versions of `ce:plan` and `deepen-plan` have been tested and are ready for promotion. They currently sit alongside the stable versions as separate skill directories with `disable-model-invocation: true`, meaning users must invoke them manually. Promotion makes them the default for all workflows including `lfg`/`slfg` orchestration.
|
||||
|
||||
## Proposed Solution
|
||||
|
||||
Follow the beta-skills-framework promotion checklist exactly, applied to both skill pairs simultaneously.
|
||||
|
||||
## Implementation Plan
|
||||
|
||||
### Phase 1: Replace stable SKILL.md content with beta content
|
||||
|
||||
**Files to modify:**
|
||||
|
||||
1. **`skills/ce-plan/SKILL.md`** -- Replace entire content with `skills/ce-plan-beta/SKILL.md`
|
||||
2. **`skills/deepen-plan/SKILL.md`** -- Replace entire content with `skills/deepen-plan-beta/SKILL.md`
|
||||
|
||||
### Phase 2: Restore stable frontmatter and remove beta markers
|
||||
|
||||
**In promoted `skills/ce-plan/SKILL.md`:**
|
||||
|
||||
- Change `name: ce:plan-beta` to `name: ce:plan`
|
||||
- Remove `[BETA] ` prefix from description
|
||||
- Remove `disable-model-invocation: true` line
|
||||
|
||||
**In promoted `skills/deepen-plan/SKILL.md`:**
|
||||
|
||||
- Change `name: deepen-plan-beta` to `name: deepen-plan`
|
||||
- Remove `[BETA] ` prefix from description
|
||||
- Remove `disable-model-invocation: true` line
|
||||
|
||||
### Phase 3: Update all internal references from beta to stable names
|
||||
|
||||
**In promoted `skills/ce-plan/SKILL.md`:**
|
||||
|
||||
- All references to `/deepen-plan-beta` become `/deepen-plan`
|
||||
- All references to `ce:plan-beta` become `ce:plan` (in headings, prose, etc.)
|
||||
- All references to `-beta-plan.md` file suffix become `-plan.md`
|
||||
- Example filenames using `-beta-plan.md` become `-plan.md`
|
||||
|
||||
**In promoted `skills/deepen-plan/SKILL.md`:**
|
||||
|
||||
- All references to `ce:plan-beta` become `ce:plan`
|
||||
- All references to `deepen-plan-beta` become `deepen-plan`
|
||||
- Scratch directory paths: `deepen-plan-beta` becomes `deepen-plan`
|
||||
|
||||
### Phase 4: Clean up ce-work-beta cross-reference
|
||||
|
||||
**In `skills/ce-work-beta/SKILL.md` (line 450):**
|
||||
|
||||
- Remove `ce:plan-beta or ` from the text so it reads just `ce:plan`
|
||||
|
||||
### Phase 5: Delete beta skill directories
|
||||
|
||||
- Delete `skills/ce-plan-beta/` directory entirely
|
||||
- Delete `skills/deepen-plan-beta/` directory entirely
|
||||
|
||||
### Phase 6: Update README.md
|
||||
|
||||
**In `plugins/compound-engineering/README.md`:**
|
||||
|
||||
1. **Update `ce:plan` description** in the Workflow Commands table (line 81): Change from `Create implementation plans` to `Transform features into structured implementation plans grounded in repo patterns`
|
||||
2. **Update `deepen-plan` description** in the Utility Commands table (line 93): Description already says `Stress-test plans and deepen weak sections with targeted research` which matches the beta -- verify and keep
|
||||
3. **Remove the entire Beta Skills section** (lines 156-165): The `### Beta Skills` heading, explanatory paragraph, table with `ce:plan-beta` and `deepen-plan-beta` rows, and the "To test" line
|
||||
4. **Update skill count**: Currently `40+` in the Components table. Removing 2 beta directories decreases the count. Verify with `bun run release:validate` and update if needed
|
||||
|
||||
### Phase 7: Validation
|
||||
|
||||
1. **Search for remaining `-beta` references**: Grep all files under `plugins/compound-engineering/` for leftover `plan-beta` strings -- every hit is a bug, except historical entries in `CHANGELOG.md` which are expected and must not be modified
|
||||
2. **Run `bun run release:validate`**: Check plugin/marketplace consistency, skill counts
|
||||
3. **Run `bun test`**: Ensure converter tests still pass (they use skill names as fixtures)
|
||||
4. **Verify `lfg`/`slfg` references**: Confirm they reference stable `/ce:plan` and `/deepen-plan` (they already do -- no change needed)
|
||||
5. **Verify `ce:brainstorm` handoff**: Confirms it hands off to stable `/ce:plan` (already does -- no change needed)
|
||||
6. **Verify `ce:work` compatibility**: Plans from promoted skills use `-plan.md` suffix, same as before
|
||||
|
||||
## Files Changed
|
||||
|
||||
| File | Action | Notes |
|
||||
|------|--------|-------|
|
||||
| `skills/ce-plan/SKILL.md` | Replace | Beta content with stable frontmatter |
|
||||
| `skills/deepen-plan/SKILL.md` | Replace | Beta content with stable frontmatter |
|
||||
| `skills/ce-plan-beta/` | Delete | Entire directory |
|
||||
| `skills/deepen-plan-beta/` | Delete | Entire directory |
|
||||
| `skills/ce-work-beta/SKILL.md` | Edit | Remove `ce:plan-beta or` reference at line 450 |
|
||||
| `README.md` | Edit | Remove Beta Skills section, verify counts and descriptions |
|
||||
|
||||
## Files NOT Changed (verified safe)
|
||||
|
||||
These files reference stable `ce:plan` or `deepen-plan` and require **no changes** because stable names are preserved:
|
||||
|
||||
- `skills/lfg/SKILL.md` -- calls `/ce:plan` and `/deepen-plan`
|
||||
- `skills/slfg/SKILL.md` -- calls `/ce:plan` and `/deepen-plan`
|
||||
- `skills/ce-brainstorm/SKILL.md` -- hands off to `/ce:plan`
|
||||
- `skills/ce-ideate/SKILL.md` -- explains pipeline
|
||||
- `skills/document-review/SKILL.md` -- references `/ce:plan`
|
||||
- `skills/ce-compound/SKILL.md` -- references `/ce:plan`
|
||||
- `skills/ce-review/SKILL.md` -- references `/ce:plan`
|
||||
- `AGENTS.md` -- lists `ce:plan`
|
||||
- `agents/research/learnings-researcher.md` -- references both
|
||||
- `agents/research/git-history-analyzer.md` -- references `/ce:plan`
|
||||
- `agents/review/code-simplicity-reviewer.md` -- references `/ce:plan`
|
||||
- `plugin.json` / `marketplace.json` -- no individual skill listings
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] `skills/ce-plan/SKILL.md` contains the beta planning approach (decision-first, phase-structured)
|
||||
- [ ] `skills/deepen-plan/SKILL.md` contains the beta deepening approach (selective stress-test, risk-weighted)
|
||||
- [ ] No `disable-model-invocation` in either promoted skill
|
||||
- [ ] No `[BETA]` prefix in either description
|
||||
- [ ] No remaining `-beta` references in any file under `plugins/compound-engineering/`
|
||||
- [ ] `skills/ce-plan-beta/` and `skills/deepen-plan-beta/` directories deleted
|
||||
- [ ] README Beta Skills section removed
|
||||
- [ ] `bun run release:validate` passes
|
||||
- [ ] `bun test` passes
|
||||
|
||||
## Sources
|
||||
|
||||
- **Promotion checklist:** `docs/solutions/skill-design/beta-skills-framework.md` (steps 1-9)
|
||||
- **Versioning rules:** `docs/solutions/plugin-versioning-requirements.md` (no manual version bumps)
|
||||
Reference in New Issue
Block a user