The Code Wizard skill is a specialized codebase exploration and navigation tool designed to streamline development within complex monorepos. It acts as an intelligent map for source code, allowing developers to instantly locate specific functionality, constants, configuration values, and architectural patterns. By providing predefined search patterns and a comprehensive directory layout, it significantly reduces the cognitive load required to understand and maintain large-scale software projects.

When should I use code-wizard?

code-wizard is useful in the following scenarios: • Locating specific React hooks, UI components, or business logic services across multiple applications and shared packages. • Identifying the definition and usage of environment variables, API keys, and static tokens to ensure security and consistency. • Mapping the relationship between frontend pages, Supabase database migrations, and backend Edge Functions. • Onboarding new developers by providing a clear structural overview and 'cheat sheets' for common code search patterns. • Auditing database interactions by finding all instances of specific table queries or RPC function calls within the codebase.

name	code-wizard
description	Codebase exploration and location finder for the Raamattu Nyt monorepo. Use when finding where specific functionality is implemented, locating constants/tokens/config values, discovering file patterns, or answering "where is X coded?" questions. Helps other skills and agents locate code quickly.

Code Wizard

Find what-is-where in the Raamattu Nyt monorepo.

Context Files (Read First)

For structure and layout, read from Docs/context/:

Docs/context/repo-structure.md - Full directory layout
Docs/context/packages-map.md - Package boundaries and imports

Quick Directory Map

raamattu-nyt/
├── apps/
│   ├── raamattu-nyt/src/      # Main Bible app
│   │   ├── pages/             # Route components
│   │   ├── components/        # UI components
│   │   ├── hooks/             # React hooks
│   │   ├── lib/               # Business logic, services
│   │   └── integrations/      # External services (Supabase)
│   └── prompting-machine/     # AI prompting app
├── packages/
│   ├── ui/                    # Shared shadcn components
│   ├── shared-auth/           # Auth hooks, session
│   ├── shared-content/        # Shared content utils
│   ├── shared-history/        # Reading history
│   ├── shared-voice/          # Audio/TTS
│   └── ai/                    # AI utilities
├── supabase/
│   ├── migrations/            # Database DDL
│   └── functions/             # Edge Functions
└── Docs/                      # Project documentation

Common Search Patterns

Find Constants/Tokens

# Static string tokens
grep -r "const.*TOKEN\|const.*KEY\|const.*SECRET" --include="*.ts" --include="*.tsx"

# Environment variables
grep -r "import.meta.env\|process.env\|Deno.env" --include="*.ts" --include="*.tsx"

# Query keys (React Query)
grep -r "queryKey.*\[" --include="*.ts" --include="*.tsx"

Find Feature Implementation

# Hooks
grep -r "export.*function use\|export const use" --include="*.ts" --include="*.tsx"

# Services
grep -r "export.*async function\|export const.*= async" apps/raamattu-nyt/src/lib/

# Components
grep -r "export.*const.*=.*\(\)" apps/raamattu-nyt/src/components/

Find Database/API Usage

# Supabase table queries
grep -r "\.from\(['\"]" --include="*.ts" --include="*.tsx"

# RPC function calls
grep -r "\.rpc\(['\"]" --include="*.ts" --include="*.tsx"

# Edge Function invocations
grep -r "functions.invoke\|/functions/v1/" --include="*.ts"

Where Things Are

By Feature Type

Looking For	Location	Pattern
React hooks	`apps/*/src/hooks/`	`use*.ts`
UI components	`apps/*/src/components/`	`*.tsx`
Page routes	`apps/*/src/pages/`	`*Page.tsx`
Business logic	`apps/*/src/lib/`	`*Service.ts`
Supabase types	`apps/*/src/integrations/supabase/`	`types.ts`
DB migrations	`supabase/migrations/`	`*.sql`
Edge Functions	`supabase/functions/`	`*/index.ts`
Shared UI	`packages/ui/src/`	`*.tsx`
Auth logic	`packages/shared-auth/`	`*.ts`

By Domain

Domain	Key Files
Bible text	`lib/bibleService.ts`, `lib/verseParser.ts`, `lib/searchService.ts`
Audio/TTS	`lib/audioService.ts`, `packages/shared-voice/`
AI features	`lib/aiSummaryService.ts`, `hooks/useAIQuota.ts`, `supabase/functions/ai-orchestrator/`
Topics	`lib/topicEditorUtils.ts`, `pages/TopicPage.tsx`, `pages/AdminTopicsPage.tsx`
User data	`hooks/useFeedback.ts`, `lib/activityLogger.ts`
Admin	`pages/Admin*.tsx`, `components/admin/`

Useful Grep Commands

Find All Query Keys

grep -roh "queryKey: \[.*\]" apps/ | sort -u

Find All Routes

grep -r "path=\"/\|<Route" apps/raamattu-nyt/src/App.tsx

Find All Supabase Tables Used

grep -roh "\.from(['\"][^'\"]*['\"])" apps/ | sort -u

Find All RPC Functions Called

grep -roh "\.rpc(['\"][^'\"]*['\"])" apps/ | sort -u

Find Environment Variables

grep -roh "import\.meta\.env\.[A-Z_]*\|Deno\.env\.get(['\"][^'\"]*['\"])" . | sort -u

Find Exports from a File

grep "^export" <file_path>

References

File locations by feature: See references/locations.md
Search patterns cookbook: See references/patterns.md

code-wizard

When & Why to Use This Skill

Use Cases