easyspec — Spec-Driven Development Kit for AI Coding Agents

One init command. A team of AI agents. Your entire software lifecycle — managed by specs, not chaos.

Supports GitHub Copilot, OpenCode, and Claude Code.

Built on the ideas of OpenSpec — the spec-driven development framework. Our spec format, agent delegation model, and change lifecycle are derived from OpenSpec's concepts. Thanks to the OpenSpec team.

Showcase

Parthenon — a self-hosted enterprise AI harness — was built with easyspec, feature by feature, through the propose → apply → update-master pipeline.

The same spec-driven pipeline that keeps the code clean also keeps the UI consistent. Each screen below was prototyped by the UX agent for a different feature, yet every one shares the same design language:

Install

Recommended — install globally:

npm install -g @myaider/easyspec

Try without installing:

npx @myaider/easyspec init

Usage

Init

easyspec init

Run interactively, the CLI asks two questions:

1. Harness(es) — which coding agent(s) to install for (multi-select: Copilot, OpenCode, Claude Code).
2. Scope — install into the current project, or globally into your user profile.

You can skip the prompts with flags:

| Option | Values | Default | Description | |--------|--------|---------|-------------| | --agent | copilot, opencode, claude-code (comma-separated for multiple) | interactive | Target coding agent(s) | | --scope | project, global | interactive | Install scope | | --workspace | <path> | cwd | Project folder for --scope project | | --force | — | false | Overwrite existing files | | --dry-run | — | false | Preview without writing | | --tech-model | <name> | auto | Model for technical agents | | --non-tech-model | <name> | auto | Model for non-technical agents | | --model-preset | balanced, speed, quality | — | Apply a preset model pair |

Models default to auto — no need to pick one.

Destination mapping

Project scope (--scope project):

| Agent | Commands/Prompts | Agents | Skills | |-------|------------------|--------|--------| | copilot | <ws>/.github/prompts/*.prompt.md | <ws>/.github/agents/*.md | <ws>/.github/skills/<name>/SKILL.md | | opencode | <ws>/.opencode/commands/*.md | <ws>/.opencode/agents/*.md | <ws>/.opencode/skills/<name>/SKILL.md | | claude-code | <ws>/.claude/commands/*.md | <ws>/.claude/agents/*.md | <ws>/.claude/skills/<name>/SKILL.md |

Global scope (--scope global): installed under your user profile instead of <ws>/.

| Agent | Commands/Prompts | Agents | Skills | |-------|------------------|--------|--------| | copilot | ~/Library/Application Support/Code/User/prompts/ (macOS) or %APPDATA%\Code\User\prompts\ (Windows) | ~/.copilot/agents/ | ~/.copilot/skills/ | | opencode | ~/.config/opencode/commands/ | ~/.config/opencode/agents/ | ~/.config/opencode/skills/ | | claude-code | ~/.claude/commands/ | ~/.claude/agents/ | ~/.claude/skills/ |

Examples

# Interactive — multi-select harness(es) and scope
easyspec init

# Copilot in the current project
easyspec init --agent copilot --scope project

# Copilot and Claude Code in one run
easyspec init --agent copilot,claude-code --scope project

# OpenCode globally
easyspec init --agent opencode --scope global

# Claude Code with a model preset
easyspec init --agent claude-code --scope project --model-preset balanced

# Preview without writing
easyspec init --agent opencode --dry-run

What is installed

Commands: es-change-init, es-change-propose, es-change-apply, es-change-refinement, es-change-fix, es-master-review, es-change-update-master, es-quick-fix

Agents: es-product-owner, es-ux-specialist, es-architect, es-database-designer, es-developer, es-tester, es-document-reviewer

Skill: es-change-lifecycle

Acknowledgements

This project builds on OpenSpec — a spec-driven development framework. The spec format, agent delegation model, and change lifecycle are derived from OpenSpec's concepts. Thanks to the OpenSpec team for the foundational ideas.

License

MIT