Skip to content
cccskills
FreePublished on GitHub

plan

Plan a non-trivial task before implementing. Use when the task requires 3+ steps, multiple files, or an architectural decision. Writes a checkable plan to claude/tasks/todo.md.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Plan Skill

Create a structured, checkable implementation plan before writing any code.

When to use

  • Task requires 3 or more steps
  • Task touches multiple files or layers
  • Task involves an architectural decision
  • Any time the path forward is not immediately obvious

Protocol

1. Read mandatory context first

  • claude/tasks/todo.md — current task state (are we resuming?)
  • claude/tasks/lessons.md — relevant past lessons
  • claude/architecture.md — project structure
  • claude/rules.md — golden rules

2. Understand the full scope

  • What is the exact goal? What does done look like?
  • What layers does this touch (schema, service, API, tests, docs)?
  • What already exists that is relevant?
  • What are the failure modes?

3. Write the plan to claude/tasks/todo.md

Format:

# Task: <Clear, concise title>

**Goal:** <One sentence. What is done when this is complete?>
**Branch:** <git branch name, if applicable>
**Loaded docs:** <which claude/*.md files you read>

## Steps
- [ ] 1. <First action — specific file or command>
- [ ] 2. <Second action>
- [ ] 3. <Third action>
...

## Review Checklist
- [ ] Tests pass
- [ ] Linter passes
- [ ] No new warnings
- [ ] PR description ready (if applicable)

## Notes
<Any constraints, risks, or decisions to track>

4. Validate the plan (optional — for complex tasks)

Spawn a plan-challenger subagent:

"Spawn plan-challenger to review this plan. Here is the plan: [paste plan]"

5. Get approval for non-trivial plans

Present the plan to the user. Wait for "proceed" or revisions before implementing.

Rules

  • NEVER start implementing before the plan is written
  • NEVER mark a step complete without proof (test result, output, etc.)
  • If something goes wrong mid-execution: STOP, re-read the plan, update it, then continue

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ask

Free

Route a codebase question to the right tool — structural graph, semantic search, or risk analysis. Use when you need to find or understand code without knowing exact file names.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Auto-configure CLAUDE.md and claude/ knowledge docs for a new project. Use when setting up Brain Bootstrap in a new repository. Discovers the codebase, fills in templates, and writes project-specific configuration.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Use before any new feature, component, or behavioral change — when you need to explore requirements and design before writing code

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Activate safety guards for the session. Use /careful before critical operations — blocks rm -rf, DROP TABLE, git push --force, kubectl delete namespace, docker system prune via PreToolUse hook.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Generate a user-facing changelog from git commits — categorize, filter noise, translate to user language. Runs in isolated fork context.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Save session state before context gets full or before ending. Writes current task state, branch, and loaded docs to claude/tasks/todo.md so the next session can resume cleanly.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

See all skills by brain-bootstrap

Report a problem with this skill