kandev/docs/plans/release-feature-toggles/task-03-document-release-toggle-workflow.md

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

id	title	status	wave	depends_on	plan	spec
03-document-release-toggle-workflow	Document release-toggle workflow	completed	2	01-centralize-backend-bindings 02-consolidate-frontend-contract	plan.md	../../specs/feature-toggles/spec.md

Task 03: Document release-toggle workflow

• Acceptance: Architecture, contributor, operator, and agent guidance agree on install-wide ownership, all-profile default-off rollout, authoritative entry-path gates, one default-on kill-switch release, removal, and key non-reuse.
• Acceptance: Documentation names the streamlined declaration sites and no longer lists graduated/duplicated flags or obsolete backend paths.
• Acceptance: The unused E2E helper for the graduated unread-divider flag is removed, and public-doc validation passes.
• Verification: Run node --test scripts/validate-public-docs.test.mjs, node scripts/validate-public-docs.mjs, and git diff --check from the repo root.
• Files likely touched:
  • docs/decisions/0007-runtime-feature-flags.md
  • docs/decisions/0018-runtime-settings-overrides.md
  • docs/public/configuration.md
  • docs/public/extending-kandev.md
  • AGENTS.md
  • apps/web/e2e/tests/settings/feature-toggles-helpers.ts (remove)
• Dependencies: Tasks 01 and 02, so the documented add/remove steps match the landed implementation.
• Parallelism: sequential; it reconciles both prior task outputs.
• Inputs: Feature Toggles spec; ADR-0007, ADR-0018, and ADR-2026-08-01-release-toggle-gating-contract; Docs Maintainer guidance.
• Output contract: Report changed/removed files, exact validation commands and counts, security/trust impact (None expected), external side effects (None expected), then update this task and plan.md statuses/results in the same conversation.

Results

• Updated ADR-0007, public configuration/extending docs, and root agent guidance with install-wide ownership, fail-closed entry paths, staged rollout, kill-switch retention, removal, and retired key/environment non-reuse.
• Added the release-toggle contract ADR and indexes, and removed the orphaned unread-divider feature-toggle E2E helper.
• Verification: node --test scripts/validate-public-docs.test.mjs passed (58 tests); node scripts/validate-public-docs.mjs validated 41 pages; git diff --check passed.
• Security/trust impact: none; docs clarify existing boundaries.
• External side effects: none.
• Review verification: public-doc tests passed (58 tests), validation covered 41 published pages, and git diff --check passed.