Skip to main content
Suspec
manual page/ Tutorial

Tutorial: first loop

sourceSource: suspec/docs/tutorial/README.mdModified: 2026-06-30
Sections
3
Format
Markdown
Order
11 / 156

Walk one small change through Suspec:

code
Pull -> Spec -> Task -> Run -> Review -> Close

You will create:

  • intake/checkout-expiry.md
  • specs/checkout/spec.md
  • tasks/checkout-expiry.md
  • a task run summary
  • reviews/checkout-expiry.md
  • findings/session-expiry-is-409.md
  • an updated status.md

Scenario

Requirement:

A checkout session older than 30 minutes must return 409 SESSION_EXPIRED, never a 5xx.

This uses the fictional shop-api from the examples. The Suspec artifacts are real; the code and test command are illustrative.

Run the same loop on your own repo for executable proof.

Pages

  1. Pull and Spec
  2. Task and Run
  3. Review
  4. Close

Prerequisites

  • a Suspec workspace from Adopting Suspec
  • an agent or human worker
  • a code repo for your real run

Starter kit: Set up a workspace