Back to Skills

workflow

Standard workflow for implementing features with specs and planning documents. Use when starting a new feature, planning implementation, or working on any non-trivial task.

3,933stars263forksUpdated 1/21/2026

Security Assessment

Safe(100/100)
Security Score100/100

About workflow

The workflow skill provides a structured approach for implementing new features by emphasizing careful planning and documentation. It addresses the common challenges faced by developers when starting a feature, ensuring that they have a clear roadmap before diving into coding. By requiring a written plan that outlines tasks and objectives, this skill helps prevent scope creep and encourages a methodical approach to development, which can significantly improve project outcomes.

FAQ

How do I create a plan for my feature?

You should write a plan to specs/[timestamp] [feature-name].md where [timestamp] is in YYYYMMDDThhmmss format and [feature-name] is the name of the feature.

Where should I place my specs?

Specs should always be placed at the root level of their scope, such as /specs/ for cross-cutting features or /apps/[app]/specs/ for app-specific features.

Is there a specific format for the todo items in the plan?

Yes, the plan should include a list of todo items that you can check off as you complete them.

What should I do if I am unsure about the plan?

Before beginning work, check in with the relevant party to verify your plan.

Are there any limitations to this workflow?

The workflow emphasizes simplicity, so it is important to avoid making any massive or complex changes.

Install workflow

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill