chore: init CLAUDE.md
This commit is contained in:
60
CLAUDE.md
Normal file
60
CLAUDE.md
Normal file
@@ -0,0 +1,60 @@
|
||||
# CLAUDE.md
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||
|
||||
## Project Overview
|
||||
|
||||
Fail Well is a Progressive Web App (PWA) for tracking developer feedback loops during coding tasks. It helps compare planned steps/time vs actual execution, promoting iterative improvement.
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
# Development
|
||||
pnpm dev # Start Vite dev server
|
||||
|
||||
# Building
|
||||
pnpm build # Full build (types + tests + bundle)
|
||||
pnpm build-only # Vite build only
|
||||
|
||||
# Testing
|
||||
pnpm test # Full test suite (lint + types + unit)
|
||||
pnpm test:unit # Vitest unit tests only
|
||||
pnpm test:ui # Vitest with UI dashboard
|
||||
pnpm test:types # TypeScript type checking
|
||||
|
||||
# Code Quality
|
||||
pnpm lint # ESLint with auto-fix
|
||||
pnpm format # Prettier formatting
|
||||
|
||||
# Commits
|
||||
pnpm commit # Commitizen conventional commit prompt
|
||||
```
|
||||
|
||||
## Architecture
|
||||
|
||||
**Tech Stack:** Vue 3 + TypeScript + Vite + Pinia + Bulma CSS
|
||||
|
||||
**Module Structure:**
|
||||
|
||||
- `src/modules/` - Feature modules with self-contained components, stores, models, and services
|
||||
- `record/` - Task execution tracking (time, steps, break calculation)
|
||||
- `task/` - Task CRUD, step history, duplication
|
||||
- `step/` - Step-related components
|
||||
- `src/views/` - Page-level components organized by feature
|
||||
- `src/shared/` - Shared types and hooks
|
||||
- `src/router/` - Vue Router configuration
|
||||
|
||||
**State Management:** Pinia stores with `pinia-plugin-persistedstate` for local persistence
|
||||
|
||||
**Key Routes:**
|
||||
|
||||
- `/` - Task list
|
||||
- `/task/:id` - Task details
|
||||
- `/task/:id/edit` - Edit steps
|
||||
- `/task/:taskId/record` - Record task execution
|
||||
|
||||
## Testing
|
||||
|
||||
Uses Vitest with jsdom environment. Test files are colocated with source files using `.spec.ts` suffix.
|
||||
|
||||
Run single test file: `pnpm vitest run path/to/file.spec.ts`
|
||||
Reference in New Issue
Block a user