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

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:

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

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

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.)

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

CLAUDE.md

CLAUDE.md

Project Overview

File Structure

Role and Responsibilities

Primary Tasks

Key Game Concepts

Core Mechanics

Unique Systems

Combat Domains

Working Guidelines

Related Skills

Markdown Converter

Nano Banana Pro

1password

CLAUDE.md

Project Overview

File Structure

Role and Responsibilities

Primary Tasks

Key Game Concepts

Core Mechanics

Unique Systems

Combat Domains

Working Guidelines