diff --git a/QUICKSTART.md b/QUICKSTART.md
index 28a9b63..dcccb02 100644
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -8,12 +8,24 @@
 
 ## Who You Are
 
-**Hans** — NOC / Operations agent. Infrastructure, monitoring, POP health, alerts.
+**Hans** — NOC/Operations agent. Infrastructure, monitoring, POP health, alerts.
 
 Your domain: `operations/*`, `monitoring/*`, `noc/*`, `clavis-telemetry/*`
 
 ---
 
+## One-Time Setup (First Session Only)
+
+```bash
+# 1. Login to Gitea (our Git server)
+export GITEA_TOKEN="775a12730a65cbaf1673da048b7d01859b8b58e0"
+tea login add --name clavitor --url https://git.clavitor.ai --token $GITEA_TOKEN
+
+# Verify: tea issues list --repo johan/clavitor --assignees hans
+```
+
+---
+
 ## Session Start (30 seconds)
 
 1. **Run daily checks:** `./scripts/daily-review.sh`
@@ -35,13 +47,14 @@ Your domain: `operations/*`, `monitoring/*`, `noc/*`, `clavis-telemetry/*`
 ## The Workflow (60 seconds)
 
 ```
-1. Pick up issue from git.clavitor.ai (assigned to you)
+1. Pick up issue: tea issues list --assignees hans
 2. Create branch: git checkout -b hans/fix-###
 3. Implement per issue spec
 4. Run: ./scripts/daily-review.sh (must pass)
-5. Commit with "Fixes ####"
-6. Push, create PR, wait for Yurii/Victoria/Arthur review
-7. DO NOT merge your own PR
+5. Commit: git commit -m "telemetry: fix silent DB error. Fixes #2"
+6. Push: git push -u origin hans/fix-###
+7. Create PR: tea pulls create --title "Hans: Fix silent DB error" --description "Fixes #2"
+8. Wait for Yurii/Victoria/Arthur review. DO NOT merge your own PR.
 ```
 
 ---
@@ -57,6 +70,21 @@ Your domain: `operations/*`, `monitoring/*`, `noc/*`, `clavis-telemetry/*`
 
 ---
 
+## Building (When Needed)
+
+```bash
+# Standard build
+go build .
+
+# Commercial edition (telemetry, multi-POP)
+go build -tags commercial .
+
+# Test before committing
+go test ./...
+```
+
+---
+
 ## When Stuck
 
 1. Check [handbook Section V → your domain](CLAVITOR-AGENT-HANDBOOK.md)