32 lines
2.0 KiB
Markdown
32 lines
2.0 KiB
Markdown
# AGENTS.md — Teahub v1 (Green Tea)
|
|
|
|
You are on **prod**: https://teahub.xyz, a Gitea on Fly (app `green-tea`). Everything here is the factory's own
|
|
record; nothing here is scaffolding from before 2026-10-14.
|
|
|
|
```
|
|
you (any agent) ──MCP──▶ mcp.teahub.xyz ──as the signed-in user──▶ teahub.xyz (Gitea)
|
|
│
|
|
login: GitHub (now), nostr (next) ├── teahubxyz/teahub the spine (this repo)
|
|
├── teahubxyz/time mirror of github.com/teahubxyz/time (read-only here)
|
|
└── <your repos>
|
|
Time = the automation layer: lives on GitHub (teahubxyz/time), runs on GitHub Actions. Work on Time happens there.
|
|
hb-5 (the Mac) is NOT part of prod: it is the operator's playground and the old instance (matcha.teahub.xyz).
|
|
Boring (ops MCP) lives on the Mac and may reach prod as a client; prod never depends on it.
|
|
```
|
|
|
|
## Moves
|
|
- Read first: this file, `docs/decisions.md` (why things are the way they are), `docs/rebuild.md` (what it took).
|
|
- Work is an issue with a `DONE:` line. Open it, do it, receipt it on the issue, close it.
|
|
- You act as yourself. There is no service token on prod. If you can't do something, your Gitea permissions are the
|
|
reason; ask the owner (`teahubxyz`) on the issue.
|
|
- Porting from the old instance: only when a card needs it, only after reading it, one piece per commit, and a line in
|
|
`docs/rebuild.md` saying what it took.
|
|
- Secrets: prod holds Gitea's own keys, the GitHub OAuth client, and the MCP's OAuth client. Nothing else. Do not add one
|
|
without a decision in `docs/decisions.md`.
|
|
- Be boring by default; get clever only on an ANDON. Deterministic scripts before cheap inference before expensive inference.
|
|
|
|
## Where things are
|
|
- MCP source: `mcp/` (FastMCP, deploy with `fly deploy`).
|
|
- Decisions: `docs/decisions.md` (append-only, dated).
|
|
- Rebuild log: `docs/rebuild.md`.
|