One-click install
npx skills add https://github.com/JISU-JEONG/claude-custom-skills --skill dev-spec-jisu-jeong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-spec
Source: https://github.com/JISU-JEONG/claude-custom-skills/tree/main/.claude/skills/dev-spec
Command: npx skills add https://github.com/JISU-JEONG/claude-custom-skills --skill dev-spec-jisu-jeong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Requirements for server features often get stuck at a vague level, making it hard for teams to estimate, split ownership, and start implementation without rework.

Core Features & Use Cases

  • Work Unit (WU) breakdown with phased approval loop: Decomposes a large request into independent, reviewable work tickets and guides you to approve them one-by-one.
  • Project-aware planning: Reads existing project code to extract error format, base models/mixins, repository/DI patterns, and shared utilities so each WU matches local conventions.
  • Generates implementation-ready development specs: Produces detailed per-WU plans (API, DB, business logic, errors, security, edge cases, DoD) and stores them for follow-up execution.
  • Use Case: You have a new “create booking” server feature from a Notion ticket; use dev-spec to generate a sequence of concrete WU specs that developers can implement with minimal ambiguity.

Quick Start

Ask to generate a dev plan for your server feature by providing the input as either a Notion page, a markdown file path, or directly paste the requirement text.

Frequently Asked Questions about dev-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down server requirements into implementable work tickets?

To break down server requirements into implementable work tickets, this Skill parses Notion pages or markdown text to extract functional and non-functional needs, transforming them into phased development specs with API, DB, and business logic plans.

What is requirements decomposition for server engineering?

Requirements decomposition for server engineering is the process of converting a large feature request into independent, reviewable work units, each containing detailed development specs, definitions of done, and dependency mappings for team collaboration.

Can I generate development specs from a Notion page?

Yes, you can generate development specs directly from a Notion page by providing the link as input; the tool parses the requirement text and converts it into a sequence of concrete work unit documents for implementation.

Does API and DB planning match existing project code conventions?

Yes, API and DB planning matches existing project code conventions by reading your codebase to extract error formats, base models, repository patterns, and shared utilities, ensuring each generated work unit aligns with local architecture.

What are the limitations of using automated work unit breakdown?

Limitations of automated work unit breakdown include the explicit avoidance of code generation, code review, test writing, and deployment; the tool strictly produces implementation-ready development specs and dependency mappings rather than executable code.