Skip to main content

Skip docs navigation
manual page/ Tutorial

Review

sourceSource: suspec/docs/tutorial/03-review.mdModified: 2026-07-14

Run sus-review in an independent context. It reruns the requirement command, drafts assessments, asks the human for the decision, and writes:

example.txt

file
~/.agents/artifacts/shop-api/checkout-expiry-review.md

example.md

file
---
type: review
id: REVIEW-checkout-expiry
spec: SPEC-checkout
pr: none yet
reviewer: fresh-review-session
decision: pending
---

# Review: Expired checkout session returns 409

## Changed files

- `src/checkout/expiry.ts`
- `src/api/errors.ts`
- `test/integration/expired-session.test.ts`

## Requirement coverage

| ID     | Assessment | Evidence                                                                    |
| ------ | ---------- | --------------------------------------------------------------------------- |
| AC-001 | Supported  | `npm run test:integration -- expired-session` -> `Tests: 3 passed, 3 total` |

```verify id=AC-001 cmd="npm run test:integration -- expired-session" result=pass
Tests: 3 passed, 3 total
```

Check the taskless review:

command
suspec check ~/.agents/artifacts/shop-api/checkout-expiry-review.md \
  --spec ~/.agents/artifacts/shop-api/checkout-expiry-spec.md

The structured command must match the spec. Empty or stale evidence is Unverified. The checker reports facts. The human selects Accept; the workflow changes decision to accepted.

Next: close.

Need a starting point? Install the skills