Files
FoundryVTT/.claude/SESSION_INSTRUCTIONS.md
2025-11-06 14:04:48 +01:00

107 lines
3.0 KiB
Markdown

# Session Instructions for Claude
**This file contains mandatory instructions for EVERY conversation session.**
---
## 🎯 Mandatory Tooling Usage Policy
**CRITICAL**: Claude Code must maximize the use of available advanced features for efficiency and quality.
### At the START of EVERY Task:
Provide a **Tooling Strategy Decision**:
```
### 🎯 Tooling Strategy Decision
**Task Analysis**: [Brief description of the task]
**Tooling Decisions**:
- **Agents**: Using [agent-name] / Not using - Reason: [specific justification]
- **Slash Commands**: Using [/command] / Not using - Reason: [specific justification]
- **MCP Servers**: Using [server: tool] / Not using - Reason: [specific justification]
- **Approach**: [Overall strategy for completing the task]
```
### At the END of EVERY Task:
Provide a **Task Completion Summary**:
```
### 📊 Task Completion Summary
**What Was Done**: [Brief description]
**Features Involved**:
- Agents: [List or None with justification]
- Slash Commands: [List or None with justification]
- MCP Servers: [List or None with justification]
- Core Tools: [List]
- Files Modified: [List]
- Performance: [Notes]
**Efficiency Notes**: [Observations]
```
---
## 📋 Available Resources
### Agents (8 total)
- **Explore**: Codebase exploration (quick/medium/thorough)
- **Plan**: Planning and design
- **test-engineer**: Generate comprehensive tests
- **code-reviewer**: Code quality reviews
- **refactoring-specialist**: Code cleanup
- **debugger**: Bug diagnosis
- **architect**: System design
- **documentation-writer**: Comprehensive docs
- **security-analyst**: Security reviews
### MCP Servers (8 total)
- **serena**: Code navigation, symbol search, memory
- **sequential-thinking**: Complex reasoning
- **context7**: Library documentation
- **memory**: Knowledge graph
- **fetch**: Web content retrieval
- **windows-mcp**: Desktop automation
- **playwright**: Browser automation
- **database-server**: SQL access
### Slash Commands (9 total)
- `/test [file]`: Generate and run tests
- `/review [file]`: Code review
- `/explain [file]`: Explain code
- `/analyze [path]`: Code analysis
- `/optimize [file]`: Performance optimization
- `/implement [desc]`: Feature implementation
- `/scaffold [type]`: Generate boilerplate
- `/adr [action]`: Manage ADRs
- `/setup-info`: Display setup info
---
## ⚠️ When NOT to Use Advanced Features
Only skip agents/slash commands/MCP when:
- Single file reads with known path
- Simple edits to existing code
- Tasks completable in 1-2 tool calls
- Purely conversational/informational requests
**Always state explicitly if skipping**: "Not using [feature] because [reason]"
---
## 🎯 Project Context
- **Project**: Foundry VTT v11.315 + PF1e System v10.8
- **Purpose**: Macro development and game system debugging
- **Main Files**: src/macro.js, src/macro_haste.js, CLAUDE.md
- **Documentation**: See CLAUDE.md for full project details
---
**Reference**: See [CLAUDE.md](../CLAUDE.md) for complete project documentation