refactor(cli)!: rename all skills and agents to consistent ce- prefix (#503)
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: ce:plan
|
||||
description: "Create structured plans for any multi-step task -- software features, research workflows, events, study plans, or any goal that benefits from structured breakdown. Also deepen existing plans with interactive review of sub-agent findings. Use for plan creation when the user says 'plan this', 'create a plan', 'write a tech plan', 'plan the implementation', 'how should we build', 'what's the approach for', 'break this down', 'plan a trip', 'create a study plan', or when a brainstorm/requirements document is ready for planning. Use for plan deepening when the user says 'deepen the plan', 'deepen my plan', 'deepening pass', or uses 'deepen' in reference to a plan."
|
||||
name: ce-plan
|
||||
description: "Create structured plans for any multi-step task -- software features, research workflows, events, study plans, or any goal that benefits from structured breakdown. Also deepen existing plans with interactive review of sub-agent findings. Use for plan creation when the user says 'plan this', 'create a plan', 'write a tech plan', 'plan the implementation', 'how should we build', 'what's the approach for', 'break this down', 'plan a trip', 'create a study plan', or when a brainstorm/requirements document is ready for planning. Use for plan deepening when the user says 'deepen the plan', 'deepen my plan', 'deepening pass', or uses 'deepen' in reference to a plan. For exploratory or ambiguous requests where the user is unsure what to do, prefer ce-brainstorm first."
|
||||
argument-hint: "[optional: feature description, requirements doc path, plan path to deepen, or any task to plan]"
|
||||
---
|
||||
|
||||
@@ -8,11 +8,11 @@ argument-hint: "[optional: feature description, requirements doc path, plan path
|
||||
|
||||
**Note: The current year is 2026.** Use this when dating plans and searching for recent documentation.
|
||||
|
||||
`ce:brainstorm` defines **WHAT** to build. `ce:plan` defines **HOW** to build it. `ce:work` executes the plan. A prior brainstorm is useful context but never required — `ce:plan` works from any input: a requirements doc, a bug report, a feature idea, or a rough description.
|
||||
`ce-brainstorm` defines **WHAT** to build. `ce-plan` defines **HOW** to build it. `ce-work` executes the plan. A prior brainstorm is useful context but never required — `ce-plan` works from any input: a requirements doc, a bug report, a feature idea, or a rough description.
|
||||
|
||||
**When directly invoked, always plan.** Never classify a direct invocation as "not a planning task" and abandon the workflow. If the input is unclear, ask clarifying questions or use the planning bootstrap (Phase 0.4) to establish enough context — but always stay in the planning workflow.
|
||||
|
||||
This workflow produces a durable implementation plan. It does **not** implement code, run tests, or learn from execution-time results. If the answer depends on changing code and seeing what happens, that belongs in `ce:work`, not here.
|
||||
This workflow produces a durable implementation plan. It does **not** implement code, run tests, or learn from execution-time results. If the answer depends on changing code and seeing what happens, that belongs in `ce-work`, not here.
|
||||
|
||||
## Interaction Method
|
||||
|
||||
@@ -32,7 +32,7 @@ If the input is present but unclear or underspecified, do not abandon — ask on
|
||||
|
||||
## Core Principles
|
||||
|
||||
1. **Use requirements as the source of truth** - If `ce:brainstorm` produced a requirements document, planning should build from it rather than re-inventing behavior.
|
||||
1. **Use requirements as the source of truth** - If `ce-brainstorm` produced a requirements document, planning should build from it rather than re-inventing behavior.
|
||||
2. **Decisions, not code** - Capture approach, boundaries, files, dependencies, risks, and test scenarios. Do not pre-write implementation code or shell command choreography. Pseudo-code sketches or DSL grammars that communicate high-level technical design are welcome when they help a reviewer validate direction — but they must be explicitly framed as directional guidance, not implementation specification.
|
||||
3. **Research before structuring** - Explore the codebase, institutional learnings, and external guidance when warranted before finalizing the plan.
|
||||
4. **Right-size the artifact** - Small work gets a compact plan. Large work gets more structure. The philosophy stays the same at every depth.
|
||||
@@ -119,7 +119,7 @@ If no relevant requirements document exists, planning may proceed from the user'
|
||||
|
||||
If no relevant requirements document exists, or the input needs more structure:
|
||||
- Assess whether the request is already clear enough for direct technical planning — if so, continue to Phase 0.5
|
||||
- If the ambiguity is mainly product framing, user behavior, or scope definition, recommend `ce:brainstorm` as a suggestion — but always offer to continue planning here as well
|
||||
- If the ambiguity is mainly product framing, user behavior, or scope definition, recommend `ce-brainstorm` as a suggestion — but always offer to continue planning here as well
|
||||
- If the user wants to continue here (or was already explicit about wanting a plan), run the planning bootstrap below
|
||||
|
||||
The planning bootstrap should establish:
|
||||
@@ -132,13 +132,13 @@ The planning bootstrap should establish:
|
||||
Keep this bootstrap brief. It exists to preserve direct-entry convenience, not to replace a full brainstorm.
|
||||
|
||||
If the bootstrap uncovers major unresolved product questions:
|
||||
- Recommend `ce:brainstorm` again
|
||||
- Recommend `ce-brainstorm` again
|
||||
- If the user still wants to continue, require explicit assumptions before proceeding
|
||||
|
||||
If the bootstrap reveals that a different workflow would serve the user better:
|
||||
|
||||
- **Symptom without a root cause** (user describes broken behavior but hasn't identified why) — announce that investigation is needed before planning and load the `ce:debug` skill. A plan requires a known problem to solve; debugging identifies what that problem is. Announce the routing clearly: "This needs investigation before planning — switching to ce:debug to find the root cause."
|
||||
- **Clear task ready to execute** (known root cause, obvious fix, no architectural decisions) — suggest `ce:work` as a faster alternative alongside continuing with planning. The user decides.
|
||||
- **Symptom without a root cause** (user describes broken behavior but hasn't identified why) — announce that investigation is needed before planning and load the `ce-debug` skill. A plan requires a known problem to solve; debugging identifies what that problem is. Announce the routing clearly: "This needs investigation before planning — switching to ce-debug to find the root cause."
|
||||
- **Clear task ready to execute** (known root cause, obvious fix, no architectural decisions) — suggest `ce-work` as a faster alternative alongside continuing with planning. The user decides.
|
||||
|
||||
#### 0.5 Classify Outstanding Questions Before Planning
|
||||
|
||||
@@ -150,7 +150,7 @@ If the origin document contains `Resolve Before Planning` or similar blocking qu
|
||||
If true product blockers remain:
|
||||
- Surface them clearly
|
||||
- Ask the user, using the platform's blocking question tool when available (see Interaction Method), whether to:
|
||||
1. Resume `ce:brainstorm` to resolve them
|
||||
1. Resume `ce-brainstorm` to resolve them
|
||||
2. Convert them into explicit assumptions or decisions and continue
|
||||
- Do not continue planning while true blockers remain unresolved
|
||||
|
||||
@@ -174,8 +174,8 @@ Prepare a concise planning context summary (a paragraph or two) to pass as input
|
||||
|
||||
Run these agents in parallel:
|
||||
|
||||
- Task compound-engineering:research:repo-research-analyst(Scope: technology, architecture, patterns. {planning context summary})
|
||||
- Task compound-engineering:research:learnings-researcher(planning context summary)
|
||||
- Task research:ce-repo-research-analyst(Scope: technology, architecture, patterns. {planning context summary})
|
||||
- Task research:ce-learnings-researcher(planning context summary)
|
||||
Collect:
|
||||
- Technology stack and versions (used in section 1.2 to make sharper external research decisions)
|
||||
- Architectural patterns and conventions to follow
|
||||
@@ -185,7 +185,7 @@ Collect:
|
||||
|
||||
**Slack context** (opt-in) — never auto-dispatch. Route by condition:
|
||||
|
||||
- **Tools available + user asked**: Dispatch `compound-engineering:research:slack-researcher` with the planning context summary in parallel with other Phase 1.1 agents. If the origin document has a Slack context section, pass it verbatim so the researcher focuses on gaps. Include findings in consolidation.
|
||||
- **Tools available + user asked**: Dispatch `research:ce-slack-researcher` with the planning context summary in parallel with other Phase 1.1 agents. If the origin document has a Slack context section, pass it verbatim so the researcher focuses on gaps. Include findings in consolidation.
|
||||
- **Tools available + user didn't ask**: Note in output: "Slack tools detected. Ask me to search Slack for organizational context at any point, or include it in your next prompt."
|
||||
- **No tools + user asked**: Note in output: "Slack context was requested but no Slack tools are available. Install and authenticate the Slack plugin to enable organizational context search."
|
||||
|
||||
@@ -212,11 +212,11 @@ Based on the origin document, user signals, and local findings, decide whether e
|
||||
- **Topic risk** — Security, payments, external APIs warrant more caution regardless of user signals.
|
||||
- **Uncertainty level** — Is the approach clear or still open-ended?
|
||||
|
||||
**Leverage repo-research-analyst's technology context:**
|
||||
**Leverage ce-repo-research-analyst's technology context:**
|
||||
|
||||
The repo-research-analyst output includes a structured Technology & Infrastructure summary. Use it to make sharper external research decisions:
|
||||
The ce-repo-research-analyst output includes a structured Technology & Infrastructure summary. Use it to make sharper external research decisions:
|
||||
|
||||
- If specific frameworks and versions were detected (e.g., Rails 7.2, Next.js 14, Go 1.22), pass those exact identifiers to framework-docs-researcher so it fetches version-specific documentation
|
||||
- If specific frameworks and versions were detected (e.g., Rails 7.2, Next.js 14, Go 1.22), pass those exact identifiers to ce-framework-docs-researcher so it fetches version-specific documentation
|
||||
- If the feature touches a technology layer the scan found well-established in the repo (e.g., existing Sidekiq jobs when planning a new background job), lean toward skipping external research -- local patterns are likely sufficient
|
||||
- If the feature touches a technology layer the scan found absent or thin (e.g., no existing proto files when planning a new gRPC service), lean toward external research -- there are no local patterns to follow
|
||||
- If the scan detected deployment infrastructure (Docker, K8s, serverless), note it in the planning context passed to downstream agents so they can account for deployment constraints
|
||||
@@ -243,8 +243,8 @@ Announce the decision briefly before continuing. Examples:
|
||||
|
||||
If Step 1.2 indicates external research is useful, run these agents in parallel:
|
||||
|
||||
- Task compound-engineering:research:best-practices-researcher(planning context summary)
|
||||
- Task compound-engineering:research:framework-docs-researcher(planning context summary)
|
||||
- Task research:ce-best-practices-researcher(planning context summary)
|
||||
- Task research:ce-framework-docs-researcher(planning context summary)
|
||||
|
||||
#### 1.4 Consolidate Research
|
||||
|
||||
@@ -272,7 +272,7 @@ This ensures flow analysis (Phase 1.5) runs and the confidence check (Phase 5.3)
|
||||
|
||||
For **Standard** or **Deep** plans, or when user flow completeness is still unclear, run:
|
||||
|
||||
- Task compound-engineering:workflow:spec-flow-analyzer(planning context summary, research findings)
|
||||
- Task workflow:ce-spec-flow-analyzer(planning context summary, research findings)
|
||||
|
||||
Use the output to:
|
||||
- Identify missing edge cases, state transitions, or handoff gaps
|
||||
@@ -644,7 +644,7 @@ When the plan contains 4+ implementation units with non-linear dependencies, 3+
|
||||
#### 5.1 Review Before Writing
|
||||
|
||||
Before finalizing, check:
|
||||
- The plan does not invent product behavior that should have been defined in `ce:brainstorm`
|
||||
- The plan does not invent product behavior that should have been defined in `ce-brainstorm`
|
||||
- If there was no origin document, the bounded planning bootstrap established enough product clarity to plan responsibly
|
||||
- Every major decision is grounded in the origin document or research
|
||||
- Each implementation unit is concrete, dependency-ordered, and implementation-ready
|
||||
@@ -662,7 +662,7 @@ Before finalizing, check:
|
||||
If the plan originated from a requirements document, re-read that document and verify:
|
||||
- The chosen approach still matches the product intent
|
||||
- Scope boundaries and success criteria are preserved
|
||||
- Blocking questions were either resolved, explicitly assumed, or sent back to `ce:brainstorm`
|
||||
- Blocking questions were either resolved, explicitly assumed, or sent back to `ce-brainstorm`
|
||||
- Every section of the origin document is addressed in the plan — scan each section to confirm nothing was silently dropped
|
||||
|
||||
#### 5.2 Write Plan File
|
||||
@@ -694,8 +694,8 @@ After writing the plan file, automatically evaluate whether the plan needs stren
|
||||
|
||||
Interactive mode exists because on-demand deepening is a different user posture — the user already has a plan they are invested in and wants to be surgical about what changes. This applies whether the plan was generated by this skill, written by hand, or produced by another tool.
|
||||
|
||||
`document-review` and this confidence check are different:
|
||||
- Use the `document-review` skill when the document needs clarity, simplification, completeness, or scope control
|
||||
`ce-doc-review` and this confidence check are different:
|
||||
- Use the `ce-doc-review` skill when the document needs clarity, simplification, completeness, or scope control
|
||||
- This confidence check strengthens rationale, sequencing, risk treatment, and system-wide thinking when the plan is structurally sound but still needs stronger grounding
|
||||
|
||||
**Pipeline mode:** This phase always runs in auto mode in pipeline/disable-model-invocation contexts. No user interaction needed.
|
||||
|
||||
Reference in New Issue
Block a user