feat(check-file-length): категория markdown (спека/доки) warn 500 / fail 700 #3

Merged

claude-secretary merged 1 commit from feature/spec-length into main

2026-06-12 18:38:22 +07:00

claude-secretary commented

2026-06-12 18:38:10 +07:00

Owner

Большие .md плохо читаются агентом за один проход (Read обрезает ~25k токенов / 2000 строк; русская проза ~15–25 ток/строку → ~700 строк потолок).

Что внутри

scripts/check_file_length.sh: новая категория по расширению *.md (путь не важен — работает во вложенных каталогах), пороги SPEC_WARN=500 / SPEC_FAIL=700 (env-override). Прочие категории (src/tests) и exclusions — без изменений.
Фикстуры fixtures/spec/{good(10),medium(550),huge(720)}.md + 3 smoke-кейса.
.pre-commit-hooks.yaml (name/description) и README.md (таблица порогов + пример files: '\.md$' / exclude: '^(docs/archive/|docs/interview/)') обновлены.

Проверено

bash fixtures/run_smoke.sh — all pass (26 кейсов), spec: good exit0, medium WARN exit0, huge FAIL exit1.
bash -n синтаксис OK. Self-review субагентом — APPROVE.

Consumer (baton) подключит вторым инстансом check-file-length на все .md кроме archive/interview + bump rev.

Большие `.md` плохо читаются агентом за один проход (Read обрезает ~25k токенов / 2000 строк; русская проза ~15–25 ток/строку → ~700 строк потолок). ## Что внутри - `scripts/check_file_length.sh`: новая категория по расширению **`*.md`** (путь не важен — работает во вложенных каталогах), пороги `SPEC_WARN=500` / `SPEC_FAIL=700` (env-override). Прочие категории (src/tests) и exclusions — без изменений. - Фикстуры `fixtures/spec/{good(10),medium(550),huge(720)}.md` + 3 smoke-кейса. - `.pre-commit-hooks.yaml` (name/description) и `README.md` (таблица порогов + пример `files: '\.md$'` / `exclude: '^(docs/archive/|docs/interview/)'`) обновлены. ## Проверено - `bash fixtures/run_smoke.sh` — all pass (26 кейсов), spec: good exit0, medium WARN exit0, huge FAIL exit1. - `bash -n` синтаксис OK. Self-review субагентом — APPROVE. Consumer (baton) подключит вторым инстансом `check-file-length` на все `.md` кроме archive/interview + bump rev.

claude-secretary added 1 commit

2026-06-12 18:38:10 +07:00

feat(check-file-length): категория markdown (спека/доки) warn 500 / fail 700

ci / smoke (push) Has been cancelled

Details

ci / smoke (pull_request) Has been cancelled

Details

6194ff7696

Большие .md плохо читаются агентом за один проход (Read обрезает ~25k
токенов / 2000 строк; русская проза ~15–25 ток/строку → ~700 строк
потолок). Добавлена категория по расширению *.md (путь не важен,
работает во вложенных каталогах), пороги SPEC_WARN=500/SPEC_FAIL=700
(env-override). Фикстуры spec/{good,medium,huge}.md + smoke-кейсы;
манифест/README обновлены. Прочие категории (src/tests) без изменений.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>