# Atlas Prompt Quick Reference

## 🔴 Critical Additions (Would Have Caused Failures)

| Issue | Original | Fixed |
|-------|----------|-------|
| Session Management | None | 6-phase build with handoff instructions |
| Error Handling | None | Complete failure matrix with fallbacks |
| Authentication | "Device pairing" mentioned | Full token flow with refresh/revoke |
| Data Schemas | File names only | Complete TypeScript interfaces |
| API Contracts | Endpoint list | Full request/response specs |

## 🟡 Major Additions (Significant Gaps)

| Feature | Added |
|---------|-------|
| Offline-First | Service worker, IndexedDB, sync queue |
| Voice Fallback | Realtime → Whisper → Text cascade |
| Testing | Jest unit, integration, Playwright E2E |
| Observability | Health endpoints, logging, debug mode |
| PC Agent Security | Capability levels, allowlists, blocklists |
| Accessibility | WCAG 2.1 AA, ADHD accommodations |

## 🟢 Refinements (Polish)

- Explicit response templates
- Forbidden phrases list
- Sprint flow details
- Memory tier rules
- Voice command registry

## 📋 Session Workflow

```
Session 1: Foundation
├── Project structure
├── Broker skeleton
├── PWA shell
└── TODO LIST.md

Session 2: Core Infrastructure
├── SQLite + schemas
├── Auth system
├── WebSocket setup
└── Context CRUD

Session 3: Voice Integration
├── OpenAI Realtime
├── Transcript capture
├── Push-to-talk
└── Fallback chain

Session 4: ADHD Features
├── Focus copilot
├── NOW/NEXT/LATER
├── Resume UX
└── Memory capture

Session 5: PC Agent
├── Connection
├── Job execution
├── Rollback
└── Browser automation

Session 6: Polish
├── Onboarding
├── Workflows
├── Testing
└── Documentation
```

## 🎯 Key Commands for Claude Code

**Start a session:**
```
Let's start Phase 1: Foundation. Create the project structure, broker skeleton, PWA shell, and initialize TODO LIST.md.
```

**Resume a session:**
```
Continuing Atlas development. Last session completed Phase 2. Resume instructions were: [paste]. Let's start Phase 3: Voice Integration.
```

**Check progress:**
```
Show me the current TODO LIST.md and verify it matches the actual codebase.
```

**End a session:**
```
We need to wrap up. Please:
1. List all files created this session
2. Provide exact resume instructions
3. Update TODO LIST.md
```

## ⚠️ Common Pitfalls to Avoid

1. **Don't truncate the prompt** - Paste the full thing
2. **Don't skip phases** - Build in order
3. **Don't accept "TODO" in code** - Insist on working stubs
4. **Don't forget handoff** - Always get resume instructions
5. **Don't trust claims** - Verify TODO LIST.md matches reality

## 📊 Success Metrics

After MVP (Phase 4):
- [ ] PWA installs on iPhone
- [ ] Voice works (with fallback)
- [ ] Todos flow works
- [ ] Focus sprint runs

After Full Build (Phase 6):
- [ ] All 8 tabs functional
- [ ] PC Agent executes jobs
- [ ] Rollback tested
- [ ] 80% test coverage