documentation-layout - per-repo AGENTS.md cap override, relocate doctrine to skills #84

New issue

Closed

opened 2026-05-28 03:22:02 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-05-28 03:22:02 +00:00

Owner

🤖 Filed by Claude Code on Kai's behalf.

Context

AGENTS.md trim work (follow-on to #81 / agentic-os-kai#370). The structural-move phase showed the file's irreducible floor exceeds the flat 4000-char cap once universal-fire doctrine and leak-critical SSM/secrets rules are kept inline. Decision: let a repo opt AGENTS.md into a larger cap, scoped per-repo, rather than a global basename exception.

Changes

agentic_os/config.py: new get_int_option(hook_id, key, default, repo_root) helper (rejects non-int and bool).
agentic_os/check_documentation_layout.py: caps_for() reads per-repo config keys agents_md_max_lines / agents_md_max_chars, defaulting to the standard Markdown cap. No global AGENTS.md blessing - a repo opts in via its own config, everyone else (including this repo's own small AGENTS.md) keeps 4000/80.
tests/test_config.py: 5 new tests for get_int_option (default, pyproject read, non-int reject, bool reject, hook-scoping). Suite: 28 passed.
.agents/skills/kai-git-workflow: now owns the base git workflow rules (relocated from agentic-os-kai AGENTS.md) plus Default TODO destination (Forgejo) and test-flake discipline; added a precedence note reconciling the older GitHub-tracker section.
.agents/skills/tooling-skill-authoring: gained a general documentation-discipline section (four biases, layout, code comments) relocated from AGENTS.md.

Relation to prior decisions

Partially revisits #83 (which reverted #82's loader-bound tier). Unlike #82's global basename tier, this is opt-in per-repo and only the canonical agentic-os-kai AGENTS.md opts in.

🤖 Filed by Claude Code on Kai's behalf.

> 🤖 Filed by Claude Code on Kai's behalf. ## Context AGENTS.md trim work (follow-on to #81 / agentic-os-kai#370). The structural-move phase showed the file's irreducible floor exceeds the flat 4000-char cap once universal-fire doctrine and leak-critical SSM/secrets rules are kept inline. Decision: let a repo opt AGENTS.md into a larger cap, scoped per-repo, rather than a global basename exception. ## Changes - `agentic_os/config.py`: new `get_int_option(hook_id, key, default, repo_root)` helper (rejects non-int and bool). - `agentic_os/check_documentation_layout.py`: `caps_for()` reads per-repo config keys `agents_md_max_lines` / `agents_md_max_chars`, defaulting to the standard Markdown cap. No global AGENTS.md blessing - a repo opts in via its own config, everyone else (including this repo's own small AGENTS.md) keeps 4000/80. - `tests/test_config.py`: 5 new tests for `get_int_option` (default, pyproject read, non-int reject, bool reject, hook-scoping). Suite: 28 passed. - `.agents/skills/kai-git-workflow`: now owns the base git workflow rules (relocated from agentic-os-kai AGENTS.md) plus Default TODO destination (Forgejo) and test-flake discipline; added a precedence note reconciling the older GitHub-tracker section. - `.agents/skills/tooling-skill-authoring`: gained a general documentation-discipline section (four biases, layout, code comments) relocated from AGENTS.md. ## Relation to prior decisions Partially revisits #83 (which reverted #82's loader-bound tier). Unlike #82's global basename tier, this is opt-in per-repo and only the canonical agentic-os-kai AGENTS.md opts in. > 🤖 Filed by Claude Code on Kai's behalf.

coilysiren referenced this issue from a commit

2026-05-28 03:23:04 +00:00

feat(documentation-layout): per-repo AGENTS.md cap override

coilysiren closed this issue

2026-05-28 03:23:04 +00:00

coilysiren referenced this issue

2026-05-28 03:30:01 +00:00

agentic-os - uncommitted sweep verbs and untracked sweep scripts #86