arcodange/telegram-gateway
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request 'docs: AGENTS.md — fleet role + backlog pointers for agents' (#3) from arcodange/agents-md-fleet-pointer into main
CI/CD / test (push) Successful in 24s
Details
CI/CD / build-and-push-image (push) Successful in 1m42s
Details

Browse Source
This commit was merged in pull request #3.
This commit is contained in:
arcodange
2026-07-11 20:21:25 +02:00
parent abe77f5873 97b7adb413
commit fe78c14bcc
1 changed files with 22 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+22
View File
@@ -0,0 +1,22 @@
# telegram-gateway — agent guide
Telegram **webhook gateway** for the Arcodange lab (k3s, `tg.arcodange.fr` via Cloudflared). Full architecture, routes, local dev: [README.md](README.md). Phase 1 (sync `echo` handler) is live; phases 2–3 (durable queue, async handlers) are the roadmap.
## Fleet role — why this repo matters now
This gateway is the **human channel of the AI back-office fleet** (operator-endorsed, 2026-07): digests and approval cards are served from the cluster so approvals never wait for a laptop, and its planned Postgres queue is the fleet's work queue (decision D1). Context: the [AI back-office PRD](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/README.md) — notably [agent-architecture](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/agent-architecture.md) (human channel, runtimes).
## The backlog
Work items live as **self-contained issues** (context, deliverables, acceptance):
- [#1 — Postgres durable queue + http handler](https://gitea.arcodange.lab/arcodange/telegram-gateway/issues/1) (phase 2, fleet work queue)
- [#2 — fleet daily digest + approval cards](https://gitea.arcodange.lab/arcodange/telegram-gateway/issues/2) (depends on #1)
The wider backlog map (erp milestones, factory ADRs): the PRD [STATUS.md](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/STATUS.md). ⚠️ This repo's owner is `arcodange` (user org), not `arcodange-org` — Gitea MCP calls need the right owner.
## Operating rules
- Work on a branch, PR via the `mcp__gitea__*` tools (this forge is Gitea; `gh` fails).
- Secrets via env (`AUTH_SECRET`, bot tokens from @BotFather) — never committed; `bots.example.yaml` is the template.
- A missing daily digest must be treated as an alarm by fleet consumers — keep the digest path dumb and reliable (an empty day still sends "all green").