diff --git a/docs/what-is-fold.md b/docs/what-is-fold.md new file mode 100644 index 0000000..7c0e514 --- /dev/null +++ b/docs/what-is-fold.md @@ -0,0 +1,30 @@ +# What is Fold? + +**Fold** — agent governance runtime. MCP-сервер (stdio adapter, slot-in для Claude Desktop / Cursor / Zed) перед runtime-сервисом, который sibling к реальному backend'у — не middleware и не proxy. + +## Решает 4 задокументированные боли AI-агентов + +1. **Destructive actions без permission scope** (PocketOS, Replit incidents) → `role.base` + `role.scope` filtering +2. **Generic 500 без machine-readable reason** (90.8% retry waste) → structured rejections с invariant-violation reasons +3. **Over-broad capability tokens** (Supabase service_role, GitHub MCP over-broad PAT scope) → preapproval guards с предикатами вроде `maxAmount` (cap на сумму), `dailySum` (rate-limit) или `csvInclude` (whitelist по списку) +4. **Нет point of no return** (Railway blog) → `__irr.point` irreversibility primitive: past confirmed effect с `point: high` блокирует `α:remove` на той же сущности; forward-correction через `α:replace` остаётся возможной + +## Что входит в Fold + +| Часть | Репо | npm | +|---|---|---| +| MCP server | `idf-mcp/` | `@intent-driven/mcp-server` | +| Standalone runtime | `idf-sdk/packages/runtime-local/` | `@intent-driven/runtime-local` | +| CLI (`idf serve`, `idf approvals`, `idf approve`) | `idf-sdk/packages/cli/` | `@intent-driven/cli` | +| Docker quickstart | `fold-runtime-quickstart/` | — | +| Landing | `fold-landing/` | fold.intent-design.tech | + +## Что не Fold + +- **Не Studio** — Fold не делает UI, не имеет multi-tenant control plane. Studio — отдельный продукт (см. host-репо `idf/`, файл `docs/products.md` после Phase 0 merge). +- **Не сам формат IDF** — Fold потребляет IDF-онтологию, но спецификация формата живёт в `idf-spec/`. +- **Не middleware** — Fold sibling к backend'у через MCP, не proxy перед API. + +## Time to first `approve_pending` + +Цель: ≤ 15 минут от `npm install` до первого `approve_pending` в Claude Desktop на NestJS+TypeORM+PG проекте. Quickstart-доc — `~/WebstormProjects/fold-runtime-quickstart/README.md`.