docs: refactor documentation for Foundry VTT + PF1e project
- Rewrite README.md to focus on Foundry VTT + Pathfinder 1e development - Refactor QUICKSTART.md as practical setup guide (5 minutes) - Add project-specific sections: setup, macros, PF1 system, API reference - Include development workflow and common tasks - Add troubleshooting guide for Foundry-specific issues - Remove generic Claude Code setup documentation (CLAUDE_CODE_SETUP_COMPLETE.md, CLAUDE_TEMPLATE.md, MCP_SERVERS_GUIDE.md, MCP_DOCUMENTATION_SUMMARY.md, .gitignore.README.md) - Keep CLAUDE.md as comprehensive reference documentation Documentation now aligns with project scope: Foundry VTT v11.315 + Pathfinder 1e v10.8 + custom macros. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
809
QUICKSTART.md
809
QUICKSTART.md
@@ -1,641 +1,326 @@
|
||||
# Claude Code Quickstart Guide
|
||||
# Foundry VTT + Pathfinder 1e Quick Start Guide
|
||||
|
||||
> **Get started with Claude Code Setup in 5 minutes**
|
||||
> **Version**: 3.0.0 | **Last Updated**: 2025-10-20
|
||||
> **Get started with Foundry VTT development in 5 minutes**
|
||||
>
|
||||
> **Version**: 1.0.0 | **Last Updated**: 2025-01-30
|
||||
|
||||
---
|
||||
|
||||
## What's Configured?
|
||||
## 🚀 What You'll Do in 5 Minutes
|
||||
|
||||
This project has **Claude Code fully configured** with:
|
||||
|
||||
✅ **8 MCP Servers** - Code navigation, memory, docs, automation
|
||||
✅ **8 Specialized Agents** - Architecture, review, debug, security, testing
|
||||
✅ **9 Slash Commands** - Analyze, review, implement, test, optimize, adr
|
||||
✅ **6 Output Styles** - Concise, professional, verbose, learning, explanatory, security
|
||||
✅ **6 Event Hooks** - Session lifecycle, bash, file operations, stop tracking
|
||||
✅ **Complete Templates** - Extend all features easily
|
||||
✅ **Automatic Status Summaries** - Every response includes tool usage details
|
||||
1. Install PF1 system dependencies (**1 min**)
|
||||
2. Build the PF1 system (**2 min**)
|
||||
3. Launch Foundry VTT (**1 min**)
|
||||
4. Create and test a macro (**1 min**)
|
||||
|
||||
---
|
||||
|
||||
## Quick Commands
|
||||
|
||||
### Essential Commands
|
||||
## Step 1: Install Dependencies (1 minute)
|
||||
|
||||
```bash
|
||||
/help # Get help
|
||||
/setup-info # See full configuration
|
||||
/cost # View token usage
|
||||
/rewind # Undo changes (ESC ESC also works)
|
||||
# Navigate to PF1 system directory
|
||||
cd src/foundryvtt-pathfinder1-v10.8
|
||||
|
||||
# Install npm packages
|
||||
npm install
|
||||
```
|
||||
|
||||
### Development Commands
|
||||
✅ **Done!** Dependencies are installed.
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Build the PF1 System (2 minutes)
|
||||
|
||||
```bash
|
||||
/adr [list|view|create|update] # Manage Architectural Decision Records
|
||||
/analyze [path] # Comprehensive code analysis
|
||||
/review [file-or-path] # Code review with best practices
|
||||
/implement [feature] # Implement new features
|
||||
/test [file-path] # Run and analyze tests
|
||||
/optimize [file] # Performance optimization
|
||||
/explain [file] # Detailed code explanation
|
||||
/scaffold [type] [name] # Generate boilerplate
|
||||
# Still in src/foundryvtt-pathfinder1-v10.8
|
||||
|
||||
# Production build (one-time)
|
||||
npm run build
|
||||
|
||||
# OR for development (watches for changes)
|
||||
npm run build:watch
|
||||
```
|
||||
|
||||
### Workflow Examples
|
||||
✅ **Done!** System is built and ready.
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Launch Foundry VTT (1 minute)
|
||||
|
||||
### Option A: Run Executable (Recommended)
|
||||
|
||||
```bash
|
||||
# Quick code review
|
||||
> /review src/components/
|
||||
# Navigate to Foundry directory
|
||||
cd ../FoundryVTT-11.315
|
||||
|
||||
# Implement feature
|
||||
> /implement user authentication with JWT
|
||||
# Run Foundry (Windows)
|
||||
.\foundryvtt.exe
|
||||
|
||||
# Run tests
|
||||
> /test
|
||||
# Or double-click foundryvtt.exe in File Explorer
|
||||
```
|
||||
|
||||
# Get analysis
|
||||
> /analyze src/services/payment.ts
|
||||
### Option B: Run via Node.js
|
||||
|
||||
```bash
|
||||
cd src/FoundryVTT-11.315
|
||||
node resources/app/main.js
|
||||
```
|
||||
|
||||
✅ **Done!** Foundry VTT is running.
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Test a Macro (1 minute)
|
||||
|
||||
### Create & Import Arcane Pool Macro
|
||||
|
||||
1. Open Foundry VTT in browser (usually http://localhost:30000)
|
||||
2. Create or open a world
|
||||
3. Click **Macro Directory** in the sidebar
|
||||
4. Click **Create Macro**
|
||||
5. Set **Macro Type** to "Script"
|
||||
6. Copy content from `src/macro.js`
|
||||
7. Click **Save Macro**
|
||||
8. Drag macro to hotbar
|
||||
|
||||
### Test the Macro
|
||||
|
||||
1. Select a token on the canvas (any character)
|
||||
2. Click the macro on the hotbar
|
||||
3. You should see a notification or dialog
|
||||
|
||||
✅ **Done!** Your first macro works!
|
||||
|
||||
---
|
||||
|
||||
## 📚 Next Steps (10-30 minutes)
|
||||
|
||||
### Option A: Build a Custom Macro
|
||||
|
||||
1. Open browser console (F12)
|
||||
2. Try simple commands:
|
||||
```javascript
|
||||
// Get current token's actor
|
||||
console.log(token.actor.name);
|
||||
|
||||
// Get actor's HP
|
||||
console.log(token.actor.system.attributes.hp);
|
||||
|
||||
// Get Arcane Pool resource
|
||||
console.log(token.actor.system.resources.classFeat_arcanePool);
|
||||
```
|
||||
|
||||
3. Create `src/macro_mytest.js`:
|
||||
```javascript
|
||||
(async () => {
|
||||
if (!token) {
|
||||
ui.notifications.warn("Select a token!");
|
||||
return;
|
||||
}
|
||||
|
||||
const actor = token.actor;
|
||||
ui.notifications.info(`Selected: ${actor.name}`);
|
||||
})();
|
||||
```
|
||||
|
||||
4. Import macro in Foundry and test
|
||||
|
||||
### Option B: Modify the PF1 System
|
||||
|
||||
1. Edit a file in `src/foundryvtt-pathfinder1-v10.8/module/`
|
||||
2. Run `npm run build` (already running in watch mode)
|
||||
3. Reload Foundry (F5)
|
||||
4. Test your change
|
||||
|
||||
### Option C: Explore the Code
|
||||
|
||||
1. Read [CLAUDE.md](CLAUDE.md) for complete documentation
|
||||
2. Check out macro examples: `src/macro.js`, `src/macro_haste.js`
|
||||
3. Review PF1 system structure: `src/foundryvtt-pathfinder1-v10.8/module/`
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Common Commands
|
||||
|
||||
```bash
|
||||
# Build PF1 system
|
||||
npm run build
|
||||
|
||||
# Development mode (auto-rebuild)
|
||||
npm run build:watch
|
||||
|
||||
# Lint code
|
||||
npm run lint
|
||||
|
||||
# Format code
|
||||
npm run format
|
||||
|
||||
# Extract compendium packs
|
||||
npm run packs:extract
|
||||
|
||||
# Compile compendium packs
|
||||
npm run packs:compile
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MCP Servers (8 Available)
|
||||
## 🎮 Foundry VTT Basics
|
||||
|
||||
### 🎯 Most Useful
|
||||
### Global Objects Available in Macros
|
||||
|
||||
**Serena** - Code navigation + persistent memory
|
||||
```bash
|
||||
# Find code
|
||||
find_symbol("UserService")
|
||||
find_referencing_symbols("authenticate", "src/auth/")
|
||||
|
||||
# Store knowledge (survives sessions)
|
||||
write_memory("adr-001-architecture", "Decision: Use microservices...")
|
||||
read_memory("adr-001-architecture")
|
||||
```javascript
|
||||
game.actors // All actors
|
||||
game.items // All items
|
||||
game.macros // All macros
|
||||
game.scenes // All scenes
|
||||
ui.notifications // Toast notifications
|
||||
canvas // Canvas/rendering
|
||||
```
|
||||
|
||||
**Context7** - Real-time library docs
|
||||
```bash
|
||||
# Get current framework documentation
|
||||
resolve-library-id("react")
|
||||
get-library-docs("/facebook/react")
|
||||
```
|
||||
### Common Macro Pattern
|
||||
|
||||
**Memory Graph** - Temporary session context
|
||||
```bash
|
||||
# Build context for current task (cleared after session)
|
||||
create_entities([{name: "UserService", type: "Class"}])
|
||||
create_relations([{from: "UserService", to: "AuthMiddleware"}])
|
||||
```
|
||||
```javascript
|
||||
(async () => {
|
||||
// 1. Validate
|
||||
if (!token) {
|
||||
ui.notifications.warn("Select a token!");
|
||||
return;
|
||||
}
|
||||
|
||||
### 🔧 Automation
|
||||
// 2. Get data
|
||||
const actor = token.actor;
|
||||
const hp = actor.system.attributes.hp;
|
||||
|
||||
**Playwright** - Browser automation
|
||||
**Windows MCP** - Desktop automation
|
||||
**Fetch** - Web scraping
|
||||
// 3. Do something
|
||||
await actor.update({
|
||||
"system.attributes.hp.value": hp.value - 10
|
||||
});
|
||||
|
||||
### 💾 Databases
|
||||
|
||||
**Database Server** - General database queries
|
||||
|
||||
### 🧠 Reasoning
|
||||
|
||||
**Sequential Thinking** - Complex problem solving with extended thinking
|
||||
|
||||
---
|
||||
|
||||
## Agents (8 Specialized)
|
||||
|
||||
### How to Use
|
||||
|
||||
**Automatic**: Just mention the domain
|
||||
```bash
|
||||
> "I need to design a microservices architecture"
|
||||
# → Architect agent automatically invoked
|
||||
```
|
||||
|
||||
**Manual**: Explicitly request
|
||||
```bash
|
||||
> "Use the security-analyst agent to review this code"
|
||||
# → Security analyst explicitly invoked
|
||||
```
|
||||
|
||||
### Available Agents
|
||||
|
||||
| Agent | Use For | Keywords |
|
||||
|-------|---------|----------|
|
||||
| **architect** | System design, technical planning | architecture, design, scalability |
|
||||
| **code-reviewer** | Code quality, best practices | review, quality, standards |
|
||||
| **debugger** | Bug diagnosis, troubleshooting | debug, error, bug, issue |
|
||||
| **documentation-writer** | Technical docs, README | documentation, docs, readme |
|
||||
| **project-manager** | Task breakdown, coordination | project, manage, coordinate |
|
||||
| **refactoring-specialist** | Code improvement, cleanup | refactor, improve, cleanup |
|
||||
| **security-analyst** | Security analysis, vulnerabilities | security, vulnerability, audit |
|
||||
| **test-engineer** | Testing strategy, test generation | test, testing, coverage |
|
||||
|
||||
---
|
||||
|
||||
## Output Styles (6 Available)
|
||||
|
||||
Change how Claude responds:
|
||||
|
||||
```bash
|
||||
/output-style concise # Brief, minimal explanation
|
||||
/output-style professional # Formal, business-appropriate
|
||||
/output-style verbose # Detailed, comprehensive
|
||||
/output-style explanatory # Educational insights
|
||||
/output-style learning # Interactive - Claude teaches YOU
|
||||
/output-style security-reviewer # Security-focused analysis
|
||||
/output-style default # Return to standard
|
||||
```
|
||||
|
||||
### Quick Guide
|
||||
|
||||
- **Quick fixes**: Use `concise`
|
||||
- **Learning**: Use `learning` or `explanatory`
|
||||
- **Reports**: Use `professional`
|
||||
- **Deep understanding**: Use `verbose`
|
||||
- **Security work**: Use `security-reviewer`
|
||||
|
||||
---
|
||||
|
||||
## Advanced Features
|
||||
|
||||
### Extended Thinking
|
||||
|
||||
For complex problems, use thinking keywords:
|
||||
```bash
|
||||
> "Think hard about the best database architecture"
|
||||
> "Ultrathink: How should I optimize this algorithm?"
|
||||
```
|
||||
|
||||
Levels: `think` → `think hard` → `think harder` → `ultrathink`
|
||||
|
||||
### Plan Mode
|
||||
|
||||
**Toggle**: Press `Tab` key
|
||||
|
||||
**Use**: Explore code safely before making changes
|
||||
1. Enter plan mode (Tab)
|
||||
2. Explore and understand
|
||||
3. Exit plan mode (Tab)
|
||||
4. Execute changes
|
||||
|
||||
### Checkpointing
|
||||
|
||||
**Access**: Press `ESC ESC` or `/rewind`
|
||||
|
||||
**Options**:
|
||||
- Code only (keep conversation)
|
||||
- Conversation only (keep files)
|
||||
- Both (complete rollback)
|
||||
|
||||
**Retention**: 30 days
|
||||
|
||||
### Parallel Execution
|
||||
|
||||
Claude can run multiple operations simultaneously:
|
||||
```bash
|
||||
# Multiple file reads
|
||||
> "Read src/auth/service.ts, src/auth/middleware.ts, and src/auth/utils.ts"
|
||||
|
||||
# Multiple agents
|
||||
> "I need code review and security analysis"
|
||||
// 4. Feedback
|
||||
ui.notifications.info("Damage applied!");
|
||||
})();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Memory System
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
### Three Memory Types
|
||||
### Macro Not Working?
|
||||
|
||||
**1. Project Instructions (CLAUDE.md)**
|
||||
- Team-shared project conventions
|
||||
- Auto-loaded every session
|
||||
- Location: [CLAUDE.md](CLAUDE.md)
|
||||
|
||||
**2. Persistent Memory (Serena)**
|
||||
- Survives across sessions
|
||||
- Store ADRs, lessons, patterns
|
||||
```bash
|
||||
write_memory("name", "content")
|
||||
read_memory("name")
|
||||
list_memories()
|
||||
```javascript
|
||||
// Check browser console (F12)
|
||||
console.log(token); // Is token selected?
|
||||
console.log(token.actor); // Does actor exist?
|
||||
console.log(actor.system); // What data is available?
|
||||
```
|
||||
|
||||
**3. Temporary Memory (Knowledge Graph)**
|
||||
- Current session only
|
||||
- Entity relationships
|
||||
```bash
|
||||
create_entities([...])
|
||||
create_relations([...])
|
||||
read_graph()
|
||||
```
|
||||
|
||||
### When to Use What?
|
||||
|
||||
**Should it exist next week?**
|
||||
- YES → Serena persistent memory
|
||||
- NO → Knowledge graph
|
||||
|
||||
---
|
||||
|
||||
## Hooks (Automated Actions)
|
||||
|
||||
**5 hooks configured** - execute automatically:
|
||||
|
||||
| Hook | Trigger | Current Action |
|
||||
|------|---------|----------------|
|
||||
| session-start | Session begins | Create logs, log start |
|
||||
| session-end | Session ends | Final logging |
|
||||
| pre-bash | Before bash commands | Command logging |
|
||||
| post-write | After file writes | Write logging, (auto-format optional) |
|
||||
| user-prompt-submit | After prompt | Prompt tracking |
|
||||
|
||||
**Logs location**: `.claude/logs/`
|
||||
|
||||
---
|
||||
|
||||
## Creating Custom Features
|
||||
|
||||
### Custom Command
|
||||
### Build Failed?
|
||||
|
||||
```bash
|
||||
# 1. Copy template
|
||||
cp .claude/commands/.COMMANDS_TEMPLATE.md .claude/commands/deploy.md
|
||||
|
||||
# 2. Edit file (add frontmatter and instructions)
|
||||
---
|
||||
description: Deploy application to production
|
||||
argument-hint: [environment]
|
||||
allowed-tools: Bash(git *:*), Bash(npm *:*), Read(*)
|
||||
---
|
||||
|
||||
# 3. Use it
|
||||
> /deploy production
|
||||
# Clean and rebuild
|
||||
cd src/foundryvtt-pathfinder1-v10.8
|
||||
rm -r dist node_modules
|
||||
npm install
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Custom Agent
|
||||
### Foundry Won't Start?
|
||||
|
||||
```bash
|
||||
# 1. Copy template
|
||||
cp .claude/agents/.AGENT_TEMPLATE.md .claude/agents/api-tester.md
|
||||
|
||||
# 2. Configure frontmatter and instructions
|
||||
---
|
||||
name: api-tester
|
||||
description: API testing and validation specialist
|
||||
allowed-tools: Read(*), Bash(curl:*), Bash(npm test:*)
|
||||
---
|
||||
|
||||
# 3. Use it
|
||||
> "Use the api-tester agent to test our REST API"
|
||||
```
|
||||
|
||||
### Custom Output Style
|
||||
|
||||
```bash
|
||||
# 1. Copy template
|
||||
cp .claude/output-styles/.OUTPUT_STYLES_TEMPLATE.md .claude/output-styles/debugging-mode.md
|
||||
|
||||
# 2. Define behavior
|
||||
---
|
||||
name: debugging-mode
|
||||
description: Systematic debugging with detailed analysis
|
||||
---
|
||||
|
||||
# 3. Activate
|
||||
> /output-style debugging-mode
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Workflows
|
||||
|
||||
### Feature Development
|
||||
|
||||
```bash
|
||||
# 1. Architecture
|
||||
> "Use architect agent to design payment integration"
|
||||
|
||||
# 2. Implement
|
||||
> /implement Stripe payment integration
|
||||
|
||||
# 3. Test
|
||||
> /test src/payments/
|
||||
|
||||
# 4. Review
|
||||
> /review src/payments/
|
||||
|
||||
# 5. Document
|
||||
> "Use documentation-writer agent to document payment flow"
|
||||
|
||||
# 6. Commit
|
||||
> "Create git commit"
|
||||
|
||||
# After each step, you'll see a status summary showing:
|
||||
# - What was done
|
||||
# - Which agents/commands/MCP servers were used
|
||||
# - Files modified
|
||||
```
|
||||
|
||||
### Bug Fixing
|
||||
|
||||
```bash
|
||||
# 1. Debug
|
||||
> "Use debugger agent: [paste error]"
|
||||
|
||||
# 2. Extended thinking (for complex bugs)
|
||||
> "Think hard about this race condition"
|
||||
|
||||
# 3. Review fix
|
||||
> /review [fixed file]
|
||||
|
||||
# 4. Test
|
||||
> /test
|
||||
```
|
||||
|
||||
### Code Review
|
||||
|
||||
```bash
|
||||
# 1. Standard review
|
||||
> /review src/
|
||||
|
||||
# 2. Security check
|
||||
> "Use security-analyst agent to check vulnerabilities"
|
||||
|
||||
# 3. Refactoring suggestions
|
||||
> "Use refactoring-specialist agent for improvements"
|
||||
```
|
||||
|
||||
### Learning Codebase
|
||||
|
||||
```bash
|
||||
# 1. Use explanatory style
|
||||
> /output-style explanatory
|
||||
|
||||
# 2. High-level questions
|
||||
> "Explain the architecture of this project"
|
||||
> "How does authentication work?"
|
||||
|
||||
# 3. Deep dive with Serena
|
||||
> get_symbols_overview("src/core/engine.ts")
|
||||
> find_symbol("Engine/initialize")
|
||||
|
||||
# 4. Store learnings
|
||||
> write_memory("architecture-overview", "The system uses...")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File Shortcuts
|
||||
|
||||
### Reference Files
|
||||
|
||||
Use `@` to include files in prompts:
|
||||
```bash
|
||||
> "Review @src/auth/service.ts"
|
||||
> "Explain @src/utils/*.ts"
|
||||
```
|
||||
|
||||
### Import in CLAUDE.md
|
||||
|
||||
Import additional context:
|
||||
```markdown
|
||||
@docs/architecture.md
|
||||
@docs/coding-standards.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configuration Quick Reference
|
||||
|
||||
### Key Files
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `.claude/settings.json` | Main configuration (shared) |
|
||||
| `.claude/settings.local.json` | Personal config (not in git) |
|
||||
| `.mcp.json` | MCP servers |
|
||||
| `CLAUDE.md` | Project instructions |
|
||||
| `.claude/agents/*.md` | Specialized agents |
|
||||
| `.claude/commands/*.md` | Slash commands |
|
||||
| `.claude/output-styles/*.md` | Response styles |
|
||||
| `.claude/hooks/*.sh` | Automation scripts |
|
||||
|
||||
### Permissions
|
||||
|
||||
**Location**: `.claude/settings.json` → `permissions`
|
||||
|
||||
```json
|
||||
{
|
||||
"allowed": ["Read(*)", "Write(*)", "Bash(git *:*)"],
|
||||
"ask": ["Bash(npm install:*)"],
|
||||
"denied": ["Bash(rm -rf /:*)"]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Keyboard Shortcuts
|
||||
|
||||
- `Tab` - Toggle plan mode
|
||||
- `ESC ESC` - Access checkpoints
|
||||
- `Ctrl+C` - Interrupt Claude
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Agent Not Working
|
||||
|
||||
```bash
|
||||
# Check it exists
|
||||
ls .claude/agents/
|
||||
|
||||
# Check description has keywords
|
||||
cat .claude/agents/[name].md
|
||||
|
||||
# Try manual invocation
|
||||
> "Use the [agent-name] agent to..."
|
||||
|
||||
# Restart Claude
|
||||
```
|
||||
|
||||
### Command Not Found
|
||||
|
||||
```bash
|
||||
# Check it exists
|
||||
ls .claude/commands/
|
||||
|
||||
# List available
|
||||
> /help
|
||||
|
||||
# Restart Claude
|
||||
```
|
||||
|
||||
### MCP Server Failed
|
||||
|
||||
```bash
|
||||
# Check configuration
|
||||
cat .mcp.json | jq '.mcpServers'
|
||||
|
||||
# Test command manually
|
||||
npx -y @modelcontextprotocol/server-sequential-thinking
|
||||
|
||||
# Check logs
|
||||
cat .claude/logs/session.log
|
||||
cat src/FoundryVTT-11.315/Data/Logs/foundry.log
|
||||
|
||||
# Try Node.js directly
|
||||
cd src/FoundryVTT-11.315
|
||||
node resources/app/main.js
|
||||
```
|
||||
|
||||
### Permission Denied
|
||||
### Port Already in Use?
|
||||
|
||||
Foundry defaults to port 30000. If in use:
|
||||
```bash
|
||||
# Check permissions
|
||||
cat .claude/settings.json | jq '.permissions'
|
||||
# Find process using port
|
||||
netstat -ano | findstr :30000
|
||||
|
||||
# Add to allowed
|
||||
# Edit settings.json → permissions → allowed array
|
||||
|
||||
# Restart Claude
|
||||
# Kill process (Windows)
|
||||
taskkill /PID <PID> /F
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Tips & Tricks
|
||||
## 📖 Documentation
|
||||
|
||||
### 🚀 Performance
|
||||
|
||||
1. **Use concise style** for quick tasks
|
||||
2. **Parallel operations** when possible
|
||||
3. **Serena symbol tools** instead of full file reads
|
||||
4. **Extended thinking** only for complex problems
|
||||
|
||||
### 🎯 Effectiveness
|
||||
|
||||
1. **Start broad, then narrow** - high-level first, details later
|
||||
2. **Use appropriate tools** - agents for domains, commands for workflows
|
||||
3. **Leverage memory** - store ADRs, lessons, patterns
|
||||
4. **Reference files** with `@` syntax
|
||||
|
||||
### 🔐 Security
|
||||
|
||||
1. **Review hooks** before using
|
||||
2. **Restrict sensitive tools** in permissions
|
||||
3. **Use security-analyst** for audits
|
||||
4. **Never commit secrets** to CLAUDE.md
|
||||
|
||||
### 📈 Learning
|
||||
|
||||
1. **Use explanatory style** for understanding
|
||||
2. **Extended thinking** for complex topics
|
||||
3. **Store learnings** in Serena memory
|
||||
4. **Learning style** for hands-on practice
|
||||
| Document | Purpose | Read Time |
|
||||
|----------|---------|-----------|
|
||||
| **[README.md](README.md)** | Project overview & setup | 10 min |
|
||||
| **[CLAUDE.md](CLAUDE.md)** | Complete technical documentation | 30 min |
|
||||
| **Foundry API** | https://foundryvtt.com/api/v11/ | Reference |
|
||||
| **PF1 GitHub** | https://github.com/Furyspark/foundryvtt-pathfinder1 | Reference |
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
## 🎯 Success Checklist
|
||||
|
||||
### New Users
|
||||
After this quickstart, you should be able to:
|
||||
|
||||
1. Try basic commands: `/help`, `/setup-info`
|
||||
2. Experiment with agents: "Use the [agent] agent to..."
|
||||
3. Try output styles: `/output-style learning`
|
||||
4. Create your first custom command
|
||||
|
||||
### Experienced Users
|
||||
|
||||
1. Set up personal `.claude/settings.local.json`
|
||||
2. Create project-specific agents
|
||||
3. Configure hooks for your workflow
|
||||
4. Leverage MCP servers fully
|
||||
|
||||
### Team Setup
|
||||
|
||||
1. Review and customize `CLAUDE.md`
|
||||
2. Add team-specific commands
|
||||
3. Configure permissions
|
||||
4. Share setup via git
|
||||
- [x] Install and build PF1 system
|
||||
- [x] Launch Foundry VTT
|
||||
- [x] Create a macro
|
||||
- [x] Execute a macro in-game
|
||||
- [x] Access browser console (F12)
|
||||
- [x] Modify macro code
|
||||
- [x] Understand basic actor/item API
|
||||
|
||||
---
|
||||
|
||||
## Resources
|
||||
## 🎓 Learn More
|
||||
|
||||
### Documentation
|
||||
### Beginner Topics
|
||||
- Creating your first macro
|
||||
- Understanding actor/item structure
|
||||
- Using the browser console
|
||||
|
||||
- **Complete Setup**: [CLAUDE_CODE_SETUP_COMPLETE.md](CLAUDE_CODE_SETUP_COMPLETE.md) - Full documentation
|
||||
- **Templates Guide**: [.claude/TEMPLATES_README.md](.claude/TEMPLATES_README.md) - Template details
|
||||
- **MCP Servers**: [MCP_SERVERS_GUIDE.md](MCP_SERVERS_GUIDE.md) - Complete MCP documentation
|
||||
- **MCP Templates**: [.claude/agents/MCP_USAGE_TEMPLATES.md](.claude/agents/MCP_USAGE_TEMPLATES.md) - Copy-paste templates for agents
|
||||
- **Official Docs**: https://docs.claude.com/en/docs/claude-code/
|
||||
### Intermediate Topics
|
||||
- Dialog-based user interfaces
|
||||
- Buff management systems
|
||||
- Macro chaining
|
||||
|
||||
### Templates
|
||||
### Advanced Topics
|
||||
- Modifying PF1 system code
|
||||
- Adding compendium content
|
||||
- Integrating Claude Code automation
|
||||
|
||||
- **Agent**: [.claude/agents/.AGENT_TEMPLATE.md](.claude/agents/.AGENT_TEMPLATE.md)
|
||||
- **Command**: [.claude/commands/.COMMANDS_TEMPLATE.md](.claude/commands/.COMMANDS_TEMPLATE.md)
|
||||
- **Skill**: [.claude/skills/.SKILL_TEMPLATE.md](.claude/skills/.SKILL_TEMPLATE.md)
|
||||
- **Output Style**: [.claude/output-styles/.OUTPUT_STYLES_TEMPLATE.md](.claude/output-styles/.OUTPUT_STYLES_TEMPLATE.md)
|
||||
- **Project**: [CLAUDE_TEMPLATE.md](CLAUDE_TEMPLATE.md)
|
||||
|
||||
### Get Help
|
||||
|
||||
1. `/help` - Built-in help
|
||||
2. `/setup-info` - Configuration details
|
||||
3. GitHub Issues: https://github.com/anthropics/claude-code/issues
|
||||
4. Official Docs: https://docs.claude.com/en/docs/claude-code/
|
||||
See [CLAUDE.md](CLAUDE.md) for detailed tutorials on all topics.
|
||||
|
||||
---
|
||||
|
||||
## Cheat Sheet
|
||||
## 💡 Quick Tips
|
||||
|
||||
```bash
|
||||
# Development
|
||||
/adr [action] [id] # Manage ADRs
|
||||
/analyze [path] # Code analysis
|
||||
/review [path] # Code review
|
||||
/implement [feature] # Feature implementation
|
||||
/test [file] # Run tests
|
||||
/optimize [file] # Optimize performance
|
||||
/explain [file] # Explain code
|
||||
|
||||
# Agents (automatic or manual)
|
||||
architect # System design
|
||||
code-reviewer # Code review
|
||||
debugger # Bug fixing
|
||||
documentation-writer # Docs
|
||||
security-analyst # Security
|
||||
test-engineer # Testing
|
||||
|
||||
# Output Styles
|
||||
/output-style concise # Brief
|
||||
/output-style learning # Interactive
|
||||
/output-style explanatory # Educational
|
||||
/output-style security-reviewer # Security-focused
|
||||
|
||||
# Memory
|
||||
write_memory(name, content) # Save (persistent)
|
||||
read_memory(name) # Load (persistent)
|
||||
create_entities([...]) # Build context (temporary)
|
||||
|
||||
# Extended Thinking
|
||||
think / think hard / ultrathink
|
||||
|
||||
# Shortcuts
|
||||
Tab # Plan mode toggle
|
||||
ESC ESC # Checkpoints
|
||||
@file # Reference file
|
||||
```
|
||||
1. **Always select a token** - Most macros require a token to be selected
|
||||
2. **Use F12 for debugging** - Browser console shows errors and logs
|
||||
3. **F5 reloads Foundry** - Refresh after system changes
|
||||
4. **Check notification** - Macros often provide user feedback via notifications
|
||||
5. **Save often** - Macros are stored in Foundry's database
|
||||
|
||||
---
|
||||
|
||||
**Version**: 3.0.0 | **Last Updated**: 2025-10-20
|
||||
## 🆘 Need Help?
|
||||
|
||||
**Ready to start?** Run `claude` and try:
|
||||
```bash
|
||||
> /setup-info
|
||||
> "Use the architect agent to explain the project structure"
|
||||
> /output-style learning
|
||||
```
|
||||
1. **Check [CLAUDE.md](CLAUDE.md)** - Complete documentation
|
||||
2. **Review examples** - `src/macro.js`, `src/macro_haste.js`
|
||||
3. **Browser console (F12)** - Error messages and debugging
|
||||
4. **Foundry logs** - `src/FoundryVTT-11.315/Data/Logs/foundry.log`
|
||||
|
||||
For complete documentation, see [CLAUDE_CODE_SETUP_COMPLETE.md](CLAUDE_CODE_SETUP_COMPLETE.md)
|
||||
---
|
||||
|
||||
## ✅ Ready to Continue?
|
||||
|
||||
**Next steps:**
|
||||
1. Try modifying the Arcane Pool macro
|
||||
2. Create your own custom macro
|
||||
3. Read [CLAUDE.md](CLAUDE.md) for advanced topics
|
||||
4. Explore PF1 system code
|
||||
|
||||
---
|
||||
|
||||
**Questions?** Check [README.md](README.md) or [CLAUDE.md](CLAUDE.md)
|
||||
|
||||
Reference in New Issue
Block a user