A systematic approach to AI-assisted software development.

For people who direct AI to build software but don't code themselves.

Directions is a documentation system that helps you:

1. Start projects right - Discovery interview extracts what you want to build
2. Map to architecture - Translates your answers into technical decisions
3. Stay on track - Session logging, decision tracking, phase management
4. Avoid common bugs - Gotcha guides for SwiftUI, web, coordinates, etc.
5. Ship with confidence - Production checklists and quality guides

1. Copy this folder to your project as /docs
2. Add to your CLAUDE.md:

   ## Context
   Read docs/00_base.md at the start of every session.
   Check docs/PROJECT_STATE.md for current focus.

3. Start a Claude session - it will run the discovery interview
4. Build your project phase by phase

docs/
├── 00_base.md                    ← Start here (bootstrap)
├── 01_quick-reference.md         ← Daily cheatsheet
├── 02_mental-model.md            ← Philosophy
├── 03_workflow-phases.md         ← The process
├── 04_architecture-decisions.md  ← Interview → tech mapping
│
├── PROJECT_STATE.md              ← Current project status
├── decisions.md                  ← Why we chose X over Y
├── sessions/                     ← Session history
│
├── 10-19: Setup docs
├── 20-29: Technical gotchas
├── 30-39: Quality & debugging
├── 40-49: Terminology reference
└── 50-59: Advanced patterns

Discovery Interview → Architecture Mapping → Phase-by-Phase Building
         ↓                    ↓                      ↓
   "What do you              Maps to            30-min testable
    want to build?"       tech decisions          increments

Essential files for every session.

New project checklists and templates.

Platform-specific gotchas and patterns:

• SwiftUI issues
• Coordinate systems (image/video)
• macOS platform specifics
• Web development

Production readiness and debugging.

Reference for UI elements, typography, data structures.

Large project management, planning patterns.

Directions works alongside Claude Code's features:

• planning-with-files skill: Use for task execution
• Directions: Use for project knowledge and decisions

They complement each other:

• planning-with-files = "What am I doing right now?"
• Directions = "What is this project and why these choices?"

Synthesized from 229 documentation files across 15+ shipped macOS/iOS projects.

Install as a Claude Code plugin for automatic hooks and context loading:

# Clone the repo
git clone https://github.com/Xpycode/LLM-Directions.git

# Run the install script
cd LLM-Directions
./install-directions.sh

Or manually:

mkdir -p ~/.claude/plugins/local
ln -sf /path/to/LLM-Directions ~/.claude/plugins/local/directions
cp commands/* ~/.claude/commands/
cp CLAUDE-GLOBAL-TEMPLATE.md ~/.claude/CLAUDE.md
# Edit ~/.claude/CLAUDE.md to set your local paths

Restart Claude Code after installing.

Just copy the slash commands without hooks:

cp -r commands/* ~/.claude/commands/

When installed as a plugin, Directions provides automatic hooks:

Keyword → Doc Suggestions:

• "coordinates", "position" → 21_coordinate-systems.md
• "not updating", "@state" → 20_swiftui-gotchas.md
• "sandbox", "bookmark" → 22_macos-platform.md
• "debug", "bug" → 31_debugging.md
• "ship", "release" → 30_production-checklist.md

See CLAUDE-GLOBAL-TEMPLATE.md for a template to put in ~/.claude/CLAUDE.md.

This enables automatic project detection and setup when starting Claude in any folder.

MIT - Use freely, modify as needed.