---
description: "Roadcrew Project Context - Quick Reference"
globs: ["**/*"]
alwaysApply: true
---

# Roadcrew Project Context

**What:** Spec-driven development system for building software products at scale.

**Current Phase:** Post-Launch Optimization (EPIC-1171)  
**Active Release:** v1.6.0  
**Tech Stack:** TypeScript/Node.js, npm, Nx, Jest

---

## Key Repositories

**Internal (Development):** `tailwind-ai/roadcrew-internal` (this repo)
- Source of truth for all development
- Publishing from: `dist/scripts/` → public repo

**Customer-Facing:** `tailwind-ai/roadcrew`
- What customers install via git submodule
- Customer path: `.roadcrew/`

**Publishing:** See `08-publishing.mdc` for dual-approach details

---

## Deployment Modes

Roadcrew supports three modes - see `09-mode-routing.mdc` for decision tree:

1. **Submodule** (Primary) - `.roadcrew/` directory exists
2. **Multi-Repo** (Enterprise) - `config/repos.yml` exists
3. **Standalone** (Legacy) - Commands at repo root

---

## Core Workflows

**8-stage spec-driven workflow:**
ANALYSIS → PLANNING → RELEASE → IMPLEMENTATION → CODE ANALYSIS → TESTING → PUBLISHING → VALIDATION

**Commands:** `.cursor/commands/01-analysis/` through `08-validation/`  
**Details:** See `07-project-patterns.mdc`

---

## Critical Requirements

**TDD is mandatory** - See `06-testing.mdc`  
**Release-to-Spec linking** - See `07-project-patterns.mdc`  
**GitHub hierarchy** - See `07-project-patterns.mdc`  
**No hardcoded values** - See `07-project-patterns.mdc`

---

## Documentation Structure

**For detailed context, read in order:**
1. `memory-bank/projectbrief.md` - Scope and requirements
2. `memory-bank/productContext.md` - Why Roadcrew exists
3. `memory-bank/systemPatterns.md` - Architecture and decisions
4. `memory-bank/techContext.md` - Tech stack details
5. `memory-bank/activeContext.md` - Current work focus
6. `memory-bank/progress.md` - Status and milestones

**Additional context:**
- `context/specs/` - Technical specifications
- `context/epics/` - Epic definitions
- `releases/` - Release tracking

---

## Quick Links

- **Patterns:** `07-project-patterns.mdc`
- **Publishing:** `08-publishing.mdc`
- **Mode routing:** `09-mode-routing.mdc`
- **GitHub API:** `03-github.mdc`
- **Testing:** `06-testing.mdc`

---

## Related Documentation

- **Commands:** `.cursor/commands/01-analysis/` through `.cursor/commands/08-validation/`
- **Templates:** `templates/roadcrew/` — Customer-facing templates
- **Memory Bank:** `memory-bank/` — Project documentation
- **GitHub Issues:** Repository tracking via `issues/`