OpenSpec-extended

An extension pack for OpenSpec that adds autonomous implementation capabilities and utility skills for AI coding assistants.

Why use this?

Feature	OpenSpec Core	OpenSpec-extended
Manual change workflows	✓ 11 commands	✓ (via --with-core)
Autonomous implementation	✗	✓ 7-phase loop
Specialized agents	✗	✓ 3 agents
Utility skills	✗	✓ 6 skills

Key additions:

• Autonomous workflow — Run end-to-end implementation without manual intervention
• Specialized agents — Analyzer (0.1 temp), Builder (0.4 temp), Maintainer (0.3 temp)
• Utility skills — Concepts, modify artifacts, review artifacts, changelogs, test compliance, AI docs

Requirements

• OpenSpec v1.2.0+ (recommended)
• Bash 3.2 or higher

Installation

Quick Install

curl -sSL https://raw.githubusercontent.com/amauryconstant/openspec-extended/main/install.sh | bash

Specific Version

VERSION=v0.18.2 curl -sSL https://raw.githubusercontent.com/amauryconstant/openspec-extended/main/install.sh | bash

System-wide Install

PREFIX=/usr/local curl -sSL https://raw.githubusercontent.com/amauryconstant/openspec-extended/main/install.sh | bash

From Source (Development)

git clone https://github.com/amauryconstant/openspec-extended.git
cd OpenSpec-extended
export PATH="$PWD/bin:$PATH"

Verify

openspec-extended --version
# openspec-extended 0.14.0

Setup in Your Project

cd your-project

# Install extension resources
openspec-extended install opencode

# Include core OpenSpec workflows (11 commands)
openspec-extended install opencode --with-core

Verify Installation

ls .opencode/{skills,agents,commands,scripts}/

Usage

Installing Resources

Command	Description
openspec-extended install opencode	Add missing resources (skip existing)
openspec-extended install claude	Same for Claude Code
openspec-extended install opencode --with-core	Include 11 core OpenSpec workflows
openspec-extended update opencode	Force update all (overwrite existing)

Extension Skills

Skill	Purpose
osx-concepts	Teaches AI agents about OpenSpec framework
osx-modify-artifacts	Modifies artifacts with dependency tracking
osx-review-artifacts	Reviews artifacts for quality and completeness
osx-generate-changelog	Generate changelogs (Keep a Changelog format)
osx-review-test-compliance	Review test coverage for OpenSpec changes
osx-maintain-ai-docs	Maintain AGENTS.md and CLAUDE.md

Specialized Agents

Agent	Purpose	Tools	Temp
osx-analyzer	Review, verify, reflect	read, grep, glob, bash	0.1
osx-builder	Implementation	read, grep, glob, bash, write, edit	0.4
osx-maintainer	Docs, sync, archive	read, grep, glob, bash, write, edit	0.3

Autonomous Workflow

7-phase loop for end-to-end implementation via osx-orchestrate.

Commands

Command	Phase	Description
/osx-phase0	Review	Analyze existing artifacts
/osx-phase1	Build	Implement tasks
/osx-phase2	Verify	Verify implementation
/osx-phase3	Docs	Update documentation
/osx-phase4	Sync	Sync with upstream
/osx-phase5	Reflect	Self-assessment
/osx-phase6	Archive	Archive completed change

Usage

# Run autonomous implementation
.opencode/scripts/osx-orchestrate <change-name>

# With options
.opencode/scripts/osx-orchestrate add-auth --max-phase-iterations 20 --verbose
.opencode/scripts/osx-orchestrate add-auth --from-phase PHASE3
.opencode/scripts/osx-orchestrate add-auth --dry-run

Options

Option	Description
--max-phase-iterations N	Max retries per phase before failing (default: 10, -1 for unlimited)
--timeout N	Timeout in seconds
--model MODEL	Specify model to use
--verbose	Enable verbose output
--dry-run	Show what would happen
--force	Force operation
--clean	Clean state before starting
--from-phase PHASEX	Start from specific phase
--list	List available phases
--version	Show version

State Files

Located in openspec/changes/<change>/:

File	Purpose	Lifecycle
state.json	Phase tracking	Deleted on success
complete.json	Completion marker	Deleted after validation
iterations.json	Iteration history	Archived
decision-log.json	Agent reasoning	Archived

After PHASE6 (Archive), files move to openspec/changes/archive/YYYY-MM-DD-<change>/.

Project Structure

OpenSpec-extended/
├── bin/openspec-extended   # CLI installer
├── install.sh              # Installation script
├── openspec-core/          # Core workflows (synced from upstream)
├── resources/
│   ├── opencode/           # OpenCode resources
│   │   ├── skills/         # 6 extension skills
│   │   ├── agents/         # 3 agent definitions
│   │   ├── commands/       # Phase commands + osx-* utilities
│   │   └── scripts/        # osx-orchestrate + lib/
│   └── claude/             # Claude Code resources (same structure)
└── research/               # Platform documentation

Contributing

1. Fork the repository
2. Create a feature branch
3. Make changes (follow code style in AGENTS.md)
4. Run mise run test before submitting
5. Open a pull request

License

MIT License - see LICENSE file