English 한국어 日本語 简体中文 Français Español Deutsch
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.
| 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. |
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 --jsonEl 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 --jsonEste 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.
- 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.
Lee primero AGENTS.md. Contiene las reglas comunes de
trabajo y la politica de ramas del repositorio.