From e6a63ccae141c72f14aa3f9614c2499eec7053c1 Mon Sep 17 00:00:00 2001 From: Kacper Date: Wed, 17 Dec 2025 21:20:42 +0100 Subject: [PATCH] chore: remove CLAUDE.md file - Deleted the CLAUDE.md file which provided guidance for the Claude Code project. - This file contained project overview, architecture details, development commands, code conventions, and environment variables. --- CLAUDE.md | 98 ------------------------------------------------------- 1 file changed, 98 deletions(-) delete mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index f7265a84..00000000 --- a/CLAUDE.md +++ /dev/null @@ -1,98 +0,0 @@ -# CLAUDE.md - -This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. - -## Project Overview - -Automaker is an autonomous AI development studio that orchestrates AI agents to build software. Users describe features on a Kanban board, and AI agents powered by Claude Code automatically implement them. - -## Architecture - -This is a monorepo with npm workspaces containing two main applications: - -### Apps Structure -- **`apps/app`** - Next.js 16 + Electron desktop application (frontend) - - React 19 with Zustand for state management - - Radix UI components with Tailwind CSS 4 - - dnd-kit for drag-and-drop Kanban board - - xterm.js for integrated terminal - - Playwright for E2E testing - -- **`apps/server`** - Express.js backend server (TypeScript, ES modules) - - Uses `@anthropic-ai/claude-agent-sdk` for AI agent orchestration - - WebSocket support for real-time events and terminal communication - - node-pty for terminal sessions - - Vitest for testing - -### Communication -- Frontend communicates with backend via HTTP API (port 3008) and WebSocket -- In Electron mode, the backend server is spawned as a child process -- In web mode, both run independently - -### Key Server Services (`apps/server/src/services/`) -- `AgentService` - Manages Claude agent sessions and conversations -- `AutoModeService` - Orchestrates concurrent feature implementation -- `FeatureLoader` - Persists feature/task data to `.automaker/` directory -- `TerminalService` - Manages PTY terminal sessions - -### Key Frontend State (`apps/app/src/store/`) -- `app-store.ts` - Main Zustand store with persisted state (projects, features, settings, themes) -- Features flow: backlog → in_progress → waiting_approval → verified → completed - -## Development Commands - -```bash -# Install dependencies -npm install - -# Development (prompts for mode selection) -npm run dev - -# Specific development modes -npm run dev:electron # Desktop app with Electron -npm run dev:web # Web browser mode (frontend + backend) -npm run dev:server # Backend server only - -# Testing -npm run test # E2E tests (Playwright, headless) -npm run test:headed # E2E tests with browser visible -npm run test:server # Server unit tests (Vitest) -npm run test:server:coverage # Server tests with coverage - -# Linting -npm run lint # ESLint on frontend - -# Building -npm run build # Build Next.js app -npm run build:electron # Build Electron distributable -``` - -### Running a Single Test -```bash -# Frontend E2E (from apps/app) -npx playwright test tests/specific-test.spec.ts - -# Server unit tests (from apps/server) -npx vitest run tests/unit/specific.test.ts -npx vitest watch tests/unit/specific.test.ts # Watch mode -``` - -## Code Conventions - -- Never use `any` for type declarations - create proper interfaces or use existing types -- Server uses ES modules (`"type": "module"`) - use `.js` extensions in imports -- Frontend components in `src/components/`, organized by feature in `views/` -- UI primitives in `src/components/ui/` following shadcn/ui patterns - -## Environment Variables - -- `ANTHROPIC_API_KEY` - Required for Claude agent functionality -- `PORT` - Backend server port (default: 3008) -- `AUTOMAKER_MOCK_AGENT=true` - Enable mock agent for testing without API calls - -## Project Data Storage - -Features and project state are stored in `.automaker/` directory within each project: -- `features.json` - Kanban features/tasks -- `context/` - Context files for AI agents -- Background images and other project-specific data