Adopt baseline agentic-os pre-commit hook block (v0.2.6) #9

New issue

Open

opened 2026-05-25 06:39:48 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-05-25 06:39:48 +00:00

Owner

Problem

This repo does not yet enforce the canonical baseline pre-commit hook block shipped by coilysiren/agentic-os (.pre-commit-hooks.yaml). The baseline pins rev: v0.2.6 and enables the full set of cross-repo validators that every other active coilysiren/* repo runs.

Hooks adopted

catalog-doc-size
catalog-trifecta
documentation-layout
code-comments
catalog-block-present
validate-skills
dead-cross-links
closes-issue
conventional-commit

Plan

Run coily exec apply-agentic-os-hooks from coilysiren/agentic-os to insert the managed upstream-ref block in .pre-commit-config.yaml.
Run pre-commit run --all-files and fix every reported violation. Common remedies: flatten docs/ subdirs, split files over the 80-line / 4000-char cap, collapse multi-line comment blocks, add a catalog: block to .coily/coily.yaml.
Commit and push.

Cross-ref: coilysiren/agentic-os#61.

**Problem** This repo does not yet enforce the canonical baseline pre-commit hook block shipped by `coilysiren/agentic-os` (`.pre-commit-hooks.yaml`). The baseline pins `rev: v0.2.6` and enables the full set of cross-repo validators that every other active `coilysiren/*` repo runs. **Hooks adopted** - `catalog-doc-size` - `catalog-trifecta` - `documentation-layout` - `code-comments` - `catalog-block-present` - `validate-skills` - `dead-cross-links` - `closes-issue` - `conventional-commit` **Plan** - Run `coily exec apply-agentic-os-hooks` from `coilysiren/agentic-os` to insert the managed upstream-ref block in `.pre-commit-config.yaml`. - Run `pre-commit run --all-files` and fix every reported violation. Common remedies: flatten `docs/` subdirs, split files over the 80-line / 4000-char cap, collapse multi-line comment blocks, add a `catalog:` block to `.coily/coily.yaml`. - Commit and push. Cross-ref: coilysiren/agentic-os#61.

coilysiren commented

2026-05-25 06:51:01 +00:00

Author

Owner

Status update (2026-05-24)

Migration was attempted but rolled back. The baseline upstream-ref block at v0.2.7 was added to .pre-commit-config.yaml, then pre-commit run --all-files reported a violation set too large to fix in the migration session. The change was reverted so the repo is not wedged.

Required to land

Create AGENTS.md with the 10 required H2 sections (Scope, Project shape, Repo boundaries, Commands, Validation, Safety, Cross-repo contracts, Release, Agent rules, See also). The See also section must link to README + docs/FEATURES.md + .coily/coily.yaml and cite coilysiren/agentic-os#59.
Create docs/FEATURES.md with the same cross-links and citation.
Update README with a ## See also section pointing at AGENTS.md + docs/FEATURES.md + .coily/coily.yaml plus the citation.
Add or extend .coily/coily.yaml with a populated catalog: block. Schema in coilysiren/agentic-os-kai#420. dependsOn: [] is required even when empty.
Flatten any docs/ subdirs (use filename prefixes instead).
Move any non-allowlist Markdown out of the repo root into docs/*.md.
Split any Markdown file over 80 lines or 4000 chars into multiple flat docs.
Collapse contiguous comment blocks in code to one-line, 90-char-max comments. Move durable detail to docs/*.md and point at it from the code.
Re-run coily exec apply-agentic-os-hooks --repo <this-repo> and pre-commit run --all-files. Iterate until green.

Source rollout

The canonical rollout lives at coilysiren/agentic-os/scripts/apply-agentic-os-hooks.py. Invoke via coily exec apply-agentic-os-hooks from the agentic-os checkout.

**Status update (2026-05-24)** Migration was attempted but rolled back. The baseline upstream-ref block at v0.2.7 was added to `.pre-commit-config.yaml`, then `pre-commit run --all-files` reported a violation set too large to fix in the migration session. The change was reverted so the repo is not wedged. **Required to land** 1. Create AGENTS.md with the 10 required H2 sections (`Scope`, `Project shape`, `Repo boundaries`, `Commands`, `Validation`, `Safety`, `Cross-repo contracts`, `Release`, `Agent rules`, `See also`). The `See also` section must link to README + docs/FEATURES.md + .coily/coily.yaml and cite `coilysiren/agentic-os#59`. 2. Create docs/FEATURES.md with the same cross-links and citation. 3. Update README with a `## See also` section pointing at AGENTS.md + docs/FEATURES.md + .coily/coily.yaml plus the citation. 4. Add or extend `.coily/coily.yaml` with a populated `catalog:` block. Schema in coilysiren/agentic-os-kai#420. `dependsOn: []` is required even when empty. 5. Flatten any `docs/` subdirs (use filename prefixes instead). 6. Move any non-allowlist Markdown out of the repo root into `docs/*.md`. 7. Split any Markdown file over 80 lines or 4000 chars into multiple flat docs. 8. Collapse contiguous comment blocks in code to one-line, 90-char-max comments. Move durable detail to `docs/*.md` and point at it from the code. 9. Re-run `coily exec apply-agentic-os-hooks --repo <this-repo>` and `pre-commit run --all-files`. Iterate until green. **Source rollout** The canonical rollout lives at `coilysiren/agentic-os/scripts/apply-agentic-os-hooks.py`. Invoke via `coily exec apply-agentic-os-hooks` from the agentic-os checkout.

coilysiren added the

label

2026-05-31 01:55:15 +00:00

No labels

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

coilyco-flight-deck/otel-a2a-relay#9

No description provided.

Rows
Columns