declare the small documentation band, once the hooks come up clean #116

New issue

Open

opened 2026-08-16 06:44:07 +00:00 by coilyco-ops · 1 comment

coilyco-ops commented

2026-08-16 06:44:07 +00:00

Collaborator

Every repo declares its documentation band rather than falling into one. The
change here is one line:

[tool.agentic-os.documentation-layout]
band = "small"

Caps for small: 40 lines / 3,000 chars per Markdown file, 20 docs/*.md.

Why this is an issue rather than a commit

pre-commit run --all-files fails on pristine main in this repo, so no
commit can land until that clears. Reproduced with the band edit stashed, so
none of it comes from the declaration:

code-comments - seven YAML comments below the top header block in .forgejo/workflows/mirror-to-github.yml, plus a 3-line contiguous block at src/data/projects.js:79.

Fixing that debt is this issue's real work. The band line rides along once the
hooks come up clean.

Parent: agentic-os#1085. The validator that makes the declaration mandatory is
agentic-os#1090; until it ships, band is simply an unread key.

Every repo declares its documentation band rather than falling into one. The change here is one line: ```toml [tool.agentic-os.documentation-layout] band = "small" ``` Caps for `small`: 40 lines / 3,000 chars per Markdown file, 20 `docs/*.md`. ## Why this is an issue rather than a commit `pre-commit run --all-files` fails on pristine `main` in this repo, so no commit can land until that clears. Reproduced with the band edit stashed, so none of it comes from the declaration: * `code-comments` - seven YAML comments below the top header block in `.forgejo/workflows/mirror-to-github.yml`, plus a 3-line contiguous block at `src/data/projects.js:79`. Fixing that debt is this issue's real work. The band line rides along once the hooks come up clean. Parent: agentic-os#1085. The validator that makes the declaration mandatory is agentic-os#1090; until it ships, `band` is simply an unread key.

coilyco-ops referenced this issue from coilyco-flight-deck/agentic-os

2026-08-16 07:02:44 +00:00

coilysiren/* repos cannot carry the scoped label taxonomy #1106

coilyco-ops commented

2026-08-16 07:03:08 +00:00

Author

Collaborator

Unlabelled on purpose. The coilysiren namespace is a user account, not an org, so it cannot hold the scoped taxonomy, and repo-level label creation is policy-denied to prevent shadowing. Tracked at coilyco-flight-deck/agentic-os#1106. Triage this one by hand until that lands.

Unlabelled on purpose. The `coilysiren` namespace is a user account, not an org, so it cannot hold the scoped taxonomy, and repo-level label creation is policy-denied to prevent shadowing. Tracked at coilyco-flight-deck/agentic-os#1106. Triage this one by hand until that lands.