opusmanSEEKv4/COLDSTART_GUIDE.md

# NEXUS OS v3.1 — Cold Start Guide

**Goal:** Get any new agent or developer fully operational in under 5 minutes with zero context loss.

## Step 1: Environment Setup

```bash
# Linux / macOS
cd NEXUS
source venv/bin/activate

# Windows
cd NEXUS
.\venv\Scripts\Activate.ps1
```

## Step 2: Install & Verify

```bash
pip install -e . httpx -q
python scripts/diagnostic.py
python -m pytest tests/ -q --tb=short
```

Expected result: **635+ tests passed** and **ALL CHECKS PASSED**.

## Step 3: Start the Governance API

```bash
uvicorn nexus_os.api.server:app --host 0.0.0.0 --port 7352
```

## Step 4: Read Context (Mandatory)

Every agent **must** read these files in order before doing any work:

1. `COLDSTART_BOOT.txt`
2. `AGENTS.md`
3. `tasks/coordination_prompt.md`
4. Their personal `AGENT.md` (from `docs/agents/`)

## Step 5: Daily Workflow

1. Activate environment
2. Run `python scripts/diagnostic.py`
3. Check `tasks/pending/` for assigned work
4. Claim task using `task_queue.py`
5. Work → Test → Commit (explicit paths only)
6. Update task progress

**Never** create new tasks or missions independently.