git:20260724.cb0170c to git:20260813.364913f

3 added, 3 removed. Audit A to A.

# Platforms Guide

- Chat integrations implementing `protocol.Driver`, `Adapter`, and `Action`. Reference: `internal/platforms/slack/`.

+ Chat integrations implementing `protocol.Driver`, `Adapter`, and `Action`. Reference: `internal/platforms/slack/`. Repo-wide standing orders: root [AGENTS.md](../../AGENTS.md).

## Entry points

- Core: `caller.go`, `convert.go`, `registry.go` (`PlatformRegister`, `GetCaller`, `MessageConvert`)

- Wired today: `slack/` (`fx.Provide`), `tailchat/` (controller construction + router)

- Not wired: `discord/` (package + config exist; no server fx / platform callback)

Per platform: `driver.go`, `adapter.go`, `action.go`, `types.go` (`const ID`).

## Boundaries

- - Never import `pkg/providers/*`

+ - Same provider-client split as modules (root [AGENTS.md](../../AGENTS.md)); this tree is not a module.

- Platform-native conversion stays in the adapter; routing in `action.go`, not `server/`

- Errors: `protocol.NewFailedResponse` / `NewSuccessResponse`

- Wire each enabled platform in `internal/server/fx.go` (or controller) and `router.go` as needed

- Lifecycle: `handlePlatform` starts `WebSocketClient` on fx Lifecycle

## Testing

- Table-driven unit tests; mock SDKs or `httptest`.

+ Package tests: table-driven unit tests; mock SDKs or `httptest`. Product HTTP / event behavior: owning BDD spec ([docs/testing/README.md](../../docs/testing/README.md)).