# app Specs

> Canonical path: `specs/app/README.md`

This README lists the canonical App specs in recommended reading order. Product
terminology (Apps, provider ingress, `capabilities.runtime`, App Runtime API,
and transports) is authoritative in
[`specs/service/service-actor-platform.md`](../service/service-actor-platform.md).

- [App System Spec](./app-system.md)
- [App Runtime Spec](./app-runtime.md)
- [App Notification Spec](./app-notification.md)
- [Gitea App Spec](./gitea.md)
- [Pull Request Subscription App MCP](./provider-watch-agent-mcp.md)

Cross-domain service actor and event delivery contracts live under [`specs/service`](../service/README.md).