Skip to content

docs(rules): fix cross-rule inconsistencies and add integrity checks - #7

Merged
eviweb merged 1 commit into
mainfrom
docs/rules-consistency
Oct 29, 2026
Merged

eviweb merged 1 commit into
mainfrom
docs/rules-consistency

Conversation

@eviweb

@eviweb eviweb commented Oct 29, 2026

Copy link
Copy Markdown
Owner

Summary

Fix inconsistencies found in the rules audit (unpinned action examples contradicting the pin rule, main protection vs light profile, hardcoded origin, hardcoded lint/test tools, init: vs Conventional Commits, mandatory issue link) and add tests that prevent regressions.

Linked issue

None (rules audit).

Changes

  • ci.md: pinned-SHA placeholder in examples; tool-agnostic lint/test jobs
  • git.md: project profile first, referenced from the main row
  • release.md: generic <remote> for the tag push
  • docs.md: documented exception for the VERSION single source; Conventional Commits for the first commit
  • pr.md: linked issue mandatory in strict profile only
  • tests/test_rules_integrity.py: unpinned action tags and orphan rules checks
  • Regenerate agents/codex/AGENTS.md; CHANGELOG [Unreleased] updated

Test checklist

  • All existing tests pass (uv run pytest -v, 108 passed)
  • New behaviour is covered by tests
  • CHANGELOG.md [Unreleased] section updated
  • Flat files regenerated (ai-rules generate, ai-rules verify OK)
  • shellcheck: no shell script modified

- ci.md: action examples use a pinned-SHA placeholder, consistent with the
  supply-chain rule; lint/test jobs are tool-agnostic (no hardcoded
  shellcheck/bats)
- git.md: project profile moved to the top and referenced from the `main`
  protection row, which no longer contradicts the light profile
- release.md: tag push uses a generic <remote> instead of `origin`
- docs.md: VERSION single-source rule allows a documented toolchain
  exception; first commit follows Conventional Commits unless `init:` is
  explicitly requested
- pr.md: linked issue mandatory in strict profile only
- tests/test_rules_integrity.py: fail on unpinned action tags in examples and
  on rules neither imported nor marked experimental
- agents/codex/AGENTS.md: regenerated
- CHANGELOG.md: Added and Changed entries

Signed-off-by: Eric Villard <dev@eviweb.fr>
@eviweb
eviweb merged commit 9b760ab into main Oct 29, 2026
3 checks passed
@eviweb
eviweb deleted the docs/rules-consistency branch October 29, 2026 14:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant