spectre
Star on GitHub Install

Spectre directs your attention where it counts.
Your Agents do the rest.

Build features end to end with Spectre's six-phase agentic engineering workflow designed from the ground up to focus your time & effort where it matters the most.

For Claude Code & Codex · Free & MIT

See how it works
For Claude Code & Codex

Designed to build medium to large features — end to end.

Spectre guides you from scope to PR with a crafted six-phase workflow. Every gate, artifact, and handoff is designed to efficiently pass the exact right context where its needed to deliver high quality results.

Human & agent

Focus your time, taste, and judgment where it matters most.

Spectre is designed specifically so each point of human leverage is maximally utilized. You own the scope, UX, technical design, and final sign off. Agents research, tee up topics, iterate with you until the idea is crisp, then build, validate, and prove. You make the high impact decisions, Agents collaborate.

Crafted collaboration

Meticulously crafted interactions — human & agent, agent & subagent; model & model

Every handoff is designed. Iteration gates where you collaborate until aligned. Review gates where you approve to proceed. Adversarial reviews between agents that keep each other honest — no blind trust, just verified output.

The workflow

Six phases, from scope to learn.

Iteration gates where you collaborate until aligned; Review gates where you approve to proceed; meticulously orchestrated subagents workflows in between that provably deliver the scope.

01 Scope

In, out, future, anti-scope — until the edges are crisp. If the experience is fuzzy, define user flows & prototype UI first.

/spectre:scope
SCscope.md.spectre/features/notifications/

In-app notifications for teams

In: inbox, unread, mark-read · Out: email/push (future) · Anti-scope: no prefs UI this phase.

Iteration gate — agent probes, asks, restates iteratively until shape is aligned. Same in UX.

scope.mdux.md
Iteration gate — restate until alignedNext → /spectre:plan

02 Plan

Agent researches the codebase, structures a design, probes and restates with you — then a review gate. You approve the high-level design before tasks exist.

/spectre:plan
PLplan.md + tasks.json + /goalspecs/

3 waves · 9 tasks — you approve the design

Wave 1  T-01 inbox model + API · T-02 team scoping
Wave 2  T-03 counts · T-04 mark-read · T-05 inbox UI
Wave 3  T-06 batching · T-07 retention

Plan writes goal-prompts.md — paste /goal to start.

plan.mdtasks.jsongoal-prompts.md
Iteration → Review gateNext → copy /goal

03 Execute

Autonomous stretch — subagents build in parallel with only the context they need. Meticulously orchestrated, verified per wave, opposite-runtime review at the end. You don’t babysit.

/spectre:execute · /goal
EXWave execution3 / 9 · live
T-03 unread counts     ● in progress  @spectre:dev
T-04 mark-read         ○ pending
completed  T-01 T-02  ✓ verified
execution_state.md
Spectre suggests the next stepNext → /spectre:proof

04 Prove

Not just passing tests, passing experiences. Your Agent uses the product like a user, and proves it works with screenshots, video, and a visual artfiact for your review.

/spectre:proof
PRproof.htmlreviewed evidence

6 / 6 criteria · reviewed

New notification appears · unread matches · mark-read persists · batching coalesces · empty states clear.

screenshots · video · logs · proof.json

proof.html
Review gate — approve evidenceNext → /spectre:ship-it

05 Ship

Clean up dead code and find duplication, fill risky test gaps, rebase, and open a high-quality PR. The final 5%, one command.

/spectre:ship-it
SHPull requestfeat/notifications

feat: team notifications — ready for review

Dead code pruned · 4 behavioural tests added · rebased clean.

PR #482 · 9 tasks · 6 criteria · lint clean
Review gate — approve PR & mergeNext → /spectre:learn

06 Learn

Turn what you built into knowledge skills your agents automatically load when relevant. Better context, better results.

/spectre:learn
LNknowledge — durable~/.spectre/projects/…/knowledge/

What this build taught the project

Not notes. A loadable record: the gotcha, decision, or pattern that would otherwise cost debug time next session.

feature-notifications-dossier  ·  gotchas-retention-idempotency
patterns-inbox-batching  ·  decisions-postgres-over-sqlite

Search → load by exact ID → update or create → approve → register. Injected at SessionStart, loaded only when subject + use condition match.

knowledge/…/SKILL.mdreferences/
Compounds — future sessions load thisDone ✓

Install as Claude Code or Codex plugins.

Choose your agent and add Spectre in two commands.

Claude Code

$ /plugin marketplace add joenandez/spectre
$ /plugin install spectre@spectre

Codex

$ codex plugin marketplace add joenandez/spectre
$ codex plugin add spectre@spectre
Your first feature

One command to start.

Claude Code/spectre:scope
Codex$spectre-scope

Use the command for your agent to scope your first feature.

Copied