Empathy Ledger Development Skill

This skill provides comprehensive context for developing the Empathy Ledger v2 platform - a multi-tenant storytelling platform for Indigenous communities with cultural safety protocols.

Quick Reference

Project Structure

src/
├── app/                    # Next.js 15 App Router
│   ├── api/               # API routes
│   ├── vault/             # Story Vault dashboard
│   └── stories/           # Story pages
├── components/            # React components
│   ├── ui/               # shadcn/ui base
│   ├── vault/            # Story Vault components
│   └── cultural/         # Cultural protocol UI
├── lib/                   # Utilities and services
│   ├── services/         # Business logic services
│   ├── hooks/            # React hooks
│   └── ai/               # AI integration
└── types/                # TypeScript types
    └── database/         # Supabase types by domain

Key Concepts

OCAP Principles (Indigenous Data Sovereignty):

• •Ownership: Storytellers own their narratives
• •Control: Users control who accesses their stories
• •Access: Tiered access based on cultural sensitivity
• •Possession: Data can be exported/deleted anytime

Multi-Tenant Architecture:

• •All tables have tenant_id for isolation
• •RLS policies enforce tenant boundaries
• •Organizations = tenants

Cultural Sensitivity Levels:

• •standard - General sharing allowed
• •medium - Community context required
• •high - Elder review recommended
• •sacred - Elder approval mandatory, no external sharing

Common Patterns

API Route Authentication:

const supabase = createRouteHandlerClient({ cookies })
const { data: { user }, error } = await supabase.auth.getUser()
if (error || !user) {
  return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
}

Story Ownership Check:

const isOwner = story.author_id === user.id || story.storyteller_id === user.id

Cultural Color Palette:

• •clay-* - Primary, storyteller elements
• •sage-* - Community, elder approval
• •sky-* - Organization, trust
• •ember-* - Warnings, sensitivity

Database Domains

Key Services

• •EmbedService - Manage story embeds with domain restrictions
• •DistributionService - Track external shares
• •RevocationService - Cascade revocation
• •GDPRService - Anonymization, data export
• •AuditService - Action logging

Slash Commands

• •/design-component [description] - Create React component
• •/database-migration [description] - Create Supabase migration
• •/review-cultural [code/feature] - Cultural sensitivity review
• •/review-security [code/endpoint] - Security audit
• •/generate-e2e-test [feature] - Create Playwright test
• •/api-endpoint [description] - Create API route

Specialized Agents

• •frontend-designer - UI/UX with cultural design
• •database-architect - Supabase/PostgreSQL
• •cultural-reviewer - OCAP compliance
• •security-auditor - GDPR and security
• •testing-automation - Playwright E2E

When to Use This Skill

Invoke this skill when:

• •Starting work on any Empathy Ledger feature
• •Need quick reference to project patterns
• •Reviewing code for compliance
• •Creating new components/endpoints

Reference Files

The following files provide detailed context:

• •CLAUDE.md - Project instructions
• •.claude/agents/*.md - Specialized agent prompts
• •.claude/commands/*.md - Slash command definitions
• •src/types/database/ - Database type definitions