Skip to content
Back to skills

Plan

ASecurity

SDLC stage 3a (Build planning) - produce docs/sdlc/<feature>/plan.md from an approved spec, interviewing the engineer, before any code is written. Use when the spec is approved (or skipped) and plan.md is missing, in draft or stale, or the SDLC status says the current stage is plan.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added October 13, 2026
developmentgosecurityperformance

Works with

  • claude code

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned October 13, 2026

npx -y skills add Sennjen/claude-sdlc --skill plan --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Plan?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Plan
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/sennjen-plan/badge)](https://www.skillsdirectory.com/skills/sennjen-plan)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: plan
description: SDLC stage 3a (Build planning) - produce docs/sdlc/<feature>/plan.md from an approved spec, interviewing the engineer, before any code is written. Use when the spec is approved (or skipped) and plan.md is missing, in draft or stale, or the SDLC status says the current stage is plan.
---

# Stage 3a - Implementation plan

Design review happens here, while changing course is still a matter of editing a
document. Code edits stay blocked by hooks until the user approves this plan.

**Plan mode.** The playbook drafts the plan in Claude Code plan mode, where you can read the
codebase but not change it. The SDLC bar's *Write plan* runs this skill in the current mode;
the user enters plan mode only by choice (`Shift+Tab`). If the session is in plan mode:
- do steps 1 and 2 as below, then present the plan with ExitPlanMode instead of writing
  `plan.md` (plan mode allows no file writes). Use the template's sections, so the plan
  the user accepts is the one that lands in `plan.md`;
- after the user accepts it, write it to `docs/sdlc/<slug>/plan.md` unchanged, then go to
  step 4. Accepting a plan in plan mode is **not** the SDLC approval: the code gate stays
  closed until the user types `sdlc approve plan` (or presses *Approve plan*).

Outside plan mode, follow the same steps and write `plan.md` directly.

1. **Read** `spec.md` (or `intent.md` if the spec was skipped), `CLAUDE.md`, and the code
   you will touch. Explore enough to name concrete files and functions.
2. **Interview the engineer.** Ask about the choices that matter: approach alternatives,
   risky areas, migration strategy, test strategy. Recommend an option; don't just list them.
3. **Write `plan.md`** from [template.md](template.md):
   - *Files affected*: every file to create/change/delete, with the reason.
   - *Work sequence*: small ordered steps, each independently verifiable, tests first
     where practical. Mark steps that can run in parallel (subagents/worktrees).
   - *Risks*: breaking changes, security, performance, data, rollback.
   - *Validation*: which tests prove each acceptance criterion, and the exact commands.
   - *Approval level*: routine (engineer) or elevated (architect/tech lead) and why.
4. **Hand over.** Summarise steps and risks and ask the user to type `sdlc approve plan`.
   Keep iterating on the document until they do.

After approval, do **not** edit `plan.md` to track progress: any change invalidates the
approval. Track progress in `progress.md`. If the plan must change, edit it and ask for
re-approval; that is expected, not a failure.

Files in this skill

  • SKILL.md2.5 KB
  • template.md775 B

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.