dev-story

Convert a specified story file into code with matching tests using TR, ADG, and manifest rules.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill dev-story-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-story
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/dev-story
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill dev-story-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the gap between a planning artifact (a “story” with acceptance criteria) and a working implementation by orchestrating context loading, correct routing, and end-to-end coding with required test coverage.

Core Features & Use Cases

  • Story-to-Implementation Orchestration: Loads the full story context (TR requirement, governing ADR guidance, and control manifest rules) and routes work to the right programmer and engine specialist agents.
  • Validation-First Workflow: Verifies required architecture files and checks manifest version compatibility before spawning implementation agents; validates story dependencies and can block safely.
  • Test-Backed Completion: Implements the story and writes the required Logic/Integration tests as part of the same workflow, ensuring acceptance criteria are covered before closure.

Quick Start

Invoke the skill with the story path you want implemented, for example: /dev-story production/epics/your-story.md.

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 files into code with matching tests?

To turn story files into code and tests, load TR registry requirements and ADR guidelines, then route the story context to the appropriate programmer agent for implementation. This workflow ensures test evidence is created at the path specified in the story header before closure.

What is story-driven development for test automation?

Story-driven development for test automation is a process that converts planning artifacts with acceptance criteria into working implementations. It orchestrates context loading, agent routing, and mandatory test coverage to eliminate the gap between planning and functional code.

How do I enforce ADR guidelines during code generation?

To enforce ADR guidelines during code generation, apply control-manifest rules within the story layer and verify required architecture files before spawning implementation agents. This validation-first workflow blocks execution safely if dependencies or manifest versions are incompatible.

Can I generate tests for Logic and Integration stories automatically?

Yes, you can generate tests for Logic and Integration stories automatically. The workflow mandates the creation of test evidence at the path specified in the story header, ensuring acceptance criteria are fully covered before the story implementation is closed.

Does agent orchestration route stories based on engine risk?

Yes, agent orchestration routes stories based on engine risk and story context. The workflow applies control-manifest rules to route work to the appropriate programmer and optional engine specialists across Logic, Integration, Visual, and Config story types.

What are the limitations of story-to-implementation orchestration?

Story-to-implementation orchestration is limited by its dependency on end-to-end context verification and manifest version compatibility. If required architecture files are missing or story dependencies fail validation, the workflow safely blocks implementation from proceeding.