dev-story

Implement game development stories into scoped source code and tests.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill dev-story-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-story
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/dev-story
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill dev-story-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents “spaghetti implementation” by turning a single story file into a complete, correctly-scoped code change with the required automated test and acceptance-criteria verification.

Core Features & Use Cases

  • Story-driven implementation: Reads a story file, pulls the correct GDD requirement (TR-ID), and loads the governing ADR and control manifest rules for the story’s layer.
  • Correct agent routing: Selects the appropriate programmer agent(s) based on story layer, type, and engine/system context, then executes implementation to completion.
  • Test evidence as a hard requirement: For Logic/Integration stories, writes the test file alongside implementation and ensures each acceptance criterion is covered by a test.

Quick Start

Use /dev-story with a story path so the assistant loads the full context and implements the story including its required test.

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 story specification with automated tests in a game engine?

Story implementation with tests is achieved by loading the story file, pulling the required GDD requirement and governing ADR, then routing the work to specialist agents to write scoped source code and test evidence in the project's src/ and tests/ locations.

How does architecture validation work during story implementation?

Architecture validation works by enforcing dependency checks and requiring a TR registry and governing ADR presence before safe execution, ensuring the story implementation aligns with the control manifest rules for the specified layer.

Can I generate tests for UI and Visual game development workflows?

Yes, you can generate tests for UI and Visual workflows, but test evidence is a strict hard requirement specifically for Logic and Integration stories, where each acceptance criterion must be covered by a test file.

What is the best way to prevent spaghetti implementation when writing game logic?

The best way to prevent spaghetti implementation is to use story-driven implementation that reads a story file, loads the correct architecture context, and performs acceptance criteria verification alongside the code change.

Do I need a control manifest and ADR to run story-driven code generation?

Yes, you need a TR registry and governing ADR presence for safe execution, and the system can optionally enforce manifest version alignment to ensure the generated code matches the defined architecture.

Why does game engine routing matter for integration story workflows?

Game engine routing matters because it selects the appropriate programmer agent based on the story layer, type, and engine context, executing the implementation to completion without incorrect cross-layer dependencies.