AGENTS.md@docs/product · diff
git:20260910.2833d9d to git:20260910.0b75130
3 added, 0 removed. Audit A to A.
# AGENTS.md — `docs/product/`
Applies to `docs/product/`. Inherits the root `AGENTS.md`. Scope-specific deltas only.
## Regenerate `/now/` with the changelog change
The public `/now/` page is projected from the `### Highlights` blocks of
released sections in `changelog.md`. When you add or edit one, regenerate the
projection in the same change and commit both files:
```bash
python3 tools/build-site.py --journeys-only # writes web/src/lib/now-highlights.generated.json
python3 -m pytest tools/test_build_site_routing.py -k now -q
```
+ Write each highlight as a `-` bullet. The parser extracts only bullets, so a
+ paragraph is dropped silently and the staleness check above still passes.
+
A changelog edit committed without the regenerated JSON fails
`test_the_committed_now_projection_matches_the_changelog_source` with
``web/src/lib/now-highlights.generated.json is stale — run `python3
tools/build-site.py --journeys-only` ``.
`changelog.md`'s own header owns how to write a highlight and which releases
owe one; [`packs/AGENTS.local.md`](../../packs/AGENTS.local.md) owns the pack
release pipeline that records that decision.