project-audit

Audit codebase compliance against AGENTS.md and doc/ specifications with automated tests and AI review.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/SSS08099/mom-system --skill project-audit-sss08099
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-audit
Source: https://github.com/SSS08099/mom-system/tree/main/.agents/skills/project-audit
Command: npx skills add https://github.com/SSS08099/mom-system --skill project-audit-sss08099

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? During long AI-assisted coding sessions, the model can drift from established project rules defined in AGENTS.md and doc/ specifications. This Skill catches those drifts early by combining automated test suites with a structured compliance review, then fixes violations with user approval and syncs documentation to match reality. ## Core Features & Use Cases - Automated Test Phase: Runs PowerShell-driven compliance and integration test suites (ControllerComplianceTest, EntityComplianceTest, ModuleBoundaryTest, CRUD integration tests) against an isolated test environment before any manual review. - Compliance Scan: Checks the codebase against hard constraints covering POM dependencies, package structure, cross-module calls, entity boundaries, API paths, frontend library usage, database naming, and DTO/VO patterns. - Flag, Fix, and Doc Sync: Reports each violation with the rule, files, and proposed fix, waits for user confirmation, re-runs tests after fixes, then updates doc/ files (roadmap, module docs, known issues) to reflect actual state. - Use Case: After completing a multi-step feature in a Spring Boot + Vue project, run an audit to verify no module boundary violations or stale documentation crept in during the session. ## Quick Start Ask the AI to audit the project against AGENTS.md and the doc/ specifications and report any violations before fixing them.

Frequently Asked Questions about project-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a codebase against project specification docs?

Run the automated test suite first via the PowerShell script, then read AGENTS.md and doc/standards files, scan the code against each hard constraint, and report violations with proposed fixes. Fixes are applied only after user confirmation, followed by documentation sync.

How to detect code drift during long AI coding sessions?

Use a four-phase audit: automated tests catch deterministic errors like missing endpoints or broken cross-module imports, then an AI compliance review checks business logic, architecture decisions, and style consistency against documented rules that tests cannot cover.

What does the project audit check in a Spring Boot multi-module project?

It checks POM dependency rules, package structure, cross-module @Autowired violations, entity boundary exposure, API path prefixes, transaction annotations, DTO/VO patterns, database table naming, and base audit fields on entities, based on doc/standards/backend.md and database.md.

Does the audit fix violations automatically without approval?

No. Every violation is reported with the violated rule, affected files, and a proposed fix, then the process waits for explicit user confirmation before applying changes. Tests are re-run afterward to verify the fix broke nothing.

When should I run a project compliance audit?

Run it when the user asks to audit the project, check compliance, verify against specs, or sync docs, and proactively after completing any multi-step feature or long development session where context shifts may have caused drift from project rules.