feat(code-comments): extend comment discipline to YAML #159

New issue

Closed

opened 2026-06-04 09:44:44 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-06-04 09:44:44 +00:00

Owner

The code-comments validator only scans a fixed set of source extensions and YAML was never among them, so multi-line # comment blocks in playbooks, manifests, and workflows sail through unchecked. YAML comments are #, identical to .py/.sh, so extending the rule is a one-line addition to LINE_COMMENT_PREFIXES.

Scope:

Add .yaml/.yml to LINE_COMMENT_PREFIXES in agentic_os/check_code_comments.py.
Remove the deliberate infrastructure opt-out in apply-agentic-os-hooks.py so infra becomes the proving ground.
Grandfather agentic-os's own pre-existing YAML comment blocks (example/config files) via [tool.agentic-os.code-comments] excludes.

Cleanup of grandfathered YAML and fleet-wide rollout as consumer repos bump the rev is tracked separately.

The `code-comments` validator only scans a fixed set of source extensions and YAML was never among them, so multi-line `#` comment blocks in playbooks, manifests, and workflows sail through unchecked. YAML comments are `#`, identical to `.py`/`.sh`, so extending the rule is a one-line addition to `LINE_COMMENT_PREFIXES`. Scope: - Add `.yaml`/`.yml` to `LINE_COMMENT_PREFIXES` in `agentic_os/check_code_comments.py`. - Remove the deliberate `infrastructure` opt-out in `apply-agentic-os-hooks.py` so infra becomes the proving ground. - Grandfather agentic-os's own pre-existing YAML comment blocks (example/config files) via `[tool.agentic-os.code-comments]` excludes. Cleanup of grandfathered YAML and fleet-wide rollout as consumer repos bump the rev is tracked separately.

coilysiren referenced this issue

2026-06-04 09:45:18 +00:00

chore(code-comments): retire grandfathered YAML comment debt #160

coilysiren referenced this issue from a commit

2026-06-04 09:47:36 +00:00

feat(code-comments): extend comment discipline to YAML

coilysiren closed this issue

2026-06-04 09:47:36 +00:00

coilysiren referenced this issue from coilyco-flight-deck/infrastructure

2026-06-04 09:49:33 +00:00

feat(ansible): enable code-comments on YAML, grandfather deploy debt #217

coilysiren referenced this issue