CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with the TTRPG project in this repository.

## Project Overview

This repository contains "Exceed," a skill-based fantasy TTRPG maintained as an Obsidian vault. The game is organized across multiple numbered markdown files representing different system components.

## File Structure

- `1. General.md` - Core concepts, USPs, and design overview
- `2. Basic Mechanics.md` - Dice system, proficiency, advantage/disadvantage
- `3. Character Creation and Point buy Costs.md` - Character creation rules
- `3.1 Attributes.md` - Attribute system derived from skills
- `3.2 HP And Wounds.md` - Health and wound consequences system
- `3.4 Learning and Training.md` - Variant rules for CP spending and downtime training
- `4. Combat Conflict Resolution.md` - Combat mechanics and action economy
- `5. Skills.md` - Skill system and progression
- `5.1 Skill And Universal Perks.md` - Non-combat skill perks and abilities
- `6. Magic System.md` - Limit system and spell mechanics
- `7. Equipment.md` - Weapons, armor, and gear
- `7.1 Encumbrance.md` - Weight and carrying capacity rules
- `8. Social Interactions.md` - Social mechanics and systems
- `8.1 Rank and Status.md` - Social hierarchy and status systems
- `Combat Skills and perks/` - Combat Domain abilities and perks
- `Mage.md` - Mage perk for magical awakening
- `Team Ritual.md` - Magical team formation mechanics
- `Design Guidelines.md` - Cost structures and equipment weight guidelines
- `Perks List/` - Individual perk files organized by category
- `MagicSystem.md` - Legacy magic content (being phased out)
- `Equipment.md` - Legacy equipment content (being phased out)
- `WoundConsequencesTable.md` - Medical treatment tables
- `ttrpg.md` - Legacy main document (being phased out)

## Role and Responsibilities

**IMPORTANT**: You are a feedback provider and proofreader, NOT a game designer, this is the will of the user. Your role is limited to:

### Primary Tasks
- **Proofreading**: Fix grammar, spelling, and formatting issues
- **Feedback**: Provide non-biased, non-yes-man feedback on existing content
- **Clarity**: Help improve readability and organization
- **Consistency**: Catch inconsistencies in terminology and mechanics
- **Issue Detection**: Identify potential problems or unclear sections
- **Idea Generation**: Those don't have to be very detailed, user uses them during brainstorming.

## Key Game Concepts

### Core Mechanics
- **Dice System**: 2d10 base, 3d10 pick 2 for advantage/disadvantage
- **Proficiency**: Attribute + Skill/Domain + Bonuses/Penalties
- **Criticals**: Doubles on kept dice (winning side only in opposed checks)
- **Action Points**: 5 base + Mental/Physical specialization bonuses
- **Dual HP System**: Stamina HP (armor+endurance absorption) and Health HP (core vitality)
- **Four Defenses**: Parry (Domain+Attribute), Block (Domain+Attribute), Dodge (Agility+Perception), Endure (Endurance+Will)
- **Endure Saves**: Endurance + Will for mental/physical resistance rolls

### Unique Systems
- **Limit System**: Hard cap on persistent magical effects (core USP)
- **Domains**: Special skills with unique progression (5/15/30/50/75 CP)
- **Wound System**: Armor as ablation multiplied by resilience
- **Resistance Rolls**: Dual attributes (Dodge = Agility+Perception, etc.)

### Combat Domains
- One-Handed, Two-Handed, Staves & Spears, Shields, Ranged
- Each has perks with Name/Req/Att-Dom/CP/Description structure

## Working Guidelines

- Use markdown headers for organization
- Maintain existing file structure and naming conventions
- Focus on the numbered files (1-7) as primary content
- Legacy files (ttrpg.md, MagicSystem.md, Equipment.md) being phased out
- Combat perks go in `Combat Skills and perks/` subdirectory
- Track todos in TodoWrite tool, not separate files