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:
- Start projects right - Discovery interview extracts what you want to build
- Map to architecture - Translates your answers into technical decisions
- Stay on track - Session logging, decision tracking, phase management
- Avoid common bugs - Gotcha guides for SwiftUI, web, coordinates, etc.
- Ship with confidence - Production checklists and quality guides
- Copy this folder to your project as
/docs - 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. - Start a Claude session - it will run the discovery interview
- 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
| File | Purpose |
|---|---|
00_base.md |
Bootstrap - read this first every session |
04_architecture-decisions.md |
Maps your needs to technical choices |
PROJECT_STATE.md |
Tracks current phase and focus |
decisions.md |
Records why you chose X over Y |
sessions/_index.md |
Session history and handoff notes |
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.
MIT - Use freely, modify as needed.