SpecDD Plan
Use this skill when the user asks for a plan, or when unclear scope, authority,
public contracts, risk, or verification would make immediate implementation
unsafe. Do not edit files while planning.
Bootstrap Resolution
Before doing anything else in the target project, read bootstrap files in this exact order:
.specdd/bootstrap.md
.specdd/bootstrap.project.md, if it exists
.specdd/bootstrap.local.md, if it exists
Apply them in that order. Later files may narrow or specialize earlier rules, but must not silently weaken project contracts, inherited constraints, or write authority.
Spec Chain Resolution
Before planning, editing, reviewing, testing, or reporting on a target:
- Identify the target path, task, behavior, or changed files.
- Resolve the effective spec chain using the active bootstrap rules.
- Include same-directory basename specs when applicable.
- Walk ancestor specs from the selected content root to the target.
- Read explicit
References only when they affect the requested work.
- Identify the nearest local spec that grants write authority before any edit.
Do not infer authority from similar filenames, nearby files, symbols, module names, or conventions unless the active bootstrap or a governing spec explicitly defines that mapping.
Workflow
- Summarize the target scope and applicable spec chain.
- Identify files or specs likely to change.
- Identify verification and blockers.
- Summarize the smallest safe implementation path.
Plan Contents
Include:
- Target scope and applicable spec chain.
- Files or specs likely to change.
- Write authority and any unclear authority.
- Relevant
Must, Must not, Forbids, Scenario, Tasks, and Done when constraints.
- Verification likely needed.
- Risks, conflicts, or questions that block safe implementation.
Keep the plan practical. Do not propose broad refactors or new contracts unless
the active specs or user request require them.
1---2name: specdd-plan3description: Use when Claude Code is explicitly asked for a plan, or must resolve unclear SpecDD scope, write authority, public-contract risk, affected files, or verification before safe implementation; do not trigger for ordinary authorized changes.4license: Apache-2.05---67# SpecDD Plan89Use this skill when the user asks for a plan, or when unclear scope, authority,10public contracts, risk, or verification would make immediate implementation11unsafe. Do not edit files while planning.1213## Bootstrap Resolution1415Before doing anything else in the target project, read bootstrap files in this exact order:16171. `.specdd/bootstrap.md`182. `.specdd/bootstrap.project.md`, if it exists193. `.specdd/bootstrap.local.md`, if it exists2021Apply them in that order. Later files may narrow or specialize earlier rules, but must not silently weaken project contracts, inherited constraints, or write authority.2223## Spec Chain Resolution2425Before planning, editing, reviewing, testing, or reporting on a target:26271. Identify the target path, task, behavior, or changed files.282. Resolve the effective spec chain using the active bootstrap rules.293. Include same-directory basename specs when applicable.304. Walk ancestor specs from the selected content root to the target.315. Read explicit `References` only when they affect the requested work.326. Identify the nearest local spec that grants write authority before any edit.3334Do not infer authority from similar filenames, nearby files, symbols, module names, or conventions unless the active bootstrap or a governing spec explicitly defines that mapping.3536## Workflow37381. Summarize the target scope and applicable spec chain.392. Identify files or specs likely to change.403. Identify verification and blockers.414. Summarize the smallest safe implementation path.4243## Plan Contents4445Include:4647- Target scope and applicable spec chain.48- Files or specs likely to change.49- Write authority and any unclear authority.50- Relevant `Must`, `Must not`, `Forbids`, `Scenario`, `Tasks`, and `Done when` constraints.51- Verification likely needed.52- Risks, conflicts, or questions that block safe implementation.5354Keep the plan practical. Do not propose broad refactors or new contracts unless55the active specs or user request require them.