Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 3.44 KB

README.es.md

File metadata and controls

85 lines (63 loc) · 3.44 KB

ADR Toolkit

English    한국어    日本語    简体中文    Français    Español    Deutsch

Release: v1.1.2 Python: 3.10+ License: MIT ADR locales: 8 README languages: 7

ADR Toolkit es una herramienta Architecture Decision Record nativa para agentes. Inspecciona primero el repositorio y las decisiones existentes, pregunta solo lo necesario, registra nuevas decisiones como MADR aprobado y compara diffs con las reglas constraints: de los ADR Accepted.

Funciones

Operation Descripcion
INIT Inicializa docs/decisions/, la plantilla y ADR-0001.
DISCOVER Busca en manifests, codigo y git history decisiones historicas no documentadas, y prepara borradores de ADR para aprobar.
RECORD Registra una nueva decision tras inspeccionar el codigo, con un maximo de 3 preguntas.
CHECK Compara un diff con constraints: de ADR Accepted e informa Related / Review required / Verified violation / No applicable constraint.

Instalacion

skills/adr-toolkit/ es un paquete autocontenido. Copialo o crea un symlink en el lugar donde tu harness busca skills, y sigue el README del adapter correspondiente.

Harness Install
Claude Code .claude-plugin/
Codex CLI adapters/codex/README.md
Gemini CLI adapters/gemini-cli/README.md
Antigravity CLI adapters/antigravity/README.md
Cline CLI adapters/cline/README.md
Generic adapters/generic/README.md

Sin AI harness tambien puedes usar la CLI interactiva.

python skills/adr-toolkit/scripts/adr.py create --interactive --dir docs/decisions --json

Idioma y configuracion del repositorio

El texto deterministico del nucleo de la herramienta admite 8 locales: en, ko, ja, zh, fr, es, de, pt-BR.

python skills/adr-toolkit/scripts/adr.py init --locale es --dir docs/decisions --json

Este comando crea .adr-toolkit.json en la raiz del repositorio. Los comandos siguientes usan el locale por defecto del repositorio. Un --locale explicito lo reemplaza para una sola operacion.

Alcance

  • Usa el formato MADR 4.x; no crea un nuevo estandar.
  • CHECK evalua solo evidencia estructural expresable mediante constraints:.
  • INIT, CREATE e INDEX generan salida deterministica en 8 locales.
  • El trabajo fuera del MVP se registra en project-roadmap.md.

Contribuir

Lee primero AGENTS.md. Contiene las reglas comunes de trabajo y la politica de ramas del repositorio.

Licencia

MIT