# Two stories

The [example repository](https://github.com/spec-family/example) is a lending library small enough
to read in a few minutes, kept to its documents by the four tools. Two
stories show what they catch. Each is played by the example's own
`npm run demo`, in a throwaway copy of the repository, with the releases this
site pins; each is also a pull request in the example, left open and red in
CI for that story alone.

## A write refused

A brief protects the loan record. The agent's write there is refused before
it is made; its write through the shell is not, and the audit finds it at
the end of the round. [Read the story](https://spec-family.github.io/stories/write-refused/index.md), or its
[pull request](https://github.com/spec-family/example/pull/2).

## A claim without evidence

A promise marked `Implemented` with no test behind it, a roadmap item ticked
for a commit that was never made, and agent instructions that name a file
that is not there. CI is red on each.
[Read the story](https://spec-family.github.io/stories/claim-without-evidence/index.md), or its
[pull request](https://github.com/spec-family/example/pull/3).

## Play them yourself

```sh
git clone https://github.com/spec-family/example.git
cd example
npm ci
npm run demo
```

It needs Node 22 or later and git. `npm run demo` changes nothing in
the checkout and takes a few seconds; the example's
[README](https://github.com/spec-family/example/blob/77b504ff1625988557b2767356b68d4a40f09a8c/README.md) tells both stories as they play there.

---

This is the Markdown version of https://spec-family.github.io/stories/. Every command's output in it is printed by spec-brief 0.15.0, spec-graph 0.26.0, spec-guard 0.35.0 and spec-harness 0.26.0 in the site's CI; [llms.txt](https://spec-family.github.io/llms.txt) lists every page.
