diatagma

Manage spec-driven stories with markdown and YAML frontmatter.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/SerPeter/diatagma --skill diatagma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diatagma
Source: https://github.com/SerPeter/diatagma/tree/main/.claude/skills/diatagma
Command: npx skills add https://github.com/SerPeter/diatagma --skill diatagma

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing spec-driven stories in a project, allowing for efficient coordination between humans and AI agents.

Core Features & Use Cases

  • Spec-Driven Workflow: Facilitates a workflow that starts with writing specifications and derives tests from behavior, followed by implementation and verification.
  • Plain Markdown Specs: Utilizes markdown files with YAML frontmatter for specifications, making them human-readable and editable.
  • MCP Server & Web Dashboard: Provides a server for AI agents to interact with stories and a web dashboard for human users to manage tasks and dependencies.
  • Dependency DAG: Offers a networkx-powered dependency graph for visualizing and managing dependencies between tasks.
  • Priority Scoring: Implements a WSJF-style composite ranking system for prioritizing tasks based on business value, story points, and other factors.

Quick Start

Initialize a .specs/ directory in your project with diatagma init, then start the web dashboard with diatagma serve.

Frequently Asked Questions about diatagma

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

FAQPage Schema
How do I manage spec-driven stories for project management using markdown?

Manage spec-driven stories by authoring markdown specifications with YAML frontmatter, enabling an AI agent and human collaboration workflow to create, query, and update project tasks.

What is the best way to coordinate AI agents and humans for story coordination?

Coordinate AI agents and humans through a combined MCP server for agent interaction and a web dashboard for human management, synchronizing updates to markdown story specifications.

How do I visualize and manage task dependencies in a spec-driven workflow?

Visualize and manage task dependencies using a networkx-powered dependency DAG, mapping relationships between spec-driven markdown stories to ensure correct execution order.

Can I prioritize project management stories using a WSJF-style scoring system?

Yes, prioritize stories using a WSJF-style composite ranking system that calculates priority scores based on business value, story points, and other factors defined in YAML frontmatter.

How do I initialize a project for spec-driven story management?

Initialize a project for spec-driven story management by running the initialization command to create a .specs/ directory, then launch the web dashboard to begin authoring markdown specifications.