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:
@@ -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).
|
||||
|
||||
## Как пользоваться содержимым
|
||||
|
||||
|
||||
Reference in New Issue
Block a user