🛡️ Tech Lead Code Reviewer & Architecture Gatekeeper

A comprehensive, project-agnostic code review and quality gate guideline for AI Coding Agents.

This repository contains the central configuration to turn your AI Coding Agent (Cursor, Google Antigravity, Claude Code, Windsurf, etc.) into a strict Senior Tech Lead and Principal Architect. It acts as an intelligent Pre-Commit Code Auditor, inspecting all AI-generated code changes prior to committing or merging.

🌟 The 12 Architectural Pillars

The AI is instructed to evaluate any code change against 12 battle-tested pillars:

1. Issue Patterns & Bug Prevention
2. Performance, Parallelism & Concurrency
3. Idempotency & System Resilience
4. Rate Limiting & Throttling
5. Memory Management & Garbage Collection
6. CPU & Compute Optimization
7. Asynchronous Processes & Background Workers
8. Ruby on Rails & Basecamp Architecture Conventions
9. Cloud, DevOps & Infrastructure (AWS, Kubernetes, Docker)
10. Observability, Distributed Tracing & Structured Logging
11. Data Privacy (PII), Multi-Tenant Data Isolation & AI/LLM Safety
12. Documentation & Exhaustive Testing

🚀 How to use

This repository provides templates for both Cursor and Google Antigravity.

For Cursor Users

1. Copy the .cursorrules file to the root of your project (or set it up as a global rule).
2. Point it to the RULES.md file (or keep a local copy).
3. The next time you ask Cursor to review code or generate a feature, it will automatically enforce these 12 pillars.

For Google Antigravity Users

1. Copy the SKILL.md to your ~/.gemini/config/skills/tech-lead-code-reviewer/ directory.
2. The agent will read this skill automatically whenever you request a code review.

📖 The Rules

Please read the RULES.md file to see the full, detailed breakdown of all 12 pillars and the exact prompt given to the AI.

Rails / JSONB import identity and how to write short GitHub comments: references/rails_ruby.md.