Bring grandfathered docs and comments under catalog hooks #46

New issue

Closed

opened 2026-08-06 00:30:26 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-08-06 00:30:26 +00:00

Member

Context

The v0.193.0 catalog hooks scan the whole tracked tree on every commit. Existing long-form source comments and two oversized architecture docs predate those limits, while generated pkg/README.md is currently included by the dead-link walker.

Work

split docs/galaxy-rust.md and docs/processes-events.md into focused pages under the standard caps
migrate durable source explanations into those docs and shorten inline blocks
remove the exact [tool.agentic-os.*] grandfathering entries as each file is cleaned
keep generated pkg/** excluded from repository documentation walks

Done when

ward exec precommit passes without documentation-layout or code-comments grandfathering for tracked source files.

## Context The v0.193.0 catalog hooks scan the whole tracked tree on every commit. Existing long-form source comments and two oversized architecture docs predate those limits, while generated `pkg/README.md` is currently included by the dead-link walker. ## Work - split `docs/galaxy-rust.md` and `docs/processes-events.md` into focused pages under the standard caps - migrate durable source explanations into those docs and shorten inline blocks - remove the exact `[tool.agentic-os.*]` grandfathering entries as each file is cleaned - keep generated `pkg/**` excluded from repository documentation walks ## Done when `ward exec precommit` passes without documentation-layout or code-comments grandfathering for tracked source files.