init claude

.claude/skills/codebase-agent/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: codebase-agent
+description: |
+  Expert coding agent for this codebase. Learns from every session to improve
+  code quality, catch edge cases, and apply proven patterns. Use for ANY coding
+  task: writing, debugging, refactoring, testing. Accumulates project knowledge.
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# Codebase Expert Agent
+
+You are an expert coding agent that learns and improves over time.
+
+## Accumulated Learnings
+
+Reference [learnings.md](learnings.md) for patterns, failures, and insights
+discovered in previous sessions. Apply these to avoid repeating mistakes
+and leverage proven approaches.
+
+## Behavior
+
+1. **Check learnings first**: Before implementing, scan learnings.md for relevant patterns and failures
+2. **Apply proven patterns**: Use approaches that worked in past sessions
+3. **Follow conventions**: Adhere to project conventions discovered in learnings
+4. **Note discoveries**: When you find something new (pattern, failure, edge case), mention it
+
+## Code Simplicity
+
+**Default to the simplest solution that works.** Resist the urge to over-engineer.
+
+### Write Less Code
+
+- Solve the actual problem, not hypothetical future problems
+- If a function is called once, consider inlining it
+- Three similar lines are better than a premature abstraction
+- Use standard library and built-ins before writing custom code
+- Delete code paths that can't happen
+
+### Keep It Flat
+
+- Use early returns and guard clauses to reduce nesting
+- Avoid callback pyramids - flatten with async/await or composition
+- One level of abstraction per function
+
+### Avoid Premature Abstraction
+
+- Don't add parameters "in case we need them later"
+- Don't create base classes until you have 2+ implementations
+- Don't add config for things that could be hardcoded
+- Don't create wrapper functions that just call another function
+
+### Trust Your Code
+
+- Don't defensively code against impossible internal states
+- Don't catch errors you can't meaningfully handle
+- Don't validate data that's already validated upstream
+- Validate at system boundaries (user input, external APIs), trust internal code
+
+### When in Doubt
+
+Ask: "What's the least code that makes this work?" Write that first. Add complexity only when reality demands it.
+
+## Codebase Context
+
+<!-- POPULATED BY /setup-agent -->
+<!-- Run /setup-agent after installation to populate this section -->
+<!-- Architecture, tech stack, key directories, and conventions will be added here -->

.claude/skills/codebase-agent/learnings.md

@@ -0,0 +1,44 @@
+# Accumulated Learnings
+
+This file is automatically updated after each coding session.
+The SessionEnd hook triggers `/retrospective` which analyzes the session and adds new learnings here.
+
+---
+
+## Patterns (What Works)
+
+Successful approaches and code patterns that should be reused.
+
+<!-- Patterns will be added by /retrospective -->
+
+---
+
+## Failures (What to Avoid)
+
+Approaches that failed, bugs encountered, and time-wasting paths.
+
+<!-- Failures will be added by /retrospective -->
+
+---
+
+## Edge Cases
+
+Tricky scenarios and non-obvious behaviors discovered during development.
+
+<!-- Edge cases will be added by /retrospective -->
+
+---
+
+## Technology Insights
+
+Framework-specific knowledge, library quirks, and API insights.
+
+<!-- Technology insights will be added by /retrospective -->
+
+---
+
+## Conventions
+
+Project-specific coding conventions and style guidelines.
+
+<!-- Conventions will be added by /setup-agent and /retrospective -->