wiggum-cli 0.1.0

package/dist/scanner/registry.js

@@ -0,0 +1,243 @@
+/**
+ * Detector Registry
+ * Registers and manages all detectors for the scanner
+ */
+// Import core detectors
+import { frameworkDetector } from './detectors/core/framework.js';
+import { packageManagerDetector } from './detectors/core/packageManager.js';
+import { testingDetector } from './detectors/core/testing.js';
+import { stylingDetector } from './detectors/core/styling.js';
+// Import data layer detectors
+import { databaseDetector } from './detectors/data/database.js';
+import { ormDetector } from './detectors/data/orm.js';
+import { apiDetector } from './detectors/data/api.js';
+// Import frontend detectors
+import { stateManagementDetector } from './detectors/frontend/stateManagement.js';
+import { uiComponentsDetector } from './detectors/frontend/uiComponents.js';
+import { formHandlingDetector } from './detectors/frontend/formHandling.js';
+// Import services detectors
+import { authDetector } from './detectors/services/auth.js';
+import { analyticsDetector } from './detectors/services/analytics.js';
+import { paymentsDetector } from './detectors/services/payments.js';
+import { emailDetector } from './detectors/services/email.js';
+// Import infrastructure detectors
+import { deploymentDetector } from './detectors/infra/deployment.js';
+import { monorepoDetector } from './detectors/infra/monorepo.js';
+// Import MCP detectors
+import { mcpServersDetector, getRecommendedMCPServers } from './detectors/mcp/mcpServers.js';
+import { mcpProjectDetector } from './detectors/mcp/mcpProject.js';
+/**
+ * All detector categories
+ */
+const ALL_CATEGORIES = [
+    // Core
+    'framework',
+    'packageManager',
+    'testing',
+    'styling',
+    // Data Layer
+    'database',
+    'orm',
+    'api',
+    // Frontend
+    'stateManagement',
+    'uiComponents',
+    'formHandling',
+    // Services
+    'auth',
+    'analytics',
+    'payments',
+    'email',
+    // Infrastructure
+    'deployment',
+    'monorepo',
+    // MCP
+    'mcp',
+];
+/**
+ * Detector Registry class
+ * Manages registration and execution of detectors
+ */
+export class DetectorRegistry {
+    detectors = new Map();
+    constructor() {
+        // Initialize all categories
+        for (const category of ALL_CATEGORIES) {
+            this.detectors.set(category, []);
+        }
+    }
+    /**
+     * Register a detector
+     */
+    register(detector) {
+        const category = this.detectors.get(detector.category);
+        if (category) {
+            category.push(detector);
+        }
+    }
+    /**
+     * Get all detectors for a category
+     */
+    getDetectors(category) {
+        return this.detectors.get(category) || [];
+    }
+    /**
+     * Get all registered detectors
+     */
+    getAllDetectors() {
+        const all = [];
+        for (const detectors of this.detectors.values()) {
+            all.push(...detectors);
+        }
+        return all;
+    }
+    /**
+     * Run a single-result detector category
+     */
+    async runSingleDetector(projectRoot, category) {
+        for (const detector of this.getDetectors(category)) {
+            const result = await detector.detect(projectRoot);
+            if (result && !Array.isArray(result)) {
+                return result;
+            }
+        }
+        return null;
+    }
+    /**
+     * Run a multi-result detector category
+     */
+    async runMultiDetector(projectRoot, category) {
+        for (const detector of this.getDetectors(category)) {
+            const result = await detector.detect(projectRoot);
+            if (result) {
+                return Array.isArray(result) ? result : [result];
+            }
+        }
+        return null;
+    }
+    /**
+     * Run all detectors for a project
+     */
+    async runAllDetectors(projectRoot) {
+        const stack = {};
+        // ============ Core ============
+        // Run framework detector
+        stack.framework = await this.runSingleDetector(projectRoot, 'framework') || undefined;
+        // Run package manager detector
+        stack.packageManager = await this.runSingleDetector(projectRoot, 'packageManager') || undefined;
+        // Run testing detectors
+        for (const detector of this.getDetectors('testing')) {
+            const result = await detector.detect(projectRoot);
+            if (result) {
+                stack.testing = {};
+                if (Array.isArray(result)) {
+                    for (const r of result) {
+                        if (r.variant === 'unit') {
+                            stack.testing.unit = r;
+                        }
+                        else if (r.variant === 'e2e') {
+                            stack.testing.e2e = r;
+                        }
+                    }
+                }
+                else {
+                    // Single result, determine type from name
+                    if (result.name === 'Jest' || result.name === 'Vitest') {
+                        stack.testing.unit = result;
+                    }
+                    else {
+                        stack.testing.e2e = result;
+                    }
+                }
+                break;
+            }
+        }
+        // Run styling detector
+        stack.styling = await this.runSingleDetector(projectRoot, 'styling') || undefined;
+        // ============ Data Layer ============
+        // Run database detector
+        stack.database = await this.runSingleDetector(projectRoot, 'database') || undefined;
+        // Run ORM detector
+        stack.orm = await this.runSingleDetector(projectRoot, 'orm') || undefined;
+        // Run API detector (multi-result)
+        stack.api = await this.runMultiDetector(projectRoot, 'api') || undefined;
+        // ============ Frontend ============
+        // Run state management detector
+        stack.stateManagement = await this.runSingleDetector(projectRoot, 'stateManagement') || undefined;
+        // Run UI components detector (multi-result)
+        stack.uiComponents = await this.runMultiDetector(projectRoot, 'uiComponents') || undefined;
+        // Run form handling detector (multi-result)
+        stack.formHandling = await this.runMultiDetector(projectRoot, 'formHandling') || undefined;
+        // ============ Services ============
+        // Run auth detector
+        stack.auth = await this.runSingleDetector(projectRoot, 'auth') || undefined;
+        // Run analytics detector (multi-result)
+        stack.analytics = await this.runMultiDetector(projectRoot, 'analytics') || undefined;
+        // Run payments detector
+        stack.payments = await this.runSingleDetector(projectRoot, 'payments') || undefined;
+        // Run email detector
+        stack.email = await this.runSingleDetector(projectRoot, 'email') || undefined;
+        // ============ Infrastructure ============
+        // Run deployment detector (multi-result)
+        stack.deployment = await this.runMultiDetector(projectRoot, 'deployment') || undefined;
+        // Run monorepo detector
+        stack.monorepo = await this.runSingleDetector(projectRoot, 'monorepo') || undefined;
+        // ============ MCP ============
+        // Run MCP detectors
+        const mcpStack = {};
+        // Detect configured MCP servers
+        const mcpServers = await this.runMultiDetector(projectRoot, 'mcp');
+        // Separate MCP server configs from MCP project detection
+        if (mcpServers) {
+            const serverConfigs = mcpServers.filter(r => r.name.startsWith('MCP:') || r.name === 'MCP Config Directory');
+            const projectInfo = mcpServers.find(r => r.name === 'MCP Server Project' || r.name === 'MCP Client');
+            if (serverConfigs.length > 0) {
+                mcpStack.detected = serverConfigs;
+            }
+            if (projectInfo) {
+                mcpStack.isProject = projectInfo.name === 'MCP Server Project';
+                mcpStack.projectInfo = projectInfo;
+            }
+        }
+        // Get recommended MCP servers based on stack
+        mcpStack.recommended = getRecommendedMCPServers(projectRoot);
+        // Only add MCP stack if there's meaningful data
+        if (mcpStack.detected || mcpStack.isProject || (mcpStack.recommended && mcpStack.recommended.length > 0)) {
+            stack.mcp = mcpStack;
+        }
+        return stack;
+    }
+}
+/**
+ * Create a registry with all core detectors pre-registered
+ */
+export function createDefaultRegistry() {
+    const registry = new DetectorRegistry();
+    // Register core detectors
+    registry.register(frameworkDetector);
+    registry.register(packageManagerDetector);
+    registry.register(testingDetector);
+    registry.register(stylingDetector);
+    // Register data layer detectors
+    registry.register(databaseDetector);
+    registry.register(ormDetector);
+    registry.register(apiDetector);
+    // Register frontend detectors
+    registry.register(stateManagementDetector);
+    registry.register(uiComponentsDetector);
+    registry.register(formHandlingDetector);
+    // Register services detectors
+    registry.register(authDetector);
+    registry.register(analyticsDetector);
+    registry.register(paymentsDetector);
+    registry.register(emailDetector);
+    // Register infrastructure detectors
+    registry.register(deploymentDetector);
+    registry.register(monorepoDetector);
+    // Register MCP detectors
+    registry.register(mcpServersDetector);
+    registry.register(mcpProjectDetector);
+    return registry;
+}
+export { DetectorRegistry as Registry };
+//# sourceMappingURL=registry.js.map

