From d3200fb2bfddb270c7a8e8c64e6c688b61754d89 Mon Sep 17 00:00:00 2001
From: James <james@jongsma.me>
Date: Thu, 9 Apr 2026 01:25:08 -0400
Subject: [PATCH] Fix QUICKSTART.md with foundation approach - tea CLI just
 works

Added one-time setup:
- Export GITEA_TOKEN
- tea login add

This is THE foundation for agent workflow. Without this, agents can't:
- Query their tasks programmatically
- Create PRs
- Participate in the Git workflow

Updated workflow section:
- Use tea CLI for task list and PR creation
- No scripts needed
- No asking permission
- Commit with 'Fixes #N', push, create PR, wait for review

Added building section:
- Standard vs commercial (-tags commercial)
- Test before committing

Now Hans can:
1. tea issues list --assignees hans (see tasks)
2. Fix code
3. tea pulls create (submit for review)

Foundation: tea CLI works.
---
 QUICKSTART.md | 38 +++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

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)