ComfyUI_frontend/.agents/checks/pattern-compliance.md

name, description, severity-default, tools

name	description	severity-default	tools
pattern-compliance	Checks code against repository conventions from AGENTS.md and established patterns	medium	Read Grep

Check code against repository conventions and framework patterns.

Steps:

1. Read AGENTS.md (and any directory-specific guidance files) for project-specific conventions
2. Read each changed file
3. Check against the conventions found in AGENTS.md and these standard patterns:

TypeScript

• No any types or as any assertions
• No @ts-ignore without explanatory comment
• Separate type imports (import type { ... })
• Use import type { ... } for type-only imports
• Explicit return types on exported functions
• Use es-toolkit for utility functions, NOT lodash. Flag any new import ... from 'lodash' or import ... from 'lodash/*'
• Never use z.any() in Zod schemas — use z.unknown() and narrow

Vue (if applicable)

• Composition API with <script setup lang="ts">
• Reactive props destructuring (not withDefaults pattern)
• New components must use <script setup lang="ts"> with reactive props destructuring (Vue 3.5 style): const { color = 'blue' } = defineProps<Props>()
• Separate type imports from value imports
• All user-facing strings must use vue-i18n ($t() in templates, t() in script). Flag hardcoded English strings in templates that should be translated. The locale file is src/locales/en/main.json

Tailwind (if applicable)

• No dark: variants (use semantic theme tokens)
• Use cn() utility for conditional classes
• No !important in utility classes
• Tailwind 4: CSS variable references use parentheses syntax: h-(--my-var) NOT h-[--my-var]
• Use design tokens: bg-secondary-background, text-muted-foreground, border-border-default
• No <style> blocks in Vue SFCs — use inline Tailwind only

Testing

• Behavioral tests, not change detectors
• No mock-heavy tests that don't test real behavior
• Test names describe behavior, not implementation

General

• No commented-out code
• No console.log in production code (unless intentional logging)
• No hardcoded URLs, credentials, or environment-specific values
• Package manager is pnpm. Never use npm, npx, or yarn. Use pnpm dlx for one-off package execution
• Sanitize HTML with DOMPurify.sanitize(), never raw innerHTML or v-html without it

Rules:

• Only flag ACTUAL violations, not hypothetical ones
• AGENTS.md conventions take priority over default patterns if they conflict