Skip to main content
skill CX Codex

writing-plans · dev-toolings — Claude Code skill: what it does, how to install

writing-plans generates structured implementation plans for Symfony features with clear steps, acceptance criteria, and risk mitigations.

MIT ★ 234 updated 2026-10-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dev-toolings/superpowers-symfony --skill writing-plans -a claude-code
Open on GitHub

What writing-plans does

This skill prepares an engineering plan before writing code across Symfony entities, services, message handlers, or API endpoints. It defines what is in or out of scope, outlines class architecture, and highlights open questions for review.

Work breaks down into atomic steps, with each phase starting from its test. Every step gets a dependency link and a size tag (S, M, or L). For standard scenarios like CRUD, background jobs, or third-party integrations, the workflow relies on templates in reference.md. During drafting, the agent uses only read-only discovery tools: Read, Glob, and Grep.

Vague intentions are explicitly barred. The output must reference concrete file paths, endpoints, and class names, keeping the plan directly actionable.

What it helps with

  • plan multi-layer Symfony features across entities, services, and APIs
  • split large tasks into test-first atomic steps with sizing
  • document acceptance criteria and risks before starting implementation
  • explicitly list out-of-scope items to prevent scope creep

Example prompts for the agent

  • Write an implementation plan for async report exports in Symfony
  • Draft a structured plan to add a billing webhook handler and entities
  • Create a step-by-step plan for the user profile API endpoint

How to install writing-plans

1Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill writing-plans -a claude-code

2Manually: put the files in place

~/.claude/skills/writing-plans/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/writing-plans/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about writing-plans

How to install writing-plans in Claude Code?

Run npx skills add dev-toolings/superpowers-symfony --skill writing-plans -a claude-code. The skill will be placed in ~/.claude/skills/writing-plans/SKILL.md.

What does writing-plans do?

It structures planned work into phased steps, class changes, and acceptance criteria before implementation starts.

Which templates are included in reference.md?

It provides starting templates for CRUD features, background workers, and external integrations.

Source text

SKILL.md · MIT
---
name: writing-plans
description: Create structured implementation plans for Symfony features with clear steps, dependencies, and acceptance criteria
capabilities: [read, search]
tags: [workflow]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Writing Plans (Symfony)

## Use when
- A feature touches several layers: entities, services, API, async work.
- The work must be reviewed, or split across sessions, before coding starts.
- Scope and risks must be known before committing to an approach.

## Default workflow
1. Write the overview: summary, scope in and out, dependencies.
2. Design the changes: new and modified entities, services and handlers, API endpoints.
3. Break the work into phases of atomic steps, each starting with its test.
4. Mark the dependencies between steps and size each one (S, M, L).
5. Write the acceptance criteria, and the risks with their mitigation.

## Guardrails
- Every step can be completed and tested on its own.
- Name concrete files, classes and endpoints, not intentions.
- List what is out of scope instead of dropping it silently.
- Start from a template in `reference.md` (CRUD, background job, integration) when one fits.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- A plan with overview, design, steps, acceptance criteria and risks.
- Step dependencies and sizes.
- Open questions for the reviewer.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

Similar skills

All skills for Backend and APIs →

writing-plans by other authors comes first.

writing-plans Jesse Vincent writing-plans is a Claude Code and Codex skill that creates a detailed implementation plan for a multi-step task before code changes begin. It runs when the agent has a feature spec or requirements. CX Codex +1 282,859installs writing-plans FradSer writing-plans — a skill for Claude Code, Codex, Cursor and other platforms that transforms a finished design into an executable implementation plan. CX Codex +1 123installs writing-plans bobmatnyc The writing-plans skill turns a finished design into a detailed implementation plan with small tasks, file paths, code, tests, and checks for another engineer. CX Codex +1 352installs writing-plans GanyuanRan writing-plans transforms approved requirements into a step-by-step implementation plan with TDD routing before modifying repository files. CX Codex +1 ★ 1,450repo stars plan-writing davila7 plan-writing breaks work into short tasks, each with its own verification step. Useful for feature work, refactoring, or any multi-step job. CX Codex +1 188installs creating-development-plans sammcj The creating-development-plans skill drafts a phased development plan with task breakdowns, requirements, and QA checklists. It helps set clear checkpoints before writing code. CX Codex +1 338installs php-pro https://github.com/Jeffallan php-pro enforces PHP 8.3+ standards across Laravel and Symfony projects with strict typing, PHPStan level 9 checks, and automated Pest tests. CX Codex +1 16,400installs aws-lambda-php-integration giuseppe-trisciuoglio aws-lambda-php-integration — a skill that walks the agent through running PHP and Symfony on AWS Lambda with Bref: handlers, runtime layers, SQS/SNS triggers and cold start tuning. CX Codex +1 3,700installs sentry-php-sdk getsentry sentry-php-sdk sets up Sentry monitoring in plain PHP, Laravel, or Symfony applications. It inspects your project dependencies and schedules to recommend the right SDK packages and config. CX Codex +1 2,400installs appwrite-php appwrite appwrite-php teaches your agent to write server-side PHP against Appwrite: users, tables, files, functions. Useful in Laravel and Symfony projects. CX Codex +1 898installs

From the same set51

The whole set →
symfony-voters The symfony-voters skill guides Symfony Voter authorization work, from mapping access decisions to testing denied cases. Use it to keep permission checks out of duplicated controller logic. CX Codex +1 ★ 234repo stars quality-checks Runs PHP-CS-Fixer for code style, PHPStan for static analysis, and type checking. Use before committing or when CI quality checks fail. CX Codex +1 ★ 234repo stars value-objects-and-dtos This skill guides Symfony work with immutable Value Objects and DTOs, covering constructor validation, value equality, and data crossing application boundaries. CX Codex +1 ★ 234repo stars effective-context effective-context is a Claude Code skill that teaches an agent to gather context for Symfony development: versions, error-path files, stack traces, and project constraints. CX Codex +1 ★ 234repo stars strategy-pattern Implements the Strategy pattern in Symfony using tagged services. Helps clean up branching logic when algorithms or providers vary at runtime. CX Codex +1 ★ 234repo stars executing-plans The executing-plans skill guides Claude Code through an approved implementation plan, with test-first steps and a separate commit for each one. Use it for multi-step work or to resume after an interruption. CX Codex +1 ★ 234repo stars twig-components twig-components turns repeated Twig markup into Symfony UX components with props, slots and CVA variants. Handy once the same template chunk starts getting copied around. CX Codex +1 ★ 234repo stars cqrs-and-handlers cqrs-and-handlers implements CQRS in Symfony projects using separate Messenger buses for commands and queries. CX Codex +1 ★ 234repo stars

Project sponsors

Companies that keep this analytics open