Ai Workflow
Overview
How Claude Code is configured for the Finapp project, agents and skills.
What This Is
The project includes Claude Code configurations that standardize how AI assists with development. They live in base/.claude/ and cover two areas.
| Type | Purpose | Location |
|---|---|---|
| Agents | Specialized subagents for delegation (code review, planning, build fixes) | .claude/agents/ |
| Skills | Detailed guides activated on demand (TDD, security checklist, patterns) | .claude/skills/ |
| Plugins | Extended capabilities installed via Claude Code plugin system | ~/.claude/plugins/ |
How It Works
Skills (on demand)
Skills are invoked via slash commands when you need a specific workflow.
/security-review, comprehensive security audit checklist/tdd-workflow, Red, Green, Refactor cycle with Vitest/nuxt4-patterns, Nuxt 4 reference adapted for SPA mode/e2e-testing, Playwright testing patterns
Plugins (extended capabilities)
Plugins add new slash commands beyond what's built into Claude Code.
/understand, analyzes the full codebase and produces an interactive knowledge graph at finapp-graph.ilko.me
Agents (delegated tasks)
Agents are specialized subprocesses for complex tasks. Claude can delegate to them automatically or you can request one directly.
- "Review this TypeScript",
typescript-reviewer - "Review this code",
code-reviewer - "Plan this feature",
planner - "Fix the build",
build-error-resolver
What's Configured
Security
- Skill: comprehensive OWASP checklist adapted for Supabase + PowerSync (RLS, JWT, sync rules)
Testing
- Skill: Vitest patterns, TDD workflow, mocking PowerSync, Pinia, localStorage
- Skill: Playwright E2E testing patterns
Code Quality
- Agent: general code reviewer (Vue, Nuxt, PowerSync/Supabase patterns)
- Agent: TypeScript reviewer (type safety, async correctness, Composition API)
- Agent: build error resolver (minimal fixes to get the build green)
Planning
- Agent: feature planner that considers offline support, optimistic UI, frontend IDs, i18n
Origin
Adapted from everything-claude-code (MIT). All React, Next.js patterns replaced with Vue 3, Nuxt 4. Project uses Supabase + PowerSync (offline-first). Project specific patterns added (shallowRef stores, optimistic writes, client-generated UUIDs).