repo-canon
Repository documentation, contribution, agent workflow, and GitHub validation standards
- Última versión
- v0.27.0, 12 nov 2026
- Requiere
- CLI de Repo Standards ≥ 10.0.0
- Repositorio
- github.com/
lutzseverino/ repo-canon
Adopta repo-canon
Dale el prompt a tu agente en el repositorio que quieres configurar, o ejecuta tú el comando allí. En los dos casos eliges una versión y un perfil, y no se hace ningún commit hasta que revisas los cambios.
Cualquiera puede añadir aquí una fuente. Revísala antes de adoptarla.
Una configuración lista para empezar
Repo Canon es una configuración lista para empezar. Tu agente la instala en tu repositorio y la adapta a tu proyecto, y más adelante el mismo prompt la actualiza a una versión más reciente.
AGENTS.md
Un AGENTS.md que los agentes leen primero, con la documentación del proyecto para agentes al lado, en docs/agents/.
-
AGENTS.md -
docs/agents/README.md -
docs/agents/domain.md -
docs/agents/issue-tracker.md -
docs/agents/project.md -
docs/agents/triage-labels.md
Skills para agentes
Skills en .agents/skills/ para triaje, especificaciones y tickets, desarrollo guiado por pruebas, revisión de código y pull requests.
-
.agents/skills/babysit/ -
.agents/skills/code-review/ -
.agents/skills/codebase-design/ -
.agents/skills/create-adopted-repo/ -
.agents/skills/create-repository/ -
.agents/skills/diagnosing-bugs/ -
.agents/skills/domain-modeling/ -
.agents/skills/factory/ -
.agents/skills/grill-with-docs/ -
.agents/skills/grilling/ -
.agents/skills/implement/ -
.agents/skills/improve-codebase-architecture/ -
.agents/skills/orchestrate/ -
.agents/skills/pr/ -
.agents/skills/prototype/ -
.agents/skills/research/ -
.agents/skills/review/ -
.agents/skills/tdd/ -
.agents/skills/to-spec/ -
.agents/skills/to-tickets/ -
.agents/skills/triage/ -
.agents/skills/wayfinder/ -
.agents/skills/writing-for-agents/
Guía de contribución
Un CONTRIBUTING.md para las personas y los agentes que trabajan en el repositorio.
-
CONTRIBUTING.md
Plantillas de issues y PR
Formularios de issues de GitHub para informes de errores, solicitudes de funcionalidades, especificaciones y tickets de implementación, y una plantilla de pull request.
-
.github/ISSUE_TEMPLATE/bug-report.yml -
.github/ISSUE_TEMPLATE/feature-request.yml -
.github/ISSUE_TEMPLATE/implementation-ticket.yml -
.github/ISSUE_TEMPLATE/specification.yml -
.github/PULL_REQUEST_TEMPLATE.md
Comprobaciones
Comprobaciones de la navegación de la documentación, la estructura de los README y el archivo de revisores de pull requests, que se ejecutan al adoptar y con repo-standards check, y flujos de trabajo de GitHub Actions, entre ellos comprobaciones de los contratos de issues y de los metadatos de las pull requests.
-
.github/workflows/issue-contracts.yml -
.github/workflows/pr-metadata.yml -
.github/workflows/sandbox-image.yml -
.github/workflows/standards-update.yml -
documentation-navigation -
factory-model-policy -
factory-review-policy -
project-readme-structure -
pull-request-reviewer -
repository-readme-structure -
required-checks -
typescript-astro-stack-manifests -
typescript-node-stack-manifests -
typescript-vite-stack-manifests
Perfiles
- standard
- The Repo Canon standards for every adopting repository
- factory
- The standard profile plus the factory's repository files and workflow rules, for a repository a factory serves
- workbench
- Only the workflow skills, with the files they need to run and their license notices, for the orchestrating agent's workbench
Qué instala
Cada declaración de su standards.yaml en v0.27.0, con las rutas que instala o gestiona y las comprobaciones que ejecuta.
| Declaración | Instala o gestiona | Comprobaciones | Perfiles |
|---|---|---|---|
agent-configuration-index Archivo | docs/agents/README.md | standard, factory | |
agent-guidance Archivo | AGENTS.md | standard, factory | |
bug-report-template Archivo | .github/ISSUE_TEMPLATE/bug-report.yml | standard, factory | |
comments Pautas del repositorio | Rutas que encuentra en cada proyecto | standard, factory | |
contribution-guidance Archivo | CONTRIBUTING.md | standard, factory | |
documentation Pautas del repositorio | Rutas que encuentra en cada proyecto | documentation-navigation | standard, factory |
domain-configuration Archivo | docs/agents/domain.md | standard, factory | |
factory-configuration Archivo | .scriptorium/config.json | factory | |
factory-sandbox-image Pautas del repositorio | .scriptorium/Dockerfile.factory/Dockerfile.factory/config.json | factory | |
factory-sandbox-image-workflow Archivo | .github/workflows/sandbox-image.yml | factory | |
factory-workflow Pautas del repositorio | Rutas que encuentra en cada proyecto | factory-model-policy | factory |
feature-request-template Archivo | .github/ISSUE_TEMPLATE/feature-request.yml | standard, factory | |
git-attributes Archivo | .gitattributes | standard, factory | |
github-repository-configuration Pautas del repositorio | Rutas que encuentra en cada proyecto | required-checkspull-request-reviewerfactory-review-policy | standard, factory |
github-validator-trigger Archivo | .github/scripts/validate.mjs | standard, factory | |
humanlayer-skills-license Archivo | .agents/skills/LICENSE.humanlayer-skills | Todos | |
implementation-ticket-template Archivo | .github/ISSUE_TEMPLATE/implementation-ticket.yml | standard, factory | |
issue-contract-cutoff Archivo | scripts/issue-contract-cutoff.mjs | standard, factory | |
issue-contract-sources Archivo | scripts/issue-contract-sources.mjs | Todos | |
issue-contract-store Archivo | scripts/issue-contract-store.mjs | Todos | |
issue-contract-validator Archivo | vendor/repo-canon/validate-issue-contract.mjs | Todos | |
issue-contract-workflow Archivo | .github/workflows/issue-contracts.yml | standard, factory | |
issue-tracker-configuration Archivo | docs/agents/issue-tracker.md | standard, factory | |
marked-license Archivo | vendor/marked/LICENSE | Todos | |
marked-parser Archivo | vendor/marked/marked.esm.js | Todos | |
marked-provenance Archivo | vendor/marked/README.md | Todos | |
mattpocock-skills-license Archivo | .agents/skills/LICENSE.mattpocock-skills | Todos | |
parse5-entities-license Archivo | vendor/parse5/LICENSE.entities | Todos | |
parse5-license Archivo | vendor/parse5/LICENSE.parse5 | Todos | |
parse5-parser Archivo | vendor/parse5/parse5.esm.js | Todos | |
parse5-provenance Archivo | vendor/parse5/README.md | Todos | |
postern-bundle Archivo | vendor/postern/postern.mjs | Todos | |
postern-license Archivo | vendor/postern/LICENSE | Todos | |
postern-provenance Archivo | vendor/postern/README.md | Todos | |
pr-metadata-validator Archivo | .github/scripts/validate-pr-metadata.mjs | standard, factory | |
pr-metadata-workflow Archivo | .github/workflows/pr-metadata.yml | standard, factory | |
project-agent-guidance Archivo | docs/agents/project.md | standard, factory | |
project-readmes Pautas del repositorio | Rutas que encuentra en cada proyecto | project-readme-structure | standard, factory |
pull-request-template Archivo | .github/PULL_REQUEST_TEMPLATE.md | standard, factory | |
rendered-markdown-runtime Archivo | operations/lib/rendered-markdown.mjs | Todos | |
repository-license Archivo | LICENSE | standard, factory | |
repository-readme Archivo | README.md | repository-readme-structure | standard, factory |
skill-babysit Skill | .agents/skills/babysit/ | Todos | |
skill-code-review Skill | .agents/skills/code-review/ | Todos | |
skill-codebase-design Skill | .agents/skills/codebase-design/ | Todos | |
skill-create-adopted-repo Skill | .agents/skills/create-adopted-repo/ | workbench | |
skill-create-repository Skill | .agents/skills/create-repository/ | workbench | |
skill-diagnosing-bugs Skill | .agents/skills/diagnosing-bugs/ | Todos | |
skill-domain-modeling Skill | .agents/skills/domain-modeling/ | Todos | |
skill-factory Skill | .agents/skills/factory/ | factory | |
skill-grill-with-docs Skill | .agents/skills/grill-with-docs/ | Todos | |
skill-grilling Skill | .agents/skills/grilling/ | Todos | |
skill-implement Skill | .agents/skills/implement/ | Todos | |
skill-improve-codebase-architecture Skill | .agents/skills/improve-codebase-architecture/ | Todos | |
skill-orchestrate Skill | .agents/skills/orchestrate/ | workbench | |
skill-pr Skill | .agents/skills/pr/ | Todos | |
skill-prototype Skill | .agents/skills/prototype/ | Todos | |
skill-research Skill | .agents/skills/research/ | Todos | |
skill-review Skill | .agents/skills/review/ | Todos | |
skill-tdd Skill | .agents/skills/tdd/ | Todos | |
skill-to-spec Skill | .agents/skills/to-spec/ | Todos | |
skill-to-tickets Skill | .agents/skills/to-tickets/ | Todos | |
skill-triage Skill | .agents/skills/triage/ | Todos | |
skill-wayfinder Skill | .agents/skills/wayfinder/ | Todos | |
skill-writing-for-agents Skill | .agents/skills/writing-for-agents/ | Todos | |
specification-template Archivo | .github/ISSUE_TEMPLATE/specification.yml | standard, factory | |
standards-update-workflow Archivo | .github/workflows/standards-update.yml | standard, factory | |
triage-label-configuration Archivo | docs/agents/triage-labels.md | standard, factory | |
typescript-astro-stack Pautas del repositorio | Rutas que encuentra en cada proyecto | typescript-astro-stack-manifests | standard, factory |
typescript-node-stack Pautas del repositorio | Rutas que encuentra en cada proyecto | typescript-node-stack-manifests | standard, factory |
typescript-vite-stack Pautas del repositorio | Rutas que encuentra en cada proyecto | typescript-vite-stack-manifests | standard, factory |
validator-command Archivo | vendor/repo-canon/validate.mjs | standard, factory |