Redefine contract: two-way Claude companion (MCP + handoff + forge writes)

AGENT.md now makes the Claude integration the defining pillar: law 1.7 (one service layer behind GUI + MCP), MCP server over Streamable HTTP at /mcp, SSE app->browser, Gitea-first read+write forge, right-click command vocabulary, and rewritten section 8 (MCP server, activity feed, graceful project handoff, merge & clean up). No code yet.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

CHANGELOG.md

@@ -32,3 +32,23 @@ Append-only running history of all changes (AGENT.md §9.1). Newest last.
   canonical import path (e.g. a GitHub URL).
 - All items in AGENT.md §11 (discovery strategy, background fetch, forge
   providers, listen address, container credentials) remain open.
+
+## 2026-09-19 — Redefine the app as a two-way Claude companion (contract only)
+- **What:** Updated AGENT.md to make the Claude integration the defining pillar,
+  no code yet. §0 now states the two-way purpose (Claude↔app) and the
+  non-expert, GUI-first goal; added law §1.7 (one service layer behind both the
+  GUI and the MCP server); stack table gained MCP server (Go SDK over Streamable
+  HTTP at `/mcp`), SSE (app→browser), and flipped forge to Gitea-first read+write;
+  layout added `internal/{service,mcp,activity}`; §6 added the right-click
+  plain-language command vocabulary; **§8 rewritten** into "Claude integration"
+  (8.1 MCP server, 8.2 activity feed + active project, 8.3 graceful project
+  handoff, 8.4 forge read+write with "Merge & clean up"); §10 step 4 and §11
+  updated (three decisions resolved, new open items). `.env.example` now documents
+  `GITEA_TOKEN` (read+write scope).
+- **Why:** Thomas described the real vision — the app should act as an extension
+  of Claude: usable like an MCP by Claude, notifying Claude of in-app actions to
+  stay in sync, cooperative project handoff when he's interrupted, plain-language
+  right-click commands for non-experts, and one-click "merge & clean up" so PRs
+  stop cluttering repos. Decisions locked: cooperative pull-first handoff; Gitea
+  writes enabled (confirmed per §1.4); MCP over HTTP `/mcp`.
+- **Affects:** `AGENT.md`, `.env.example` (architecture/contract only — no code).