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.
This commit is contained in:
James 2026-04-09 01:25:08 -04:00
parent cd1644128f
commit d3200fb2bf
1 changed files with 33 additions and 5 deletions

View File

@ -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)