open-notebook/.maintainer
2026-10-03 01:22:27 +00:00
..
release chore: add the oss-maintainer profile under .maintainer/ (#1351) 2026-09-30 22:31:39 -03:00
smoke chore: add the oss-maintainer profile under .maintainer/ (#1351) 2026-09-30 22:31:39 -03:00
gotchas.md chore(maintainer): record that ADR numbers are assigned at merge (#1413) 2026-10-03 01:22:27 +00:00
PROFILE.md chore: add the oss-maintainer profile under .maintainer/ (#1351) 2026-09-30 22:31:39 -03:00
profile.toml chore: add the oss-maintainer profile under .maintainer/ (#1351) 2026-09-30 22:31:39 -03:00
README.md chore: add the oss-maintainer profile under .maintainer/ (#1351) 2026-09-30 22:31:39 -03:00
triage.md chore: add the oss-maintainer profile under .maintainer/ (#1351) 2026-09-30 22:31:39 -03:00

.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