Files
repoctl/README.md
T

51 lines
3.8 KiB
Markdown

# Repository Stewardship
Этот репозиторий разрабатывает стандарт и будущий инструментарий для единообразной работы с Git-репозиториями при помощи людей и любых AI-агентов.
Основная идея: каждый репозиторий сам сообщает, что он содержит, где лежит его реальный результат, какие знания нужны для конкретной задачи и какие действия допустимы. Claude является основным агентом, но модель не зависит от Claude, LLM, skill format или MCP.
## Текущее состояние
Сейчас здесь находятся спецификация, руководство и adoption runbook. CLI `repoctl`, handlers и MCP server ещё не реализованы; команды в документации определяют целевой интерфейс.
| Точка входа | Назначение |
|---|---|
| `ops/contract.yaml` | машиночитаемый паспорт этого репозитория |
| `kdb/kdb.yaml` | маршрутизация знаний по intent |
| `CLAUDE.md` | основная точка входа Claude |
| `AGENTS.md` | переносимые инструкции для агентов |
| `docs/specification.md` | нормативная спецификация |
| `docs/guide.md` | объяснение модели для человека |
| `docs/adoption-runbook.md` | перевод существующих репозиториев на стандарт |
| `docs/research/` | исходные архитектурные исследования |
## Как пользоваться содержимым
```mermaid
flowchart LR
TASK["Задача"] --> CONTRACT["ops/contract.yaml"]
CONTRACT --> KDB["kdb/kdb.yaml"]
KDB --> TOPIC["Тема по exact intent"]
TOPIC --> SECTIONS["Только нужные документы и разделы"]
SECTIONS --> RESULT["Решение или proposed change"]
```
Для понимания модели начните с [руководства](docs/guide.md). Для реализации форматов используйте [спецификацию](docs/specification.md). Для подключения существующего репозитория следуйте [adoption runbook](docs/adoption-runbook.md).
## Почему структура минимальна
Репозиторий применяет собственную концепцию без декоративной унификации:
- действующие документы собраны в одном content root `docs/`, а исходное исследование отделено в `docs/research/`;
- не созданы пустые `templates/`, `schemas/`, `src/` или `ops/handlers/`;
- не объявлены исполняемые operations, поскольку handlers ещё отсутствуют;
- template lineage не записан, потому что этот repository не был создан из готового versioned template;
- будущий код добавит собственный content root тогда, когда он действительно появится.
## Ближайший практический этап
1. Зафиксировать schemas и fixtures четырёх типов репозиториев.
2. Реализовать read-only `validate`, `discover`, `describe` и `context`.
3. Выполнить plan-only adoption для `Infra/LXD` и `Services/Antivirus`.
4. После пилотов реализовать `init`, `adopt` и тонкий Claude skill.