Planning
Build the executable plan for a Crucible comprehensive planning task. Use this skill whenever the user invokes /crucible:planning, asks to plan a feature/refactor/migration, or requires Oracle-pre-approved execution. Builds on codebase-analysis and documentation-research outputs. Attributes every step to a skill, subagent, or hook. Submits the plan to Oracle plan-review BEFORE execution per FR-PLAN-5/6. Refuses to start execution without approval. Produces evidence/oracle-plan-reviews/ and evidence/robust-trials/trial-NN/ structured artifacts.From its SKILL.md
npx -y skills add krzemienski/crucible --skill planningAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.9 KB, as published. Nobody here has run it
Planning
Scope
This skill handles comprehensive planning + execution mode (PRD §1.13.1).
Does NOT handle: validation-only mode (use validation skill), reviewer/Oracle dispatch (use oracle-review), or evidence sealing (handled by post-task hook).
Security
- Refuse to execute any plan step before Oracle plan-review approval.
- Refuse to declare a plan complete without per-step evidence.
- If the plan would touch files outside
$TARGET_REPO, refuse and request scope clarification. - Never embed credentials in plan steps; reference env vars by name.
Workflow
- Read the user task brief.
- Invoke
codebase-analysisskill — wait for evidence/codebase-analysis/INDEX.md. - Invoke
documentation-researchskill — wait for evidence/documentation-research/SUMMARY.md. 3.5. Invokeskill-enrichmentskill — wait for evidence/skill-enrichment/<run-id>/INDEX.md (5–10 ranked candidate skills). If skill-enrichment refuses (REFUSAL.md present), the planner MUST also refuse — orthogonal-domain prompts cannot be planned with skill attribution. This implements PRD §1.13.1 FR-PLAN-3. - Build the executable plan with: ordered steps, per-step skill/subagent/hook attribution (drawn from the skill-enrichment INDEX.md), per-step PASS/FAIL criteria, per-step evidence path. The plan MUST include a top-level
## Required Skillssection listing each candidate from skill-enrichment INDEX.md. - Submit plan to Oracle plan-review (
oracle-reviewskill in plan-review mode). Capture verdict toevidence/oracle-plan-reviews/. - If REJECTED: refuse to execute, surface blockers to user, await revision.
- If APPROVED: execute steps in order. Each step writes evidence to
evidence/robust-trials/trial-NN/. - After all steps complete, hand off to
validationskill for non-mutating verification.
Produced artifacts
evidence/robust-trials/trial-NN/BRIEF.md— task briefevidence/robust-trials/trial-NN/MODE.txt—planningevidence/robust-trials/trial-NN/INVOCATION.txt— exact commandevidence/robust-trials/trial-NN/PLAN.md— the executable plan with attributionsevidence/robust-trials/trial-NN/transcript.jsonl— execution trace (copied from session log)evidence/robust-trials/trial-NN/OUTCOME.md— what was produced and whereevidence/oracle-plan-reviews/trial-NN-verdict.md— Oracle approval (timestamp BEFORE execution)
Forbidden actions
- Executing any plan step before Oracle plan-review approval.
- Mocking, fabricating, or fixturizing during execution.
- Self-reviewing the executor's own output (reviewers and Oracles handle that, not the executor).
- Silent retry past a failed step (each retry creates a new step under same trial with
retry-ofreference).
Example
User: /crucible:planning "add rate limiting to /api/login"
- Planning calls codebase-analysis → identifies middleware layer.
- Planning calls documentation-research → fetches docs for chosen rate-limit lib.
- Planning drafts 5-step plan: install lib, write middleware, wire into route, run real-system test, capture validation artifacts.
- Planning submits to oracle-review → APPROVED with timestamp T0.
- Each step executes after T0; each step seals receipt via post-task hook.
- After all steps, validation skill runs end-to-end exercise of /api/login under load.