51 lines
3.8 KiB
Markdown
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.
|