What is the primary benefit of the Smart Dev workflow?

It enforces a documentation-first approach with readiness gates, ensuring high-quality implementation and preventing context pollution in long-running development sessions.

How does the Readiness Gate work?

It uses dual-track scoring—Structural Scoring (Track A) and Semantic Sufficiency (Track B)—to verify that specifications are 95% complete before implementation begins.

Can I resume a feature development session if it gets interrupted?

Yes, the skill maintains a persistent progress.md file in the .works/spec/ directory, allowing Claude to continue seamlessly from the last recorded state.

Which models does this skill utilize?

It leverages a multi-model strategy: Opus for product thinking, Sonnet for architecture and coding, and Haiku for fast codebase exploration and semantic checks.

Does it support multilingual interaction?

The workflow is optimized to communicate with the user in Simplified Chinese while generating all code artifacts, documentation, and PRs in English.

Smart Dev Feature Workflow

Name: Smart Dev Feature Workflow
Author: royisme

byroyisme

0•

生産性とワークフロー

Implements a systematic 5-phase workflow for feature development, refactoring, and migrations within Claude Code.

The Smart Dev skill provides a rigorous, documentation-first framework for managing complex engineering tasks. It guides Claude through a structured process—Discovery, Exploration, Documentation, Implementation, and Review—to ensure architectural alignment and high code quality. By utilizing parallel agents and dual-track readiness gates (Structural and Semantic scoring), it validates specifications before implementation begins. This skill is ideal for complex multi-file changes, ensuring progress is persisted across sessions and preventing context pollution in the main development environment.

主な機能

01Automated codebase exploration and parallel pattern analysis

02Structured 5-phase development lifecycle: Discovery to Review

030 GitHub stars

04Documentation-first approach with automated spec-readiness scoring

05Persistent progress tracking with session resumption capabilities

06Multi-agent strategy leveraging Opus, Sonnet, and Haiku models

ユースケース

01Executing major architectural refactors or database migrations

02Systematically upgrading APIs and managing technical debt

03Implementing complex multi-file features from vague requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add royisme/agent-skills smart-dev

For use in Claude.ai and ChatGPT

Download Skill