3.8 KiB
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/ |
исходные архитектурные исследования |
Как пользоваться содержимым
flowchart LR
TASK["Задача"] --> CONTRACT["ops/contract.yaml"]
CONTRACT --> KDB["kdb/kdb.yaml"]
KDB --> TOPIC["Тема по exact intent"]
TOPIC --> SECTIONS["Только нужные документы и разделы"]
SECTIONS --> RESULT["Решение или proposed change"]
Для понимания модели начните с руководства. Для реализации форматов используйте спецификацию. Для подключения существующего репозитория следуйте adoption runbook.
Почему структура минимальна
Репозиторий применяет собственную концепцию без декоративной унификации:
- действующие документы собраны в одном content root
docs/, а исходное исследование отделено вdocs/research/; - не созданы пустые
templates/,schemas/,src/илиops/handlers/; - не объявлены исполняемые operations, поскольку handlers ещё отсутствуют;
- template lineage не записан, потому что этот repository не был создан из готового versioned template;
- будущий код добавит собственный content root тогда, когда он действительно появится.
Ближайший практический этап
- Зафиксировать schemas и fixtures четырёх типов репозиториев.
- Реализовать read-only
validate,discover,describeиcontext. - Выполнить plan-only adoption для
Infra/LXDиServices/Antivirus. - После пилотов реализовать
init,adoptи тонкий Claude skill.