CLAUDE.md Instructions File
This skill converts CLAUDE.md instruction files from repositories into structured, actionable context for Claude Code. It parses project structure, development commands, architecture details, and development notes into a comprehensive understanding of the codebase.
What This Skill Does
When you provide a CLAUDE.md file from a repository, this skill:
1. **Identifies the project type** (full-stack, backend-only, frontend-only, monorepo, etc.)
2. **Extracts development commands** for each part of the stack
3. **Maps the architecture** including frameworks, databases, APIs, and component structure
4. **Captures key features** and content management details
5. **Documents development notes** including language, authentication, deployment, and technical constraints
6. **Provides actionable context** for working with the codebase
Instructions
Step 1: Read and Parse the CLAUDE.md File
First, locate and read the CLAUDE.md file:
```bash
If the file path is provided
cat path/to/CLAUDE.md
Or search for it in the repository
find . -name "CLAUDE.md" -o -name "claude.md"
```
Step 2: Identify Project Structure
Extract the high-level project structure:
**Project type**: Full-stack, backend-only, frontend-only, monorepo, microservices**Main directories**: Backend, frontend, shared, packages, services**Technology stack**: List all frameworks, languages, and tools mentionedExample patterns to look for:
"full-stack", "backend", "frontend", "monorepo"Directory paths like `/backend`, `/frontend`, `/packages`Technology names: React, Next.js, Node.js, Python, Go, etc.Step 3: Extract Development Commands
Parse all command sections and organize by context:
```markdown
**Backend Commands:**
Start: `cd backend && docker-compose up -d`Stop: `cd backend && docker-compose down`Logs: `docker-compose logs`**Frontend Commands:**
Dev: `cd frontend && npm run dev`Build: `npm run build`Lint: `npm run lint````
Look for:
Command blocks (triple backticks)Commands under headings like "Development Commands", "Getting Started", "Scripts"Docker commands, npm/yarn/pnpm scripts, build commands, test commandsStep 4: Map Architecture Components
Extract detailed architecture information:
**Backend:**
Framework/runtime (Express, Directus, Django, etc.)Database (PostgreSQL, MongoDB, SQLite, etc.)API structure (REST, GraphQL, gRPC)Key collections/models/tables**Frontend:**
Framework (React, Vue, Angular, Next.js, etc.)Build tool (Vite, Webpack, Turbopack)Routing (React Router, Next.js routing, etc.)State management (Redux, Zustand, TanStack Query, etc.)UI library (shadcn/ui, Material-UI, Tailwind, etc.)**Component Structure:**
Page componentsReusable componentsShared utilitiesAPI integration filesStep 5: Identify Key Features and Integrations
Document:
**Core features** (authentication, payments, content management, etc.)**Third-party integrations** (Stripe, Auth providers, analytics, etc.)**Content management** (CMS, admin panels, data structure)**API endpoints** and data flowStep 6: Capture Development Notes
Extract important constraints and patterns:
**Language/locale** (English, Russian, multilingual, etc.)**Authentication** (enabled/disabled, providers, session management)**Deployment** (Docker, Vercel, Railway, self-hosted)**Environment variables** and configuration**Content strategy** (dynamic vs hardcoded, fallbacks, caching)Step 7: Provide Actionable Context
Summarize the parsed information into clear, actionable guidance:
```markdown
Quick Start
1. Backend: `cd backend && docker-compose up -d`
2. Frontend: `cd frontend && npm run dev`
3. Access: Frontend at http://localhost:5173, Backend admin at http://localhost:1337
When Working On...
**Backend changes**: Modify Directus collections, check Docker logs, restart containers**Frontend changes**: Use Vite dev server, check TanStack Query cache, test responsive design**Content updates**: Use Directus admin panel at localhost:1337**API changes**: Update `/frontend/src/lib/directusApi.ts` and type definitions```
Example Usage
**Input:** CLAUDE.md file from TeaProphet/alex-landing
**Output:**
```markdown
Project: Alexander Paskhalis Personal Trainer Landing Page
Stack
**Backend**: Directus CMS v10.10.0 (Docker + SQLite)**Frontend**: React 18 + TypeScript + Vite + shadcn/ui + Tailwind CSSQuick Start
1. Start backend: `cd backend && docker-compose up -d`
2. Start frontend: `cd frontend && npm run dev`
3. Access admin panel: http://localhost:1337
Architecture
**Backend (Directus):**
Collections: `contacts`, `services_blocks`API: RESTful at `/items/{collection}`Storage: `/backend/uploads/` for images**Frontend (React):**
Router: React Router (Index, NotFound)Data: TanStack Query with Directus APIComponents: `ServiceSection`, `ServiceCarousel`, `SocialIcons`, shadcn/uiKey Features
Responsive mobile-first designHero section with contact overlayAlternating service image layoutsSocial media integration (Instagram, Telegram, WhatsApp)Dynamic content from CMS with hardcoded fallbacksDevelopment Notes
Content in RussianNo authentication for public contentNo form submissions (contact via social media only)API config: `/frontend/src/lib/api.ts`Supports images and videos in service sections```
Important Notes
**Always preserve technical accuracy** — don't simplify or omit important details**Respect the original structure** — if the CLAUDE.md uses specific headings or organization, maintain that pattern**Highlight critical constraints** — authentication requirements, environment dependencies, known limitations**Make commands copy-paste ready** — include full paths and context-switching commands**Flag ambiguities** — if the CLAUDE.md is unclear, note what additional information would be helpfulCommon Patterns to Recognize
**Monorepo indicators:**
Multiple package.json filesTurborepo, Nx, Lerna mentions`/packages`, `/apps`, `/services` directories**Full-stack indicators:**
Separate backend and frontend directoriesDocker Compose filesAPI integration files in frontend**Deployment clues:**
Railway, Vercel, Netlify configuration filesDocker files and compose filesEnvironment variable lists**Content management:**
CMS mentions (Directus, Strapi, Sanity, Contentful)Admin panel URLsContent collections or models