Claude-Session: https://claude.ai/code/session_01ScFn54FhBq3cvVbcbQJjBZ Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| release | ||
| smoke | ||
| gotchas.md | ||
| PROFILE.md | ||
| profile.toml | ||
| README.md | ||
| triage.md | ||
.maintainer
Maintainer profile read by the oss-maintainer plugin for Claude Code and Codex. It holds what the maintenance workflows of this repository need and cannot derive. It is not a list of people; see docs/7-DEVELOPMENT/maintainer-guide.md.
Each fact has one home: executable commands are documented in the Makefile or AGENTS.md
and profile.toml invokes them by their canonical form (the same invocations CI runs — a gate
never mutates the tree, so the validator runs ruff check . without --fix) rather than
re-implementing them; profile.toml holds the fields the plugin reads; release/runbook.md
holds the release sequence and policy; .github/RELEASE_PROCESS.md holds the human release
process and its known gotchas; gotchas.md holds the lessons outside the release. Other files
link to those instead of repeating them.
| File | Purpose |
|---|---|
profile.toml |
the fields the plugin reads (schema v1) |
PROFILE.md |
scope, tone, what must never be cited in public |
gotchas.md |
fragile areas and known issues, fed by retros |
triage.md |
triage rules specific to this repository |
release/runbook.md |
the release sequence and policy |
release/test-matrix.md |
the recurring risks, seed of each release's coverage table |
smoke/journey.md |
the product journey the smoke test executes |
profile.local.toml |
gitignored local preferences (upstream checkouts, URLs) |
state/ |
gitignored run records and reports |