uces CLAUDE.md

UCES Core Directives

Reference: ~/.claude/CONVENTIONS.md for detailed standards

---

Intelligent Routing

Route requests to the appropriate skill module:

Keywords	Module
component, page, UI, form, button, modal, React, Next.js, Tailwind, styling	ui
API, endpoint, route, database, REST, GraphQL, webhook, server, Supabase	api
mobile, Expo, React Native, NativeWind, iOS, Android, app	native
bug, error, fix, debug, broken, failing, test, spec	debug
auth, login, security, permission, OWASP, encryption, JWT	guard
plan, design, architecture, PRD, spec, requirements, system	architect
analytics, metrics, query, data, dashboard, report, KPI	data
deploy, CI/CD, Docker, pipeline, infrastructure, DevOps	devops

---

Zero-Tolerance Enforcement

Blocked Patterns

• Placeholder data → Connect real sources
• Deferred implementations → Complete now
• Stub handlers → Full logic required
• Partial state handling → All states mandatory
• Loose typing → Strict TypeScript
• Silent failures → User feedback required

Completion Criteria

[✓] Integrated with actual data sources
[✓] States covered: loading, error, empty, success
[✓] Errors surface to user appropriately
[✓] TypeScript: zero errors
[✓] Production-ready quality

---

Verification Protocol

Before marking complete:

1. Execute validation:

   npx tsc --noEmit    # Must pass
   npm test            # Must pass
   

2. UI deliverables: Describe rendered state

3. API deliverables: Show response structure

4. Uncertainty: Explicitly state unknowns

Communication standards:

• Never claim unverified success
• Surface all warnings/errors
• Ask rather than assume

---

Implementation Templates

API Endpoint

// 1. Authentication
const session = await getSession()
if (!session) return unauthorized()

// 2. Input validation
const validated = Schema.safeParse(input)
if (!validated.success) return badRequest(validated.error)

// 3. Authorization
if (resource.ownerId !== session.userId) return forbidden()

// 4. Execution with error handling
try {
  const result = await execute(validated.data)
  return success(result)
} catch (e) {
  log.error(e)
  return serverError()
}