Daedalion

Spec-to-Agent compiler for GitHub Copilot. Write specs; get agents, skills, and prompts — all kept in sync with your source of truth.

"Write specs, get agents automatically."

Written in TypeScript with strict mode. Ships compiled JS + type declarations.

Overview

Daedalion turns your openspec/ specifications into native GitHub Copilot artifacts — agents, skills, prompts, and instructions. Your specs stay the source of truth; agents stay in sync automatically.

OpenSpec (what) ───▶ Daedalion ───▶ GitHub Copilot (how)

Core Goal: Spec-Driven Development with AI

Daedalion's primary mission: Ensure humans and AIs agree on what to build before any code is written.

Write specs in openspec/ using any format — hand-crafted or generated by OpenSpec. Run daedalion build to compile them into GitHub Copilot artifacts:

• Skills tell Copilot what requirements and acceptance criteria apply in each domain
• Agents give Copilot domain-aware personas
• Change prompts surface active work items directly in the IDE
• AGENTS.md provides a root-level discovery index for agent coordination

The result: Copilot always has the right context for the domain it is working in.

Why Daedalion

• Compiles any spec format into native Copilot artifacts
• Generates native Copilot surface: agents, skills, prompts, instructions, AGENTS.md
• Prevents drift: validate checks specs ↔ artifacts are in sync
• Safe cleanup: clean removes only Daedalion-generated files (via manifest)

Quick Start

npm install -g openspec daedalion
openspec init                # creates openspec/ + AGENTS.md
daedalion init               # adds daedalion.yaml + project.md (minimal)
daedalion init --with-example # includes example specs and changes
daedalion build              # generates Copilot artifacts (agents, skills, prompts)
daedalion validate           # checks specs ↔ artifacts are in sync

Use the coordinator by asking your AI: “Help me work through the OpenSpec cycle.”

What It Generates

daedalion init installs:

.github/
└── prompts/
    └── daedalion-compile.prompt.md         # Slash prompt to trigger compilation

daedalion build generates:

.github/
├── AGENTS.md                               # Agent discovery index
├── instructions/{domain}.instructions.md   # Pattern-specific domain context
├── prompts/{change}.prompt.md              # Slash prompts for active changes
├── agents/{domain}.agent.md                # Domain personas
├── skills/{domain}/SKILL.md                # Auto-loaded skills from specs
├── copilot-instructions.md                 # Project context (conventions, domain list)
└── workflows/daedalion.yml                 # CI workflow (validate / auto-regenerate)

Commands

• daedalion init - Scaffolds a new project:

project/
├── daedalion.yaml
└── openspec/
    └── project.md

Add --with-example to include example specs and changes:

project/
├── daedalion.yaml
└── openspec/
    ├── project.md
    ├── specs/
    │   └── example/
    │       └── spec.md
    └── changes/
        └── example-feature/
            ├── proposal.md
            └── tasks.md

• daedalion build - Generates GitHub Copilot artifacts from your specs:

.github/
├── AGENTS.md
├── instructions/{domain}.instructions.md
├── skills/{domain}/
│   ├── SKILL.md                      # hub: compact requirements + spoke links
│   └── {requirement-slug}.md         # spoke: scenario details per requirement
├── agents/{domain}.agent.md
├── prompts/{change-name}.prompt.md
├── workflows/daedalion.yml           # only when ci.enabled: true
└── copilot-instructions.md

• daedalion validate — Verify specs and artifacts are in sync
• daedalion clean — Remove only Daedalion-generated files

Learn More

• OpenSpec format and conventions: docs/openspec-format.md
• Generated output details: docs/generated-output.md
• CI setup and options: docs/ci-workflow.md
• Developer notes: docs/DEVELOPER.md
• TypeScript migration plan: docs/TYPESCRIPT_MIGRATION_PLAN.md
• Release notes: RELEASE.md

License

MIT