kandev/docs/plans/release-pr-queue-bypass/task-02-release-documentation.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
02-release-documentation	Document the Stable release bypass	done	2	01-release-workflow	plan.md	../../specs/release-pr-queue-bypass/spec.md

Task 02: Document the Stable release bypass

Acceptance

• Maintainer documentation states the token permissions, owner requirement, expiration, rotation, environment configuration, and administrator bypass.
• Repository guidance explains that ordinary pull requests still use the merge queue and required CI.
• The repair spec is shipped, and the ADR matches the implemented token boundary.

Verification

• node --test scripts/validate-public-docs.test.mjs
• node scripts/validate-public-docs.mjs
• python3 scripts/lint-harness-files.test.py
• python3 .github/scripts/lint-harness-files.py --all
• git diff --check -- docs/public/release-process.md docs/ci-merge-queue.md .agents/skills/release/SKILL.md AGENTS.md docs/specs/release-pr-queue-bypass/spec.md docs/specs/INDEX.md docs/decisions/2026-08-17-release-pr-ruleset-bypass.md docs/decisions/INDEX.md

Files likely touched

• docs/public/release-process.md
• docs/ci-merge-queue.md
• .agents/skills/release/SKILL.md
• AGENTS.md
• docs/specs/release-pr-queue-bypass/spec.md
• docs/specs/INDEX.md
• docs/decisions/2026-08-17-release-pr-ruleset-bypass.md
• docs/decisions/INDEX.md

Dependencies

Task 01 must pass before this task starts.

Parallelism

Sequential. The documents record the workflow contract from Task 01.

Inputs

• The implemented workflow and contract from Task 01.
• docs/specs/release-pr-queue-bypass/spec.md.
• ADR 2026-08-17-release-pr-ruleset-bypass.
• The existing how-to structure of the release page.

Output contract

Report the documentation class, changed files, validator results, and external rollout requirements. Update this task and plan.md in the same conversation.

Results

• Public docs updated: docs/public/release-process.md remains a how-to guide and now includes the PAT creation and rotation procedure.
• Internal docs updated: docs/ci-merge-queue.md, .agents/skills/release/SKILL.md, AGENTS.md, the repair spec, and the ADR.
• node --test scripts/validate-public-docs.test.mjs passed 61 tests.
• node scripts/validate-public-docs.mjs validated 41 pages.
• python3 scripts/lint-harness-files.test.py passed 19 tests.
• python3 .github/scripts/lint-harness-files.py --all passed 118 files.
• pre-commit run harness-lint --files AGENTS.md .agents/skills/release/SKILL.md passed.
• git diff --check passed.