docs: add human-facing repoctl guide in Russian, route it via KDB

docs/repoctl.md walks a human through what repoctl is, the install-once
/ invoke-from-other-repositories model (folding in the framing already
present on the sibling codex/repoctl-l1 branch's docs/repoctl.md), each
command with real sample output, the exit-code table, and troubleshooting.
docs/specification.md stays the normative machine reference.

kdb/kdb.yaml routes the new document into the tooling-implementation
topic; README.md links it and documents running tests-universal.
This commit is contained in:
Alexander Baranov
2026-08-24 15:42:48 +03:00
parent 86dd79c8ae
commit 4fbe56d81f
4 changed files with 166 additions and 3 deletions
+5 -2
View File
@@ -21,10 +21,12 @@ approval для любых записей. `ops/handlers/`, execution runner и
| `docs/specification.md` | нормативная спецификация |
| `docs/guide.md` | объяснение модели для человека |
| `docs/adoption-runbook.md` | перевод существующих репозиториев на стандарт |
| `docs/repoctl.md` | руководство по `repoctl` для человека: установка, команды, коды возврата |
| `docs/research/` | исходные архитектурные исследования |
| `src/stewardship/` | реализация `repoctl` (модели, schemas, CLI) |
| `src/stewardship/schemas/` | JSON Schemas (Draft 2020-12) для всех kinds |
| `tests/` | fixtures и pytest-набор (позитивные, негативные, adoption) |
| `tests/` | unit pytest-набор (позитивные, негативные, adoption fixtures) |
| `tests-universal/` | spec-driven CLI-контрактный набор, независимый от реализации |
| `.claude/skills/` | три тонких Claude skill-адаптера над `repoctl` |
### Установка и запуск
@@ -33,9 +35,10 @@ approval для любых записей. `ops/handlers/`, execution runner и
uv sync
uv run repoctl validate --repo .
uv run pytest
uv run pytest tests-universal
```
`uv sync` создаёт `.venv` в корне репозитория; все команды выполняются через `uv run`.
`uv sync` создаёт `.venv` в корне репозитория; все команды выполняются через `uv run`. `tests-universal` — отдельный набор: он вызывает `repoctl` только как внешний процесс и сверяется исключительно с `docs/specification.md`, поэтому им можно проверить любую совместимую реализацию, а не только эту. Практическое руководство по самому CLI — в [docs/repoctl.md](docs/repoctl.md).
## Как пользоваться содержимым