dev-story

Implements a story file by loading context, routing to programmer agents, and writing code and tests.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill dev-story-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-story
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/dev-story
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill dev-story-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementing a game development story requires assembling scattered context — the story file, GDD requirement, governing ADR, and control manifest — and routing work to the right specialist. This Skill automates that orchestration so implementation follows architectural decisions instead of drifting from design. ## Core Features & Use Cases - Full Context Loading: Reads the story file, TR registry, governing ADR, control manifest, and engine preferences before any code is written, blocking on missing critical files. - Agent Routing: Selects the correct programmer agent (gameplay, UI, AI, network, engine) based on story layer, type, and engine, spawning engine specialists for high-risk stories. - Test Enforcement: Requires Logic and Integration stories to produce a test file at the path specified in the story's Test Evidence section, with one test per acceptance criterion. - Use Case: A team has a sprint of stories written against ADRs for a Godot 4 project. Run this Skill on each story to have the right specialist implement the code and tests, then hand off to code review and story closure. ## Quick Start Use $ai-game-studio:dev-story with the path to a ready story file to implement it with full architectural context.

Frequently Asked Questions about dev-story

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

FAQPage Schema
How do I implement a game development story file with AI agents?

Run the dev-story skill with the story file path. It loads the story, TR registry requirement, governing ADR, and control manifest, then spawns the appropriate programmer agent to write the implementation and test file.

What files must exist before running story implementation?

The TR registry at docs/architecture/tr-registry.yaml and the governing ADR referenced in the story are mandatory; missing either blocks implementation. The control manifest is optional but recommended, since layer rules cannot be checked without it.

Does this workflow support Godot, Unity, and Unreal engines?

Yes. The skill reads the Engine value from .ai-game-studio/project.json and spawns matching specialists, such as godot-specialist, unity-specialist, or unreal-specialist, alongside the primary programmer agent for engine-specific work.

Are tests required for every story type?

Tests are blocking for Logic and Integration stories, which must produce a test file at the path in the story's Test Evidence section. Visual/Feel and UI stories use advisory manual evidence, and Config/Data stories need no test.

What happens when a story dependency is incomplete?

The skill checks each dependency's status and prompts you to proceed anyway, stop and complete the dependency first, or mark it complete. Choosing to stop sets the story status to BLOCKED and no programmer agent is spawned.