# Per-file word-count overrides for ai/tools/docs_check.py (DOC002).
# Format: <repo-relative path> = <max words>
# These are pre-existing documents whose size predates the Scribe Coding migration
# (2026-08-03) — listed here rather than split, to avoid losing content during a
# structural reorganization. See docs/technical/01-documentation-conventions.md for
# the sprawl-control policy new documents should follow.

docs/CHANGELOG.md = 3000
# ^ lowered 2026-08-20 from 6500. The 6000 -> 6500 bump on 2026-08-06 was a stopgap taken
# because changelog_rotate.py could not run; that is fixed (see W-034), so the ceiling no
# longer has to absorb what rotation was supposed to remove. This file's job is to be
# readable; the archive keeps everything, indexed.
# Measured, not estimated: the first rotation at this ceiling archived 11 entries and left 10
# live, holding two days of a heavy session. A quiet week fits comfortably; a session like
# 2026-08-20's does not. If rotation starts firing mid-session, that is the signal the entries
# are too long, not that the ceiling is too low — check them against 01-documentation-
# conventions.md before reaching for a bump.

docs/archive/CHANGELOG-2026-07.md = 12500
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-03.md = 3000
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-04-early.md = 1200
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/discussions/discussion-log.md = 5500
docs/plans/next-steps.md = 2200
# docs/requirements/02-build.md — override RETIRED 2026-09-03, one day after it was added.
# The 2350 bump admitted BR-BUILD-019 and BR-BUILD-016's rewritten frappe clause (ADR-077);
# Brian called for the split instead. The bump note guessed "Private github.com apps" (486
# words) was the section to move. Measurement said otherwise: "Cache & tagging" was 887 words,
# 39% of the file and nearly double the guess, so that moved to 02a-build-tagging.md. Same
# lesson the 06-cli.md split recorded below — measure the sections, do not guess which one
# grew. The spine is ~1419 words and 02a ~1011; neither needs an entry.

docs/requirements/03-deploy.md = 2900
# ^ bumped 2026-08-06 -> 2900 on 2026-08-18 to admit BR-DEPLOY-024 (the maintenance hold,
# ADR-073). Unlike the grandfathered entries above, this is growth from NEW content, not
# pre-migration size. Flagged for Brian: this doc and 06-cli.md both hit their ceilings in
# the same change, which is the signal a split is due rather than another bump.
# ^ bumped 2026-08-04 for BR-DEPLOY-004/009/009a's promotion-is-proof-not-assertion rewrite
# (ADR-052); bumped again 2026-08-05 for BR-DEPLOY-003b (convergence verified against the
# running container, not the local image store — W-022).
# Bumped 2026-08-08 (2600 -> 2700) for BR-DEPLOY-023 (the cairn-adopt-owned marker) and
# BR-DEPLOY-006's rewrite to a concrete selection rule (ADR-072); real requirement growth,
# already trimmed once for size before this bump.
# docs/requirements/06-cli.md — override RETIRED 2026-08-18. The file was split: sections A
# and B moved to 06a-cli-build.md and 06b-cli-adopt.md, leaving the spine at ~2198 words,
# under the 2200 default. This is the review the retired ceiling was designed to trigger —
# it was set to trip before ~4500 rather than at it, and it worked. It guessed section E
# (shared conventions) would be the one to move; measurement pointed at A and B instead,
# role-specific content having grown to 57% of the file. Neither new file needs an entry.

docs/technical/05-implementation-index.md = 2300
# ^ bumped 2026-08-06 for the "Owned Docker recipe" row's recipe-trim + ADR-068 note — an
# inventory of the whole project's implementation state grows with the project, not sprawl.
docs/technical/ABOUT_GHCR.md = 3500
docs/technical/high-level-motivations-and-workflows.md = 2000
docs/archive/CHANGELOG-2026-08-04.md = 3500
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-04-to-2026-08-05.md = 3600
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.

docs/adr/073-target-stack-lifecycle-and-a-maintenance-state.md = 2600
# ^ 2026-08-18. Unusually long for an ADR because it carries a live investigation and two
# withdrawn claims kept visible on purpose (the rendered-gitops guess, and the AI inference
# that ADR-074 made an on-disk .env permanent). Splitting is the wrong tool for a decision
# record — one decision, one file — so the ceiling moves instead. Trim the superseded
# exploratory sections once the decision has been implemented and the history stops earning
# its space.
docs/archive/CHANGELOG-2026-08-05-to-2026-08-06.md = 3000
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-06.md = 2300
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-06-to-2026-08-18.md = 3000
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-18-to-2026-08-19.md = 5700
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-08-19-to-2026-08-20.md = 1800
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.

docs/open/OPEN_WORK.md = 4400
# ^ 2026-09-29: doubled from the 2200 default at Brian's direction, after W-041 and W-042
# pushed the file over and their detail was trimmed twice to fit. Note this file's own
# standing rule, which is the intended size control: `done` rows are swept to
# docs/archive/OPEN_WORK-done.md once a completion judgment is recorded in
# docs/technical/05-implementation-index.md. W-034, W-035, W-036 and W-037 are `done` and
# awaiting that sweep; the ceiling is a backstop, not a substitute for it.
docs/archive/CHANGELOG-2026-08-20.md = 1500
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
docs/archive/CHANGELOG-2026-09-02-to-2026-09-28.md = 2000
# ^ archived-for-size, not sprawl — frozen content, headroom is just slack, not an
# invitation to keep adding to it.
