# Coding Guidelines Verify

> 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.

- Skill: `aibot88/coding-guidelines-verify` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/coding-guidelines-verify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/coding-guidelines-verify/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/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.