docs: self-host at L1 and ship the three Claude skill adapters

- Move ops/contract.yaml annotation from specification-only to l1-implemented and
  declare real content roots for repoctl source, schemas, tests and Claude adapters.
- Add repoctl-cli capability to provides[].
- Route repository.tooling.use and repository.handoff intents to the existing
  tooling-implementation KDB topic.
- Update README, AGENTS.md and CLAUDE.md to describe the implemented repoctl surface
  instead of a planned one, without claiming L2/L3/MCP capabilities that don't exist.
- Add .claude/skills/{repository-bootstrap,repository-adoption,repo-handoff}/SKILL.md,
  generated from the same stewardship.skills_content strings that ship inside every
  repoctl init bootstrap (no duplicated logic).

`repoctl validate --repo .` passes with zero findings after this change.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Alexander Baranov
2026-08-24 15:00:34 +03:00
co-authored by Claude Sonnet 5
parent 96d4d08230
commit 7286322c83
8 changed files with 141 additions and 12 deletions
+37 -2
View File
@@ -10,9 +10,9 @@ metadata:
role: standards-and-templates
annotations:
stewardship.corsus.ru/bootstrap-mode: self-hosted
stewardship.corsus.ru/implementation-status: specification-only
stewardship.corsus.ru/implementation-status: l1-implemented
spec:
summary: Standards, templates and adoption guidance for AI-assisted repository management
summary: Standards, templates and the repoctl L1 CLI for AI-assisted repository management
repository:
type: project
lifecycle: active
@@ -38,6 +38,38 @@ spec:
writePolicy: managed
selector: "**/*.md"
format: text/markdown
- id: repoctl-source
role: source
path: src/stewardship
kind: directory
authority: source
writePolicy: managed
selector: "**/*.py"
format: text/x-python
- id: repoctl-schemas-and-templates
role: schemas
path: src/stewardship/schemas
kind: directory
authority: source
writePolicy: managed
selector: "**/*.schema.json"
format: application/schema+json
- id: repoctl-tests
role: tests
path: tests
kind: directory
authority: source
writePolicy: managed
selector: "**/*.py"
format: text/x-python
- id: claude-adapters
role: agent-adapters
path: .claude/skills
kind: directory
authority: source
writePolicy: managed
selector: "**/SKILL.md"
format: text/markdown
provides:
- id: stewardship-model
capability: repository.stewardship-model
@@ -45,3 +77,6 @@ spec:
- id: adoption-procedure
capability: repository.adoption-procedure
summary: Safe overlay procedure for bringing existing repositories into the model
- id: repoctl-cli
capability: repository.tooling.repoctl
summary: repoctl L1 CLI implementing validate, discover, describe, context, init and adopt