exclude-wiki-Codex-md-from-harness-line-limit-hook

Exclude wiki AGENTS.md files from harness line-limit hook

Use this when a commit is blocked by .Codex/hooks/check-Codex-md-limits.sh after editing wiki-domain AGENTS.md files under knowledge/wikis/.

Problem

Workspace-hub has a hook intended to enforce short harness adapter docs (AGENTS.md, AGENTS.md, etc.). The hook pattern is too broad and also matches wiki schema/config files generated by llm-wiki init, which are often ~90+ lines.

Typical symptom:

• a commit touching knowledge/wikis/<domain>/AGENTS.md fails even for a tiny valid edit
• the hook treats those files like top-level harness adapter files with a strict line cap

Root cause

In .Codex/hooks/check-Codex-md-limits.sh, the staged-file filter matches all AGENTS.md paths:

HARNESS_PATTERN='(^|/)?(Codex|MEMORY|AGENTS|GEMINI)\.md$'
STAGED=$(git diff --cached --name-only --diff-filter=ACMR 2>/dev/null | grep -E "$HARNESS_PATTERN" || true)

That unintentionally includes knowledge/wikis/**/AGENTS.md.

Minimal safe fix

Exclude wiki-generated Codex files from the staged-file set:

STAGED=$(git diff --cached --name-only --diff-filter=ACMR 2>/dev/null | grep -E "$HARNESS_PATTERN" | grep -v '^knowledge/wikis/' || true)

When this fix is appropriate

Apply it when:

1. the blocked files are under knowledge/wikis/
2. they are wiki schema/config files, not harness adapter files
3. the commit only needs normal wiki-context updates (for example adding architecture context links)

Do NOT apply this as a blanket exemption for unrelated AGENTS.md files elsewhere.

Recommended workflow

1. Confirm the blocked files are only wiki Codex files.
2. Check what is already staged with git diff --cached --name-only.
3. Patch .Codex/hooks/check-Codex-md-limits.sh with the exclusion above.
4. Commit carefully:
   • if the wiki files are already staged from the failed attempt, the hook-fix commit may also include those files unless you unstage them first
   • if you want two separate commits, run git restore --staged <wiki-files> before committing the hook fix
   • if a bundled commit is acceptable, document that the hook fix and blocked wiki-file cleanup landed together
5. Re-run or finish the intended commit/push flow as needed.
6. Post a short GitHub follow-up comment if the cleanup was tied to a closed issue.

Why this is reusable

This is not a one-off content bug; it is a structural mismatch between:

• short harness adapter docs
• long wiki schema/config docs generated under knowledge/wikis/

Any future edits to wiki AGENTS.md files can hit the same false positive unless the hook excludes them.

Example outcome

This fix was used successfully when closing residual work from #2104, where two wiki AGENTS.md files already had the correct architecture-context lines in the working tree but could not be committed because of the false-positive line-limit hook.