# Regeneration log — 01-add-verbose-flag

| Field | Value |
|-------|-------|
| Last regenerated | 2026-05-01 |
| ultraplan-local version | 3.1.0 |
| Claude Code version | ≥ 2.1.105 (PreCompact-hook) |
| Source brief author | Hand-calibrated example, not LLM-generated |
| Plan author | Hand-calibrated to demonstrate plan_version 1.7 schema + manifest YAML |

## What this is

A complete walk-through of the four-stage pipeline for one realistic
small task: adding a `--verbose` flag to a hypothetical `small-auth`
CLI parser. Every artifact is hand-calibrated, not LLM-generated, so
fork-ers can study the *shape* without worrying about whether an
LLM hallucinated something.

## What "regenerate" means

If the artifact format changes (frontmatter schema, manifest YAML
keys, progress.json version), this example needs to be re-built so
fork-ers don't learn an obsolete shape.

Triggers for regeneration:

- `plan_version` bumps
- Frontmatter schema additions to `brief.md` or `research/*.md`
- New required keys in manifest YAML
- `progress.json` schema bump beyond `schema_version: "1"`

When regenerating: do **not** run an actual LLM-driven pipeline against
this brief. Hand-calibrate against the new schema so the example stays
deterministic and reviewable.

## Project assumed

A fictional `small-auth` CLI with this layout:

```
small-auth/
├── package.json
├── src/
│   ├── cli.mjs                    # 80-line argv parser (hand-rolled)
│   └── commands/
│       ├── login.mjs
│       ├── logout.mjs
│       ├── whoami.mjs
│       ├── token-refresh.mjs
│       ├── users-list.mjs
│       └── users-create.mjs
└── tests/                         # 24 tests, node:test
```

This project is **not** in the plugin repo. The example artifacts
reference it as if it were the cwd of an `/ultraexecute-local` run.
