tegwick
09803dcc31
Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a15374-f59f-7a31-86d2-d23b5d2ed181
24 lines
1.3 KiB
Markdown
24 lines
1.3 KiB
Markdown
# Render orientation briefs without Git operations
|
|
|
|
Use the existing State Hub renderer independently of consistency writeback:
|
|
|
|
```sh
|
|
make brief-generate BRIEF_REPO_PATH=/path/to/repo BRIEF_REPO_SLUG=canonical-slug
|
|
make brief-check BRIEF_REPO_PATH=/path/to/repo BRIEF_REPO_SLUG=canonical-slug
|
|
```
|
|
|
|
The Python entry point is `scripts/generate_custodian_brief.py`; pass `--api-base`
|
|
or set Make's `STATE_HUB_API_BASE` for another endpoint. It performs only API reads
|
|
and writes `.custodian-brief.md` in generation mode. It never stages, commits,
|
|
pushes, or writes to the hub. Check mode exits nonzero on drift without writing.
|
|
Timestamp-only changes are ignored.
|
|
|
|
The brief describes the current hub read model, not the Git index. Sync authored
|
|
work records before expecting their changes in the brief. API requests are not
|
|
an atomic snapshot; inspect output if concurrent work is changing the hub.
|
|
Missing or malformed endpoint responses stop generation before writing. Symlink
|
|
targets are refused. Preserve any existing local changes before refreshing.
|
|
|
|
Review and stage the brief alongside the substantive source change that needs it.
|
|
The generated-only commit guard remains in force. This command does not install
|
|
an automatic brief hook or change existing consistency writeback defaults.
|