All Formats
StarPillar Specification & Hub Directory

CLAUDE.md Repository Guidelines Directory

The root onboarding manual for Anthropic's Claude Code CLI. Gives Claude instant mastery over your build systems, test suites, and project architecture.

Open Blank Studio Editor
Target: ./ (Repository Root)CLAUDE.md
01 / SPECIFICATION & RUNTIME BEHAVIOR

How CLAUDE.md Repository Guidelines Operates in Production

A CLAUDE.md file placed at the root of a Git repository acts as Claude's persistent onboarding manual. Whenever Claude Code launches in a project directory, it parses CLAUDE.md before running any commands. It provides essential facts about package managers, build commands, test runners, directory architecture, and non-negotiable coding conventions.

Commands SectionSpec Syntax

Provide exact build, test, and lint commands so Claude never has to guess.

## Common Commands
- Build: `npm run build`
- Test: `npm test -- --watch=false`
- Typecheck: `npx tsc --noEmit`
- Lint: `npm run lint`
Architecture & RulesSpec Syntax

Define immutable project invariants and module responsibilities.

## Code Style & Architecture
- Next.js 15 App Router: Server Components by default.
- Data Mutations: Server Actions with Zod safeParse.
- Styling: Tailwind CSS v4 utility classes only.
02 / REPOSITORY PLACEMENT
./CLAUDE.mdRepository Root

Primary instructions file read immediately upon Claude Code session startup.

03 / PRESET SPOKE MATRIX

Available Tech Stack Presets (18)

Click any tech stack below to open the client-side editor preloaded with this verified configuration.

FrontendLaunch

Next.js 15 App Router

Generate a Next.js 15 CLAUDE.md repository instruction file with App Router conventions.

Enforced Invariant:

"Define standard commands: build, test, lint, and dev server."

FrontendLaunch

React 19 & Vite

Generate a React 19 CLAUDE.md repository guide with Vite, TypeScript, and custom hook guidelines.

Enforced Invariant:

"Standard commands: `npm run build`, `npm test`, `npm run lint`."

BackendLaunch

Python FastAPI

Generate a Python FastAPI CLAUDE.md repository instruction file with async backend conventions.

Enforced Invariant:

"Specify virtual environment and dependency runner commands (`uv run pytest`, `uv run uvicorn`)."

Fullstack & DBLaunch

Supabase & PostgreSQL

Generate a Supabase & PostgreSQL CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Always include `ENABLE ROW LEVEL SECURITY;` on every created table."

Fullstack & DBLaunch

Prisma ORM

Generate a Prisma ORM CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Always use `select` to specify required fields; avoid raw `findMany()` fetching unused relations."

Fullstack & DBLaunch

Drizzle ORM

Generate a Drizzle ORM CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Define schemas using pgTable/sqliteTable with explicit foreign keys and constraints."

BackendLaunch

Go & Fiber

Generate a Go Fiber CLAUDE.md repository file with Go build commands and testing standards.

Enforced Invariant:

"Commands: `go test -v ./...`, `golangci-lint run`, `go run cmd/server/main.go`."

BackendLaunch

Rust & Axum

Generate a Rust Axum CLAUDE.md repository guide with cargo test, clippy, and error handling rules.

Enforced Invariant:

"Commands: `cargo test`, `cargo clippy -- -D warnings`, `cargo check`."

FrontendLaunch

Tailwind CSS v4

Generate a Tailwind CSS v4 CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Configure themes directly in globals.css using `@theme` and `@import 'tailwindcss';`."

FrontendLaunch

Vue 3 & Nuxt 3

Generate a Vue 3 & Nuxt 3 CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Always use `<script setup lang='ts'>` and the Composition API; ban legacy Options API."

FrontendLaunch

SvelteKit 5 & Svelte 5

Generate a SvelteKit 5 & Svelte 5 CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Use Svelte 5 runes: `$state()`, `$derived()`, and `$props()`."

Specialist PersonaLaunch

Universal Cursor Pro

Generate a Universal Cursor Pro CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Deliver surgical, targeted diffs; never replace entire files unnecessarily."

Specialist PersonaLaunch

Pragmatic Rapid Prototyping

Generate a Pragmatic Rapid Prototyping CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Prioritize working software over complex design patterns or deep inheritance hierarchies."

Specialist PersonaLaunch

Zero-Trust Security

Generate a Zero-Trust Security CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Flag and prevent any dynamic SQL query string interpolation."

DevOps & ToolingLaunch

Docker & CI/CD

Generate a Docker & CI/CD CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Always use multi-stage Docker builds to separate builder tools from the lean production image."

Specialist PersonaLaunch

Vitest & Playwright TDD

Generate a Vitest & Playwright TDD CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Write unit tests covering happy paths and at least two edge/error cases for every new function."

Specialist PersonaLaunch

Automated Code Reviewer

Generate a Automated Code Reviewer CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Scan repository manifests to map stack idioms before evaluating logic."

Specialist PersonaLaunch

Multi-Agent System Orchestration

Generate a Multi-Agent System Orchestration CLAUDE.md repository guideline for Claude Code.

Enforced Invariant:

"Define subagent roles: Lead Architect, Frontend Engineer, Backend Specialist, Security Reviewer."

04 / BEST PRACTICES
Keep CLAUDE.md concise and high-density (under 200 lines).
Always document the single command to run tests and typecheck.
State forbidden patterns explicitly (e.g. 'Do not use npm install; use pnpm only').
Keep commands updated whenever dependencies or build tooling changes.
Other Format DirectoriesHub Network
05 / FREQUENTLY ASKED QUESTIONS

Where should CLAUDE.md be placed?

CLAUDE.md should be located in the root directory of your repository. Claude Code automatically looks for and loads this file when you run claude in terminal.

Can I use CLAUDE.md alongside Cursor .mdc rules?

Yes! They complement each other. CLAUDE.md provides overall project build/test commands and repository orientation, while .cursor/rules/*.mdc provides granular, file-glob scoped editing rules.