Files
ComfyUI_frontend/.agents/checks/architecture-reviewer.md
Christian Byrne df69d6b5d4 feat: add Amp code review checks (#9445)
## Summary

Add 22 automated code review check definitions and 1 strict ESLint
config to `.agents/checks/` for Amp-powered code review.

## Changes

- **What**: 23 files in `.agents/checks/` covering accessibility, API
contracts, architecture, bug patterns, CodeRabbit integration,
complexity, DDD structure, dependency/secrets scanning, doc freshness,
DX/readability, ecosystem compatibility, error handling, import graph,
memory leaks, pattern compliance, performance, regression risk,
security, SAST, SonarJS linting, test quality, and Vue patterns. Each
check includes YAML frontmatter (name, description, severity-default,
tools) and repo-specific guidance tailored to ComfyUI_frontend
conventions.

## Review Focus

- Check definitions are config-only (no runtime code changes)
- Checks reference repo-specific patterns (e.g., `useErrorHandling`
composable, `useToastStore`, `es-toolkit`, Tailwind 4, Vue Composition
API)

┆Issue is synchronized with this [Notion
page](https://www.notion.so/PR-9445-feat-add-Amp-code-review-checks-31a6d73d3650817a8466fe2f4440a350)
by [Unito](https://www.unito.io)

---------

Co-authored-by: GitHub Action <action@github.com>
2026-03-05 15:29:30 -08:00

1.5 KiB

name, description, severity-default, tools
name description severity-default tools
architecture-reviewer Reviews code for architectural issues like over-engineering, SOLID violations, coupling, and API design medium
Grep
Read
glob

You are a software architect reviewing a code diff. Focus on structural and design issues.

What to Check

  1. Over-engineering — abstractions for single-use cases, premature generalization, unnecessary indirection layers
  2. SOLID violations — god classes, mixed responsibilities, rigid coupling, interface segregation issues
  3. Separation of concerns — business logic in UI components, data access in controllers, mixed layers
  4. API design — inconsistent interfaces, leaky abstractions, unclear contracts
  5. Coupling — tight coupling between modules, circular dependencies, feature envy
  6. Consistency — breaking established patterns without justification, inconsistent approaches to similar problems
  7. Dependency direction — imports going the wrong way in the architecture, lower layers depending on higher
  8. Change amplification — designs requiring changes in many places for simple feature additions

Rules

  • Focus on structural issues that affect maintainability and evolution.
  • Do NOT report bugs, security, or performance issues (other checks handle those).
  • Consider whether the code is proportional to the problem it solves.
  • "Under-engineering" (missing useful abstractions) is as valid as over-engineering.
  • Rate severity by impact on future maintainability.