docs: baseline specification-only repository stewardship
This commit is contained in:
@@ -0,0 +1,50 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user