gap-analysis

Gap Analysis — Alpha AI Standards Compliance (Context-Aware)

Analyze project at: $ARGUMENTS (default: current directory)

Compare the existing codebase against ONLY the standards relevant to this project — NOT every standard in the book.

KEY PRINCIPLE: A project that doesn't need MongoDB should NOT be flagged for missing MongoDB. A project without payments should NOT be flagged for missing Razorpay. Only check what the project ACTUALLY requires.

---

Step 0: Detect Project Requirements

Before checking any standards, first understand WHAT this project needs.

0.1: Read Project Context

Gather requirements from these sources (check in order):

1. Read PRD.md or PRD_*.md (if exists) — most authoritative source of requirements
2. Read SPRINT_PLAN.md (if exists) — tells what features are planned
3. Read PROJECT_ANALYSIS.md (if exists, from /analyze-project)
4. Read README.md (if exists) — project description
5. Read CLAUDE.md (if exists) — project-specific standards
6. Quick scan of codebase (package.json, requirements.txt, docker-compose.yml)

0.2: Build Project Requirements Profile

Based on the context gathered, build a requirements profile by answering YES/NO to each:

PROJECT REQUIREMENTS PROFILE
═══════════════════════════════

Project Name:       [detected name]
Project Type:       [API only | Web app | Mobile app | Full-stack | AI/ML | Library]
Description:        [1-line from PRD/README]

Core Requirements:
  Has backend API?                    → [YES/NO]
  Has user authentication?            → [YES/NO]
  Has SQL database (relational data)? → [YES/NO]
  Has document/NoSQL storage needs?   → [YES/NO] — only YES if project stores:
                                        - Unstructured documents, logs, audit trails
                                        - Highly nested/variable-schema data
                                        - Chat messages, activity feeds, analytics events
                                        - If NO clear need → NO (do NOT default to YES)
  Has caching/session needs?          → [YES/NO] — only YES if project has:
                                        - High-traffic endpoints needing caching
                                        - Real-time session management
                                        - Rate limiting, queues, pub/sub
                                        - If simple CRUD app → NO
  Has payment processing?             → [YES/NO]
  Has India market / INR billing?     → [YES/NO] — determines Razorpay vs Stripe

Frontend Requirements:
  Has web frontend?                   → [YES/NO]
  Has mobile app?                     → [YES/NO]
  Needs dark mode?                    → [YES/NO] — YES if user-facing app
  Needs i18n (multilingual)?          → [YES/NO] — only if PRD mentions multiple languages
  Needs animations/transitions?       → [YES/NO]

Feature Requirements:
  Has file uploads?                   → [YES/NO]
  Has full-text search?               → [YES/NO] — only if search is a core feature
  Has real-time features?             → [YES/NO] — chat, live updates, notifications
  Has push notifications?             → [YES/NO] — only if mobile or PWA with push
  Has email sending?                  → [YES/NO]
  Has social login (Google/Apple)?    → [YES/NO]
  Has role-based access (RBAC)?       → [YES/NO] — only if multiple user roles
  Has 2FA/MFA?                        → [YES/NO] — only if high-security app
  Has background jobs/queues?         → [YES/NO]

AI/GenAI Requirements:
  Has AI/LLM features?                → [YES/NO]
  Has RAG/document search?            → [YES/NO]
  Has AI agents/tools?                → [YES/NO]
  Has MCP/A2A integration?            → [YES/NO]

Infrastructure:
  Needs error tracking (production)?  → [YES/NO] — YES if deploying to production
  Needs analytics?                    → [YES/NO] — only if tracking user behavior
  Needs monitoring?                   → [YES/NO] — YES if production deployment