# tyapkin


- **Руководство**
- Начать с Тяпкина
  - [Сначала правила. Затем действия.](/docs/guide): Тяпкин помогает описать поведение продукта понятными сценариями и проверить, что каждое решение следует этим правилам.
  - [Варианты использования](/docs/guide/use-cases): От разработки по сценариям до приложений и агентов — выберите задачу, в которой важны правила и объяснимые решения.
  - [Как это работает](/docs/guide/how-it-works): Понятный цикл — от входного события до решения, результата и проверяемой истории.
  - [Быстрый старт](/docs/guide/quickstart): Проверьте готовый сценарий локально, затем измените правило и посмотрите, что проверяет компилятор.

- **Foundation**
- Foundation
  - [Foundation](/docs/foundation): Русская карта CAP + Capkin foundation.

- **Архитектура**
- Архитектура
  - [Flow](/docs/architecture/flow): Current CAP + Capkin vertical slice.
  - [Малое ядро и расширения](/docs/architecture/small-core-extensions): Как собрать Tyapkin из обязательной CAP Machine и опциональных возможностей.
  - [Capkin State Machine Principle](/docs/architecture/capkin-state-machine-principle): Why Capkin is a controlled state-machine notation.
  - [Core State](/docs/architecture/core-state): CAP runtime state-machine core after the breaking rewrite.
  - [Expedition](/docs/architecture/expedition): Tyapkin как Kiskin Expedition-контур без наследования office runtime.
  - [Kiskin Scope Code](/docs/architecture/kiskin-scope-code): Naming and boundary rules for Tyapkin inside the Kiskin Expedition lifecycle.
  - [Graphifying Style](/docs/architecture/graphifying): How Tyapkin builds its Expedition graph projection.
  - [Solana Local Anchor](/docs/architecture/solana-local-anchor): Local proof adapter for CAP trace commitments.
  - [Fumadocs как база знаний](/docs/architecture/fumadocs): Как Fumadocs помогает держать общую память для людей и LLM.
  - [Workspace](/docs/architecture/workspace): Polyglot monorepo strategy for CAP + Capkin.
  - [UI и Tailwind](/docs/architecture/ui): Интерфейс документации Tyapkin и граница UI-исходников.
  - [Tyapkin и Allium](/docs/architecture/tyapkin-allium-boundary): Где заканчивается CAP + Capkin и начинается платформа для сборки приложений из слоёв.
  - [Allium / ProCoffee: состояние](/docs/architecture/allium-procoffee-status): Датированный срез реестров, тестов и покрытия приложения Allium на Tyapkin.

- **Capkin**
- Capkin
  - [Capkin Language](/docs/capkin/language): Gherkin-compatible protocol DSL for typed CAP state-machine contracts.
  - [Feature и Machine](/docs/capkin/feature-ownership): Как несколько проверенных Feature составляют CAP Machine без смены её State и Trace authority.
  - [Библиотека одной Machine](/docs/capkin/machine-library): Минимальный Rust путь Capkin compile → CAP decide → verify_trace.
  - [Capkin Compiler](/docs/capkin/compiler): Pipeline Gherkin/Capkin source -> CAP IR -> protobuf contract -> runtime trace.
  - [Compatibility And Backends](/docs/capkin/compatibility): How Capkin stays valid Gherkin while generating adapters for other executable spec frameworks.
  - [Federation, imports и Flow](/docs/capkin/federation): Проектная граница Capkin types, contract imports, федеративных полей, CEL и причинного Flow.

- **Runtime**
- Runtime
  - [Rust Core](/docs/runtime/rust-core): Deterministic CAP state-machine runtime.
  - [Переносимая граница CAP](/docs/runtime/protocol-boundary): Канонический Machine IR, чистые decide/verify и границы доверия.
  - [CAP kernel: evidence и эффекты](/docs/runtime/kernel-vnext): Исполняемый opt-in срез составных Guards, нескольких Output и локального outbox; границы до полного Capkin kernel.

- **Demo**
- Demo
  - [DEX + Compliance Demo](/docs/demo/dex-compliance): First end-to-end CAP + Capkin vertical slice.
  - [Complex Compliance Demo](/docs/demo/complex-compliance): Planned multi-level Capkin scenario for DEX risk, network policy and badlist guards.
  - [Kiskin Expedition Onboarding](/docs/demo/kiskin-expedition-onboarding): Первый перенос Kiskin Office onboarding board в CAP + Capkin.

- **Локальная разработка**
- Runbooks
  - [Локальный запуск документации](/docs/runbooks/local-docs): Как поднять Fumadocs локально в tyapkin.
  - [Локальный стек](/docs/runbooks/local-stack): Как запустить CAP runtime и локальный Solana RPC stub.
  - [Docker Local](/docs/runbooks/docker-local): Local CAP runtime, Solana-compatible stub and DEX compliance demo.
  - [Co-founder Demo](/docs/runbooks/cofounder-demo): Short walkthrough for the CAP + Capkin DEX compliance demo.
  - [Capkin Integration Scenario](/docs/runbooks/capkin-integration-scenario): How services integrate through CAP + Capkin.
  - [Rust Core Runbook](/docs/runbooks/rust-core): Running the local CAP runtime.
  - [Solana Local Anchor Runbook](/docs/runbooks/solana-local-anchor): Anchoring a local CAP trace range.
  - [Load Testing](/docs/runbooks/load-testing): k6 checks for CAP trace runtime.
  - [Quality Gates](/docs/runbooks/quality-gates): Required checks for CAP + Capkin changes.
  - [Scenario Registry](/docs/runbooks/test-registry): Registry-driven behavior checks.
  - [Tyapkin consumer bundle](/docs/runbooks/tyapkin-consumer-bundle): Независимая установка, точный pin и граница локальной приёмки Allium.
  - [Проверенный экспорт в TechDocs](/docs/runbooks/tyapkin-techdocs-export): Где лежит контракт, что генерирует Tyapkin и что добавляет Allium.
  - [Регистрация в Kiskin Office](/docs/runbooks/kiskin-registry-registration): Подтверждённая регистрация Тяпкина в Program Registry и границы lifecycle.
- Knowledge
  - [Знания Тяпкина](/docs/knowledge): Published from knowledge/index.md
  - [Клиентское руководство из общего Markdown](/docs/knowledge/client-documentation): Published from knowledge/client-documentation.md
  - [Разделённые графы](/docs/knowledge/graph): Published from knowledge/Graph.md
  - Platform
    - [Принятый Registry scope Tyapkin](/docs/knowledge/platform/registry-api-admission): Published from knowledge/platform/registry-api-admission.md
  - [С чего начать](/docs/knowledge/start-here): Published from knowledge/Start Here.md

- **LLM**
- LLM
  - [LLM Context](/docs/llm): How agents should read this repository.

- **Протокол**
- Протокол
  - [Commitments](/docs/contracts/commitments): Deterministic trace commitments in CAP.
  - [Protobuf Contracts](/docs/contracts/protobuf): Compiled CAP/Capkin wire contracts.
  - [Proto Reference](/docs/contracts/proto-events): Current protobuf files for CAP + Capkin.

- **Quality**
- Quality
  - [Test Registry](/docs/quality/test-registry): Scenario registry for CAP + Capkin behavior.
- Требования
  - [Agent Requirements](/docs/skills/agent-requirements): Working rules for agents in the CAP + Capkin repo.