Files
repoctl/ops/contract.yaml
T
Alexander BaranovandClaude Opus 5 d7a506a5d9 chore(contract): classify this repository as software
It was declared `project` when it held only a specification. It now ships
a Python package and a CLI, and its own classifier says so with high
confidence on pyproject.toml and src/. Self-hosting is worth little if the
contract disagrees with what the tool would conclude about the repository.

This also names a gap: a repository crossing from project or research into
software or service is normal, and the model has no operation for it. The
type is a birth attribute, and changing it by hand leaves template.id and
the type's default content roots pointing at the old answer with nothing
to object.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 18:11:25 +03:00

83 lines
2.4 KiB
YAML

apiVersion: stewardship.corsus.ru/v1alpha1
kind: RepositoryContract
metadata:
name: repository-stewardship
title: Repository Stewardship standards and templates
owners:
- alexander.baranov
labels:
domain: repository-management
role: standards-and-templates
annotations:
stewardship.corsus.ru/bootstrap-mode: self-hosted
stewardship.corsus.ru/implementation-status: l1-implemented
spec:
summary: Standards, templates and the repoctl L1 CLI for AI-assisted repository management
repository:
type: software
lifecycle: active
agent:
primary: CLAUDE.md
portable: AGENTS.md
knowledge:
entrypoint: kdb/kdb.yaml
contentRoots:
- id: canonical-documents
role: documentation
path: docs
kind: file-set
authority: source
writePolicy: managed
selector: "*.md"
format: text/markdown
- id: architecture-research
role: design-source
path: docs/research
kind: file-set
authority: source
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
summary: Versioned contract and knowledge model for managed repositories
- 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