dev-story

Translates a validated story specification into compliant source code and required tests.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/easonlao/jiazi-game --skill dev-story-easonlao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-story
Source: https://github.com/easonlao/jiazi-game/tree/main/.claude/skills/dev-story
Command: npx skills add https://github.com/easonlao/jiazi-game --skill dev-story-easonlao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Dev Story converts a story specification into correct, end-to-end implementation by loading all required planning context, applying architecture rules, routing to the right specialist, and producing the required test coverage so the story can be safely reviewed and closed.

Core Features & Use Cases

  • Story-to-Implementation Orchestration: Reads a full story file (or the active story), validates prerequisites (TR registry, governing ADR, and control manifest), and drives implementation until the test is written.
  • Architecture-Guided Coding: Extracts the governing ADR decision and implementation guidelines verbatim and enforces required/forbidden patterns from the control manifest for the story’s layer.
  • Dependency and Version Guardrails: Validates story dependencies, blocks when required inputs are missing, and handles manifest version mismatches with explicit user confirmation paths.
  • Engine-Aware Specialist Routing: Chooses the proper programmer agent based on story layer/type/system and spawns an engine specialist when engine risk is high.

Quick Start

Ask the system to run dev-story on a specific story path to implement the story and create the required source code and test in the project.

Frequently Asked Questions about dev-story

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

FAQPage Schema
How do I turn story specifications into working source code and tests?

To generate code from a story spec, the system validates prerequisites like the TR registry, governing ADR, and control manifest, then routes the task to a specialist agent. It writes architecture-compliant source code in src/ and required test coverage in tests/.

How does architecture-guided code generation enforce ADR compliance?

Architecture-guided coding enforces ADR compliance by extracting governing ADR decisions and implementation guidelines verbatim. It applies required and forbidden patterns from the control manifest to ensure the generated source code matches architectural rules for the story's layer.

Can I use story implementation for Godot-ready game development?

Yes, story implementation supports Godot-ready development by applying engine constraints during the implementation phase. It chooses the proper programmer agent based on the story layer and spawns an engine specialist when engine risk is high.

Do I need a control manifest and ADR before implementing a story?

Yes, a control manifest and governing ADR are required prerequisites. The system validates these dependencies before implementation, blocks when required inputs are missing, and handles manifest version mismatches with explicit user confirmation paths.

What happens when story dependencies are missing during code generation?

When story dependencies are missing, the system blocks implementation to prevent errors. Dependency and version guardrails validate story dependencies upfront and handle manifest version mismatches through explicit user confirmation paths before proceeding.

How does agent routing work for different story types?

Agent routing chooses the proper programmer agent based on the story layer, type, and system. It handles Logic, Integration, Visual/Feel, and Config/Data story types, spawning an engine specialist when engine risk is high during the implementation phase.