spectacular

Spectacular

Spec-anchored development with automatic parallel execution for Claude Code.

Write a spec → generate a plan → execute tasks in parallel → get stacked PRs.

[!NOTE] /spectacular:execute requires git-spice for PR stacking. Support for Graphite coming soon!

Inspired and powered by Superpowers.

Why Spectacular

Installation

Prerequisites:

# Install git-spice (macOS)
brew install git-spice

See git-spice installation instructions for other platforms.

Install plugins:

# In Claude Code, install marketplaces and plugins
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
/plugin marketplace add arittr/spectacular
/plugin install spectacular@spectacular

Initialize your project:

/spectacular:init

Quick Start

Real example from developing spectacular itself:

1. Generate a spec

/spectacular:spec I can't use my main repo while spectacular is running, it locks everything up. I want each run isolated in its own worktree so I can keep working manually and run multiple features concurrently.

# Feature: Worktree Isolation for Spectacular Runs

## Problem Statement
Spectacular commands operate directly in the main repository:
- Cannot perform manual work during a spectacular run
- Cannot run multiple sessions concurrently
- No isolation between spectacular work and manual work

## Requirements
- FR1: Worktree creation in spec command
- FR2: Plan command operates in worktree
- FR3: Execute command uses worktree as base
...

## Acceptance Criteria
- [ ] Worktree created immediately after RUN_ID generation
- [ ] Spec committed to worktree branch
- [ ] Main repo working directory unchanged
...

2. Create a plan

/spectacular:plan @specs/dedf14-worktree-isolation/spec.md

## Execution Summary

- **Total Tasks**: 3
- **Total Phases**: 1
- **Sequential Time**: 12h
- **Parallel Time**: 5h
- **Time Savings**: 7h (58%)

## Phase 1: Command Worktree Integration

**Strategy**: parallel
**Reason**: All tasks modify different command files

### Task 1: Spec Command Worktree Integration
Files: commands/spec.md
Complexity: M (4h)

### Task 2: Plan Command Worktree Integration
Files: commands/plan.md
Complexity: M (3h)

### Task 3: Execute Command Worktree Integration
Files: commands/execute.md
Complexity: L (5h)

3. Execute

/spectacular:execute @specs/dedf14-worktree-isolation/plan.md

Time savings: 58% faster—parallel execution runs tasks simultaneously instead of sequentially.

The Parallel Execution Flow

Orchestrator
|
|-- 1. Read plan, identify 3 parallel tasks
|-- 2. Create worktrees
|       dedf14-task-1/
|       dedf14-task-2/
|       dedf14-task-3/
|
|-- 3. Spawn subagents IN PARALLEL
|       |
|       +-- Subagent 1 (spec.md)      +-- Subagent 2 (plan.md)     +-- Subagent 3 (execute.md)
|       |   * Fresh spec context      |   * Fresh spec context     |   * Fresh spec context
|       |   * Implement, test         |   * Implement, test        |   * Implement, test
|       |   * Commit to branch        |   * Commit to branch       |   * Commit to branch
|       |                             |                            |
|       +-----------------------------+----------------------------+
|                                     |
|-- 4. Collect results, stack branches: task-1 -> task-2 -> task-3
|-- 5. Code review, cleanup worktrees

4. Submit

gs stack submit

Result: 3 focused PRs instead of one large diff.