All Agents
Spec
Operations · Software Architect

Spec : Software Architect

Spec designs systems before Engine codes. Database schemas, API contracts, tech stack, project analysis. Eliminates false starts by front-loading the thinking.

Why Spec

The benefit of running Spec

Three outcomes you get the week Spec turns on. Not features, not roadmap items: actual results your team will feel.

No false starts

Architecture mapped before code is written. Rework drops to near-zero.

Database you won't regret

Schema normalized, indexed, migration strategy defined day 1.

Stack choice backed by reasoning

Not trend-chasing. The right framework for THIS project, with a written why.

What Spec Does

4 jobs, one agent

Every capability below is in production today. No roadmap items, no coming-soons.

System architecture

Component diagrams, data flow, service boundaries, before a line of code is written.

Database schema design

Normalization, indexes, constraints, migration strategy.

API contract design

REST or GraphQL endpoints, request/response schemas, error handling.

Project analysis

Reads existing codebases and produces implementation specs Engine executes against.

Tech stack

What Spec plugs into

Spec does not replace what you already use. It routes through the tools your business lives in.

Claude workflow v2Designing-architecture, designing-apis, database-design
OpenAPIAPI specs
ERD toolsSchema diagrams
Live Sample

A real Spec run, end to end

What you actually see when Spec runs. Example output below; all data fabricated for illustration, no real clients shown.

spec@systemshift-hq ~ spec architect --project 'client-portal-v2' --stack nextjs-postgres-prisma
$ spec architect --project 'client-portal-v2' --stack nextjs-postgres-prisma
[00:00] Codebase analysis: 3 existing services mapped
[01:40] ERD drafted: 9 entities, 14 relations
[03:22] API contract: 23 endpoints, request/response schemas
[04:58] Integration points: GHL webhook, Stripe, Clerk auth
[05:40] Implementation plan: 3 sprints, 47 tasks
- Spec delivered: spec.md (18 pages) + erd.mmd + api.yaml
Engine can execute without clarification
$
Works with

Spec runs with 6 teammates

No agent works alone. Spec feeds into, and pulls from, these agents in every workflow.

FAQ

Quick answers

When should I use Spec?

Before any non-trivial backend build. Spec saves days of rework.

Does Spec write code?

No. Spec writes specs. Engine writes code.

Output format?

Markdown spec docs with diagrams, schemas, and implementation checklists.

Put Spec to work today

Deploy free from the Starter Kit in under 30 minutes. Prefer a full setup done for you? Book a strategy call and we'll map Spec to your biggest bottleneck.

View All 50 Agents →