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.

Prompt del agente
Terminal

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