| name | nean-code-review |
| description | Review NEAN code for compliance with standards, NFRs, and security policy. |
| argument-hint | [--paths <glob>] [--no-fix] |
| allowed-tools | Bash, Read, Glob, Grep, Write |
Purpose
Review code against nean-std, nean-nfr, and nean-sec policies. Report issues, then (with approval) fix and run tests to confirm.
Arguments
--paths <glob> — Limit review scope (default: whole repo)--no-fix — Report only, don't offer to fix
Workflow
1. Automated gates
npm run lint
npm run format -- --check
npx nx affected --target=typecheck
2. Policy review
Review against:
- nean-std — coding standards, project structure, conventions
- nean-nfr — performance, reliability, observability, accessibility
- nean-sec — input validation, SQL injection prevention, auth, error handling
For each issue, note:
- Category:
std | nfr | sec
- Severity:
must-fix | should-fix | nice-to-have
- File and location
- What's wrong and how to fix it
3. Report results
Summary of automated gate results + policy findings grouped by severity.
4–5. Approval gate, fix and confirm
See /shared-review-workflow for severity definitions, approval gate protocol, and fix constraints. Run /nean-unit-test to confirm no regressions after fixes.
Common issues to check
Security (nean-sec)
Standards (nean-std)
NFRs (nean-nfr)
Reference
For review checklists and common issues, see reference/nean-code-review-reference.md