package/dist/scanner/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/scanner/registry.ts"],"names":[],"mappings":"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"}

package/dist/scanner/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Scanner Types
+ * Type definitions for the project scanner system
+ */
+/**
+ * Result of detecting a single technology/tool
+ */
+export interface DetectionResult {
+    /** Name of the detected technology (e.g., "Next.js", "pnpm") */
+    name: string;
+    /** Version if detectable from package.json */
+    version?: string;
+    /** Variant or additional context (e.g., "app-router" for Next.js) */
+    variant?: string;
+    /** Confidence score from 0-100 */
+    confidence: number;
+    /** Evidence that led to this detection (files found, deps matched) */
+    evidence: string[];
+}
+/**
+ * MCP detection result
+ */
+export interface MCPStack {
+    /** Detected MCP servers from config */
+    detected?: DetectionResult[];
+    /** Recommended MCP servers based on stack */
+    recommended?: string[];
+    /** Is this an MCP server project */
+    isProject?: boolean;
+    /** MCP project detection result (if it's an MCP server project) */
+    projectInfo?: DetectionResult;
+}
+/**
+ * Complete detected tech stack for a project
+ */
+export interface DetectedStack {
+    /** Web framework (Next.js, React, Vue, etc.) */
+    framework?: DetectionResult;
+    /** Package manager (pnpm, yarn, npm, bun) */
+    packageManager?: DetectionResult;
+    /** Testing frameworks */
+    testing?: {
+        unit?: DetectionResult;
+        e2e?: DetectionResult;
+    };
+    /** Styling approach (Tailwind, CSS Modules, etc.) */
+    styling?: DetectionResult;
+    /** Database (Supabase, Firebase, MongoDB, PostgreSQL) */
+    database?: DetectionResult;
+    /** ORM (Prisma, Drizzle) */
+    orm?: DetectionResult;
+    /** API patterns (tRPC, GraphQL, TanStack Query, REST) - can have multiple */
+    api?: DetectionResult[];
+    /** State management (Redux, Zustand, Jotai, Pinia, etc.) */
+    stateManagement?: DetectionResult;
+    /** UI component libraries (shadcn, Radix, MUI, etc.) - can have multiple */
+    uiComponents?: DetectionResult[];
+    /** Form handling and validation (React Hook Form, Zod, etc.) - can have multiple */
+    formHandling?: DetectionResult[];
+    /** Auth provider (NextAuth, Clerk, Auth0, Supabase Auth) */
+    auth?: DetectionResult;
+    /** Analytics (PostHog, Mixpanel, Vercel Analytics, etc.) - can have multiple */
+    analytics?: DetectionResult[];
+    /** Payment provider (Stripe, Lemon Squeezy, Paddle) */
+    payments?: DetectionResult;
+    /** Email provider (Resend, SendGrid, Nodemailer) */
+    email?: DetectionResult;
+    /** Deployment targets (Vercel, Netlify, Railway, Docker) - can have multiple */
+    deployment?: DetectionResult[];
+    /** Monorepo tools (Turborepo, Nx, pnpm workspaces, Lerna) */
+    monorepo?: DetectionResult;
+    /** MCP (Model Context Protocol) related detection */
+    mcp?: MCPStack;
+}
+/**
+ * Category of detector
+ */
+export type DetectorCategory = 'framework' | 'packageManager' | 'testing' | 'styling' | 'database' | 'orm' | 'api' | 'stateManagement' | 'uiComponents' | 'formHandling' | 'auth' | 'analytics' | 'payments' | 'email' | 'deployment' | 'monorepo' | 'mcp';
+/**
+ * Interface for a detector function
+ */
+export interface Detector {
+    /** Category this detector belongs to */
+    category: DetectorCategory;
+    /** Human-readable name */
+    name: string;
+    /** Run detection on a project directory */
+    detect: (projectRoot: string) => Promise<DetectionResult | DetectionResult[] | null>;
+}
+/**
+ * Options for the scanner
+ */
+export interface ScannerOptions {
+    /** Whether to include low-confidence results */
+    includeLowConfidence?: boolean;
+    /** Minimum confidence threshold (0-100) */
+    minConfidence?: number;
+}
+/**
+ * Result of a full project scan
+ */
+export interface ScanResult {
+    /** Path that was scanned */
+    projectRoot: string;
+    /** Detected tech stack */
+    stack: DetectedStack;
+    /** Time taken to scan in milliseconds */
+    scanTime: number;
+    /** Any errors encountered during scanning */
+    errors?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scanner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scanner/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAE5B,gDAAgD;IAChD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,yBAAyB;IACzB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,GAAG,CAAC,EAAE,eAAe,CAAC;KACvB,CAAC;IACF,qDAAqD;IACrD,OAAO,CAAC,EAAE,eAAe,CAAC;IAG1B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,4BAA4B;IAC5B,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;IAGxB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,oFAAoF;IACpF,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IAGjC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,gFAAgF;IAChF,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,oDAAoD;IACpD,KAAK,CAAC,EAAE,eAAe,CAAC;IAGxB,gFAAgF;IAChF,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAG3B,qDAAqD;IACrD,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAExB,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,SAAS,GAET,UAAU,GACV,KAAK,GACL,KAAK,GAEL,iBAAiB,GACjB,cAAc,GACd,cAAc,GAEd,MAAM,GACN,WAAW,GACX,UAAU,GACV,OAAO,GAEP,YAAY,GACZ,UAAU,GAEV,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,GAAG,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/scanner/types.js

@@ -0,0 +1,6 @@
+/**
+ * Scanner Types
+ * Type definitions for the project scanner system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scanner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scanner/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/templates/config/ralph.config.js.tmpl

@@ -0,0 +1,38 @@
+module.exports = {
+  name: '{{projectName}}',
+  stack: {
+    framework: {
+      name: '{{framework}}',
+      version: '{{frameworkVersion}}',
+      variant: '{{frameworkVariant}}',
+    },
+    packageManager: '{{packageManager}}',
+    testing: {
+      unit: '{{unitTest}}',
+      e2e: '{{e2eTest}}',
+    },
+    styling: '{{styling}}',
+  },
+  commands: {
+    dev: '{{devCommand}}',
+    build: '{{buildCommand}}',
+    test: '{{testCommand}}',
+    lint: '{{lintCommand}}',
+    typecheck: '{{typecheckCommand}}',
+  },
+  paths: {
+    root: '.ralph',
+    prompts: '.ralph/prompts',
+    guides: '.ralph/guides',
+    specs: '.ralph/specs',
+    scripts: '.ralph/scripts',
+    learnings: '.ralph/LEARNINGS.md',
+    agents: '.ralph/AGENTS.md',
+  },
+  loop: {
+    maxIterations: 10,
+    maxE2eAttempts: 5,
+    defaultModel: 'sonnet',
+    planningModel: 'opus',
+  },
+};

package/dist/templates/guides/AGENTS.md.tmpl

@@ -0,0 +1,100 @@
+# AGENTS.md
+
+## Stack
+{{framework}}{{#if frameworkVersion}} {{frameworkVersion}}{{/if}}{{#if frameworkVariant}} ({{frameworkVariant}}){{/if}}, TypeScript, {{styling || css}}{{#if unitTest}}, {{unitTest}}{{/if}}{{#if e2eTest}}, {{e2eTest}}{{/if}}
+
+## Commands
+All commands run from `{{appDir}}/` directory:
+
+| Action | Command |
+|--------|---------|
+| Dev | `cd {{appDir}} && {{devCommand}}` |
+| Build | `cd {{appDir}} && {{buildCommand}}` |
+| Lint | `cd {{appDir}} && {{lintCommand}}` |
+| Lint fix | `cd {{appDir}} && {{lintCommand}} -- --fix` |
+| Format | `cd {{appDir}} && {{formatCommand}}` |
+| Typecheck | `cd {{appDir}} && {{typecheckCommand}}` |
+{{#if unitTest}}| Test | `cd {{appDir}} && {{testCommand}}` |
+| Test watch | `cd {{appDir}} && {{testCommand}} -- --watch` |{{/if}}
+
+## Validation (run before commit)
+```bash
+cd {{appDir}} && {{lintCommand}} -- --fix && {{typecheckCommand}}{{#if unitTest}} && {{testCommand}}{{/if}} && {{buildCommand}}
+```
+
+## Security Review (run before commit)
+```bash
+cd {{appDir}} && {{packageManager}} audit                    # Check vulnerable dependencies
+```
+Then review changes against @.ralph/guides/SECURITY.md checklist.
+Use `mcp__supabase__get_advisors` with type "security" to check RLS policies.
+
+## Patterns
+- Pages: `{{appDir}}/app/` - Next.js App Router
+- Components: `{{appDir}}/components/` - see ui/, ai-elements/, survey-editor/
+- API: `{{appDir}}/app/api/` - streaming endpoints with tool calling
+- Store: `{{appDir}}/store/` - State management
+- Server Actions: `{{appDir}}/app/actions.ts` and `{{appDir}}/app/actions/`
+- Libs: `{{appDir}}/lib/` - utilities and integrations
+
+## Search Tools
+- **Codebase search**: Use `mgrep "query"` (preferred over Grep/Glob)
+- **Documentation lookup**: Use Context7 MCP for library/framework docs
+- **Web search**: Use `mgrep --web "query"` for general web lookups
+
+## Code Rules
+- Explicit return types on functions
+- No `any` - use `unknown` if truly unknown
+- Early returns over nested conditionals
+- Named exports, not default exports
+- Path alias `@/` maps to `{{appDir}}/` root
+- Follow patterns in existing components
+- 2-space indentation, single quotes
+- PascalCase for components, `use` prefix for hooks
+- kebab-case for folder names (e.g., `survey-editor`)
+
+{{#if unitTest}}## Testing
+- Framework: {{unitTest}}{{#if unitTestVersion}} {{unitTestVersion}}{{/if}}
+- Test location: next to component as `*.test.tsx` or in `__tests__/`
+- Run: `cd {{appDir}} && {{testCommand}}`
+- Each feature task should include tests
+- Validation fails if tests fail
+{{/if}}
+
+## Secrets
+- Use `.env.local` for secrets, never commit API keys
+- Use `process.env.*` for all secrets
+
+## Git
+- Commits: `type(scope): description` (conventional commits)
+- Types: feat, fix, docs, refactor, test, chore
+- After changes: validate, commit, push
+
+## MCP Servers Available
+- **Supabase**: Query DB, manage migrations, generate types
+- **PostHog**: Analytics, feature flags, experiments
+- **Playwright**: Browser automation for E2E testing
+  - Navigate: `browser_navigate`, `browser_snapshot`
+  - Interact: `browser_click`, `browser_type`, `browser_fill_form`
+  - Verify: `browser_wait_for`, `browser_console_messages`
+  - Debug: `browser_take_screenshot`
+- **Codex CLI** (shell command, not MCP): PR review
+  - Command: `echo "prompt" | codex exec --full-auto -`
+  - For reviews: `codex review --base main` (interactive mode)
+  - Location: `/opt/homebrew/bin/codex`
+  - Use for: code review, PR feedback before merge
+- **Context7**: Documentation lookup for libraries/frameworks
+
+## Quick Triggers
+| Keywords | Action |
+|----------|--------|
+| type error, ts | Run typecheck |
+| lint, format | Run lint --fix and prettier |
+| deploy, build | Run full build |
+| error, debug | Check PostHog logs or console |
+| database, table | Use Supabase MCP |
+| e2e, browser test | Use Playwright MCP |
+
+## Detailed Docs
+- Architecture: `{{appDir}}/.claude/CLAUDE.md` - comprehensive codebase details
+- Frontend: `.ralph/guides/FRONTEND.md` - design patterns, component usage, quality checklist