Spec-DrivenGuide

Conventions and standards for developers and agents

Build with Staff DNA

5 Steps

A practical workflow for every development cycle.

1

1. SPEC

THE CONTRACT

Write down what you're building and why. No code until there's a clear agreement.

2

2. PLAN

THE STRATEGY

Break the work into ordered steps. Small and clear enough that anyone can follow.

3

3. CODE

THE EXECUTION

Follow the plan. Write what was agreed, nothing more.

4

4. TEST

THE VERIFICATION

Check that what was built matches what was agreed. Catch problems before they ship.

5

5. END

THE DELIVERY

Close the cycle: update the changelog, sync the backlog, and move on.

Agent Execution

What your agent does, step by step, on each phase.

SPEC

THE CONTRACTMode: Planning

5 steps

PLAN

THE STRATEGYMode: Planning

6 steps

CODE

THE EXECUTIONMode: Fast

4 steps

TEST

THE VERIFICATIONMode: Fast

5 steps

END

THE DELIVERYMode: Planning

7 steps

Agent Commands

Start the right workflow with a simple text prefix.

Landing

/sdg-land

Define your project's vision and scope before writing the first line.

Feature

/sdg-feat

Walk through SPEC → PLAN → CODE → TEST → END for any new feature.

Bug fix

/sdg-fix

Diagnose the root cause, fix it, and confirm nothing else broke.

Close the cycle

/sdg-end

Summarize what was done, update the changelog, and commit.

Documentation

/sdg-docs

Write ADRs, changelogs, and technical specs with the right template.

Audit

/sdg-audit

Check if governance rules are applied to the project and get an actionable correction plan.

Harness Engineering

Persistent memory for AI agents.

Core Context

Architecture & Decisions

Context, technology, and tactical decisions.

Learned Lessons

Accumulated Experience

Lessons learned and best practices.

Pending Actions

Next Steps

Current state, pending tasks, and delivery.

Resilience Log

Technical History

Root Cause Analysis (RCA) and failure history.

Impact Map

Blast-Radius Filter

Changed files, blast-radius imports, and tests at risk.

Context Builder

Generate your agent's starting instructions in a few clicks.

Context Builder

Step 1/4: Architecture Flavor

Architecture Flavor

Architecture FlavorPick the architecture pattern that fits your project.

Spec-DrivenGuide

5 Steps

1. SPEC

2. PLAN

3. CODE

4. TEST

5. END

Agent Execution

SPEC

PLAN

CODE

TEST

END

Agent Commands

Landing

Feature

Bug fix

Close the cycle

Documentation

Audit

Harness Engineering

Core Context

Learned Lessons

Pending Actions

Resilience Log

Impact Map

Context Builder

Context Builder

Architecture Flavor

LITE

Vertical Slice

MVC

Legacy