architecture-review — community architecture-review, MeshIt, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for Code Analysis Agents needing comprehensive codebase health checks for Next.js, Supabase, and SWR stacks. Project-focused matching app

AJB-ajb AJB-ajb
[0]
[0]
Updated: 3/5/2026

Agent Capability Analysis

The architecture-review skill by AJB-ajb is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for Code Analysis Agents needing comprehensive codebase health checks for Next.js, Supabase, and SWR stacks.

Core Value

Empowers agents to detect duplicated code, anti-patterns, complexity, and inconsistencies across the codebase, ensuring a robust and maintainable project architecture through periodic checks using SWR and Supabase integration.

↓ Capabilities Granted for architecture-review

Debugging unexplained bugs in Mesh
Performing codebase health checks before major releases
Automating weekly code reviews for consistency and best practices
Identifying duplicated code and anti-patterns in parallel branches

! Prerequisites & Limits

  • Requires access to the codebase and relevant files
  • Specific to Next.js, Supabase, and SWR stacks
  • Needs periodic runs for optimal benefits
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

architecture-review

Install architecture-review, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Architecture Review

Codebase health check for Mesh. Detects duplicated code, anti-patterns, complexity, and inconsistencies across the Next.js + Supabase + SWR stack.

When to Run

  • Before major releases or deploys
  • After merging parallel branches
  • When debugging unexplained bugs
  • Periodically (weekly/biweekly)

How to Use

  1. Read this file for the checklist and categories
  2. For each category, scan the relevant files using the patterns described
  3. Check individual rules/ files for detailed detection guidance
  4. Report findings as: AREA > FILE(S) > SEVERITY > RECOMMENDATION

Review Checklist

1. Duplication (CRITICAL)

Scan for repeated code blocks that should be extracted to shared utilities.

PatternWhere to checkRule
JSON body parsing boilerplatesrc/app/api/**/route.tsdup-json-parsing
Provider identity checkinghooks + API routesdup-provider-check
Record transformation logicAPI routes returning DB rowsdup-record-transform

2. Error Handling (HIGH)

PatternWhere to checkRule
Fire-and-forget fetch callshooks, componentserr-fire-and-forget
Silent .catch(() => {})entire src/err-silent-catch
Unhandled promise rejectionscomponents with .then()err-unhandled-promise
Inconsistent error response formatAPI routeserr-response-format

3. Supabase Client (HIGH)

PatternWhere to checkRule
Multiple client instances in one componentcomponents with createClient()supa-client-instances
Server/browser client confusionhooks importing from wrong modulesupa-client-boundary
Missing null checks after type castingAPI routes with as Record<>supa-unsafe-cast

4. SWR & Data Fetching (MEDIUM)

PatternWhere to checkRule
Missing revalidation after mutationshooks with .update() or .insert()swr-missing-revalidate
N+1 query patternshooks fetching per-item in loopsswr-n-plus-one
select("*") instead of specific columnsAPI routes + hooksperf-select-star

5. Type Safety (MEDIUM)

PatternWhere to checkRule
Generic Json type for structured datasrc/lib/supabase/types.ts, hookstype-generic-json
Explicit : any usageentire src/type-any
Unsafe type assertions without validationAPI routes, componentstype-unsafe-assert

6. Component Structure (MEDIUM)

PatternWhere to checkRule
Components over 300 linessrc/components/comp-too-large
Missing error boundariesroute layouts, dashboardcomp-error-boundary
Mixed fetch patterns (hook vs direct)componentscomp-inconsistent-fetch

Severity Guide

  • CRITICAL: Causes bugs, data loss, or security issues. Fix immediately.
  • HIGH: Creates maintenance burden or silent failures. Fix this sprint.
  • MEDIUM: Inconsistency or code smell. Fix when touching the file.
  • LOW: Style/preference. Fix opportunistically.

Output Format

## Architecture Review - [date]

### Findings

1. **[SEVERITY] [AREA]**: [description]
   - Files: [file paths with line numbers]
   - Recommendation: [what to do]

### Summary
- Critical: N
- High: N
- Medium: N
- Quick wins: [list easy fixes]

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is architecture-review?

Perfect for Code Analysis Agents needing comprehensive codebase health checks for Next.js, Supabase, and SWR stacks. Project-focused matching app

How do I install architecture-review?

Run the command: npx killer-skills add AJB-ajb/MeshIt/architecture-review. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for architecture-review?

Key use cases include: Debugging unexplained bugs in Mesh, Performing codebase health checks before major releases, Automating weekly code reviews for consistency and best practices, Identifying duplicated code and anti-patterns in parallel branches.

Which IDEs are compatible with architecture-review?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for architecture-review?

Requires access to the codebase and relevant files. Specific to Next.js, Supabase, and SWR stacks. Needs periodic runs for optimal benefits.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add AJB-ajb/MeshIt/architecture-review. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use architecture-review immediately in the current project.

Related Skills

Looking for an alternative to architecture-review or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI