# 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.