coding-guidelines-verify

Original🇺🇸 English
Translated
1 scripts

Verify changes follow nearest-scoped AGENTS.md rules: group changed files by nested scope, auto-fix formatting, run lint/tests, and report violations. Use when the user wants scoped compliance checks for changed files.

13installs
Added on

NPX Install

npx skill4agent add jmerta/codex-skills coding-guidelines-verify

Coding guidelines verifier

Goal

Validate that changes follow the nearest nested
AGENTS.md
:
  • default: changed files only
  • default: auto-fix formatting before lint/tests
  • monorepo-aware: each module’s
    AGENTS.md
    is the source of truth for that scope

Workflow (checklist)

  1. Collect changed files (staged + unstaged + untracked).
  2. For each changed file, find the nearest parent
    AGENTS.md
    .
    • If a file has no scoped
      AGENTS.md
      , report it (suggest running
      coding-guidelines-gen
      ).
  3. Parse the
    codex-guidelines
    block (schema:
    references/verifiable-block.md
    ).
  4. Run, per scope:
    • format (auto-fix) -> lint -> tests
    • apply simple forbid rules (globs/regex) from the block
  5. Produce a short compliance report (template:
    references/report-template.md
    ).

Automation

Use
scripts/verify_guidelines.py
to group scopes, run commands, and report results.
  • If
    python
    is not available or the script fails, tell the user and ask whether to install Python or proceed with a manual per-scope verification.

Deliverable

Provide:
  • The per-scope compliance report (use
    references/report-template.md
    ).
  • Any auto-fix formatting changes applied.
  • Lint/test commands run and their results, plus any violations.