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

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

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

Step 2: Install & Verify

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

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.