Project Spec Skill

Core Principle: A good CLAUDE.md means Claude never has to guess.

Template Selection

Defaults (Don't specify if these apply)

Code maturity: Production
Maintainer: Solo dev
Lifetime: Multi-year
Tech debt: Minimal, documented
Failure impact: Business-impacting
Code ownership: Shared
Review strictness: Standard
Error handling: Fail fast
Logging: Basic (errors)
Data sensitivity: Personal
UI tolerance: Visually close
Refactor permission: None
Dependency policy: Well-known only
Human review: Detailed
Output timing: Correctness first (not fast draft)
Partial completion: Not acceptable
Session: Expect interruptions, be resumable

Only specify deviations from defaults.

Required Sections (Every CLAUDE.md)

[CRITICAL] Critical Rules (stop-on-missing, non-goals)
[CRITICAL] Project Overview (type, goal, timeline)
[CRITICAL] Scope (in/out/future)
[CRITICAL] Constraints
[CRITICAL] Definition of Done

Critical Rules Block (Copy to every CLAUDE.md)

## ⚠️ Critical Rules

**If info missing:** STOP → List missing → Ask → Do NOT assume

**Claude must NOT:**
- Add features outside this document
- Add dependencies without approval
- Refactor unrelated code
- Make "improvements" outside scope

**Authority:** CLAUDE.md > skills > comments > chat > assumptions (FORBIDDEN)

Anti-Patterns

Tier Markers

References

• template-minimal.md — Quick builds
• template-full.md — Complex projects
• examples.md — Real examples