spec-coding-skill

Original🇺🇸 English
Translated

Guides LLM agents through large-scale coding tasks using a spec-driven, phase-by-phase methodology covering requirement definition, planning, algorithm design, and implementation with OOP principles and language-specific coding standards. Use when starting a new software project, implementing a complex feature, refactoring existing code, or when you need a disciplined step-by-step approach to any non-trivial coding task.

8installs

NPX Install

npx skill4agent add hunter-leo/llm-agent-oop-coding-skill spec-coding-skill

Spec Coding Skill

A spec-driven methodology for LLM agents to define, plan, and implement large-scale coding work with quality and consistency.

When Activated

  1. Read 00-agent-execution.md first — these are global rules that apply to every phase and take precedence over all other instructions
  2. Start Phase 01 — follow 01-initialization.md to create the requirement definition document
  3. Work through phases in order — consult the reference file for each phase as you enter it
All generated documents go under
.dev/[NNN]-[req-name]/
in the project root.

Phase Overview

Phase 01 — Initialization        (required)
Phase 02 — Prerequisite Tasks    (optional, LLM judges)
Phase 03 — Algorithm Design      (optional, LLM judges)
Phase 04 — Implementation Plan   (required)
Phase 05 — Task Planning         (required)
Phase 06 — Execution             (required)
Phases 02 and 03 are independent — both, one, or neither may be needed.

Phase Reference

PhaseOutputReference
01 Initialization
init.md
01-initialization.md
02 Prerequisite Tasks
inspect.md
/
research.md
/
profiling.md
/
diagnosis.md
02-prerequisite-tasks.md
03 Algorithm Design
algorithm-design.md
03-algorithm-design.md
04 Implementation Plan
plan.md
04-implementation-plan.md
05 Task Planning
tasks.md
05-task-planning.md
06 Execution
start-and-resume.md
+ code
06-start-and-resume.md

Coding Reference

TopicReference
OOP & SOLID Principles07-oop-principles.md
Coding Standards (all languages)08-coding-standards.md

Core Rules

  • Never skip a required phase
  • Read existing code before modifying anything
  • Write and pass unit tests before moving to the next task
  • Minimize changes when the project is
    live
    ; breaking changes are allowed for
    pre-launch
    + new modules
  • Never hardcode secrets; use environment variables
  • All identifiers, comments, and docs must be in English