doc-driven-dev

Align Stories, ROADMAP.md, and design docs with code changes.

1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/archonai-lab/archon --skill doc-driven-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-driven-dev
Source: https://github.com/archonai-lab/archon/tree/main/.claude/skills/doc-driven-dev
Command: npx skills add https://github.com/archonai-lab/archon --skill doc-driven-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams enforce a documentation-driven development workflow, ensuring code changes align with updated stories, roadmaps, and design docs to reduce drift and miscommunication.

Core Features & Use Cases

  • Documentation-driven workflow orchestration: design docs, ROADMAP.md updates, and story files in sync with code changes.
  • Compliance checks and sync: validate that Story files reflect implemented features and update ROADMAPs accordingly.
  • Knowledge scaffolding: maintain templates and references for design decisions and changelogs to guide development.
  • Use Case: A feature request is explored by updating the ROADMAP, creating a Story, drafting design docs, implementing code, and then syncing all docs to reflect the final state.

Quick Start

Create or update a Story file that documents a new feature and instructs your AI to follow the documented development workflow.

Frequently Asked Questions about doc-driven-dev

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

FAQPage Schema
How do I keep design docs and roadmaps in sync with code changes during feature development?

Documentation-driven development aligns design docs, ROADMAP.md, and story files with code changes by enforcing validation steps and synchronization rules during feature iteration. This ensures code changes remain traceable to living documentation, reducing drift and miscommunication.

What is document-first development and how does it work with story files?

Document-first development orchestrates feature workflows by updating the ROADMAP, creating a Story file, drafting design docs, implementing code, and syncing all documentation to reflect the final state. It ensures story files and changelogs accurately reflect implemented features through compliance checks.

How do I structure documentation for features using stories and design docs?

Structure documentation by organizing files under stories/, docs/design/, and ROADMAP.md with proper frontmatter metadata. This layout maintains templates and references for design decisions and changelogs to guide development and ensure validation steps are enforced.

Can I use this documentation-driven workflow for existing projects with established roadmaps?

Yes, the workflow applies to feature development across existing projects by validating that Story files reflect implemented features and updating ROADMAP.md accordingly. It enforces synchronization rules to ensure code changes align with your established design references and changelogs.

What's the best way to enforce traceability between code iterations and living documentation?

Enforce traceability by applying documentation-driven workflow orchestration that validates Story files against implemented features and updates ROADMAPs during code iteration. This ensures design docs, changelogs, and stories stay synchronized with development work through compliance checks.

Why does code drift away from design docs and how do I prevent it?

Code drifts from design docs when development workflows lack enforced synchronization rules between code changes and documentation. Prevent drift by maintaining a document-first workflow that validates story files and updates ROADMAP.md and design references during every code iteration.