# Quick Start Guide

Quick reference for common tasks and documentation navigation.

P26-01-20

## For AI Agents

### Essential Documents

1. **[Cursor Playbook](ai/cursor-playbook.md)** - Complete workflow guide
2. **[Rule Hierarchy](ai/rule-hierarchy.md)** - Understand which rules apply
3. **[Page Type Guides](guides/PAGE_TYPE_GUIDES.md)** - Quick reference for page types
4. **[Validation Workflows](ai/validation-workflows.md)** - Validation procedures

### Common Tasks

**Creating a comparison page:**

- Guide: [Comparison Pages Guide](guides/comparison-pages/COMPARISON_PAGES_GUIDE.md)
- Rule: `.cursor/rules/comparison-pages-core.mdc`

**Working on ShiftOps:**

- Documentation: [ShiftOps Documentation](systems/shiftops/)
- Rules: `.cursor/rules/shiftops-backend.mdc`, `.cursor/rules/shiftops-frontend-core.mdc`

**Creating a tools page:**

- Guide: [Tools Pages Documentation](guides/tools-pages/)
- Rule: `.cursor/rules/tools-pages-core-design.mdc`

**Updating product pages:**

- Guide: [Page Type Guides](guides/PAGE_TYPE_GUIDES.md)
- Rule: `.cursor/rules/product-pages.mdc`

## For Developers

### Getting Started

1. **[Setup Guides](development/setup/)** - Environment setup
2. **[JavaScript Logging Best Practices](development/JAVASCRIPT_LOGGING_BEST_PRACTICES.md)** - Console logging guidelines
3. **[Testing Documentation](development/testing/)** - Testing guides

### Common Tasks

**Setting up development environment:**
→ [Setup Documentation](development/setup/)

**Writing tests:**
→ [Testing Documentation](development/testing/)

**Debugging issues:**
→ [Troubleshooting Guides](development/troubleshooting/)

**API development:**
→ [API Reference](reference/api/)

## Documentation Map

```
docs/
├── QUICK_START.md          ← You are here
├── README.md               ← Main documentation index
│
├── guides/                 ← User-facing guides
│   ├── comparison-pages/
│   ├── tools-pages/
│   └── guides/PAGE_TYPE_GUIDES.md
│
├── systems/                ← System documentation
│   ├── systems/shiftops/
│   ├── systems/lead-capture/
│   └── product-updates/
│
├── reference/              ← Technical reference
│   ├── api/
│   └── architecture/
│
├── development/            ← Developer docs
│   ├── development/setup/
│   ├── development/testing/
│   └── troubleshooting/
│
└── ai/                     ← AI agent docs
    ├── ai/cursor-playbook.md
    └── ai/rule-hierarchy.md
```

## Decision Tree

**What are you trying to do?**

- **Create a page?** → [Page Type Guides](guides//PAGE_TYPE_GUIDES.md)
- **Work on ShiftOps?** → [ShiftOps Documentation](systems//shiftops/)
- **Set up development?** → [Setup Guides](development//setup/)
- **Understand Cursor rules?** → [Rule Hierarchy](ai//rule-hierarchy.md)
- **Find API docs?** → [API Reference](reference/api/)
- **Debug an issue?** → [Troubleshooting](development/troubleshooting/)

## Key Rules Reference

| Task Type         | Rule File                     | Documentation                                                               |
| ----------------- | ----------------------------- | --------------------------------------------------------------------------- |
| Comparison pages  | `comparison-pages-core.mdc`   | [Comparison Pages Guide](guides/comparison-pages/COMPARISON_PAGES_GUIDE.md) |
| Product pages     | `product-pages.mdc`           | [Page Type Guides](guides//PAGE_TYPE_GUIDES.md)                             |
| Tools pages       | `tools-pages-core-design.mdc` | [Tools Pages](guides/tools-pages/)                                          |
| ShiftOps backend  | `shiftops-backend.mdc`        | [ShiftOps Documentation](systems//shiftops/)                                |
| ShiftOps frontend | `shiftops-frontend-core.mdc`  | [ShiftOps Documentation](systems//shiftops/)                                |
| Base components   | `base-components.mdc`         | [Page Type Guides](guides//PAGE_TYPE_GUIDES.md)                             |
| API endpoints     | `api-endpoints-core.mdc`      | [API Reference](reference/api/)                                             |

## Need Help?

- **Can't find what you're looking for?** → Check [README.md](README.md) for complete index
- **Working with AI agents?** → See [AI Agent Documentation](ai/)
- **Contributing documentation?** → See [CONTRIBUTING.md](CONTRIBUTING.md)