por Juanjo LunaRegistrar una decisión técnica
Te ayuda a documentar una decisión de arquitectura ya tomada. Sirve para dejar por escrito el contexto, las opciones valoradas, la elección y sus consecuencias.
Descripción original (inglés)
record-a-decision: Records an architecture decision as a Nygard/MADR-shaped ADR under decisions/ — capturing the context that forced the choice, the options weighed, the decision itself, and its consequences in both directions, plus the supersedes chain that keeps a decision log honest. Read when asked to record an architecture decision, write an ADR, log the decision we made, document why we chose X over Y, capture this decision for the record, or supersede an old decision with a new one. Do NOT read to frame a proposal or explore an idea not yet decided (frame-a-proposal), to write a spec or implementation plan (write-a-spec), to write an incident postmortem (write-a-postmortem), or to judge whether a design is sound (review-a-design). This skill records a decision already made; it does not make one.
Cómo instalarla
Una skill es una carpeta con un fichero SKILL.md. Para instalarla basta con copiar la carpeta record-a-decision en el sitio donde tu agente busca sus skills.
- Sin terminal: abre la carpeta en GitHub, descárgala y cópiala en la carpeta de tu agente (tabla de abajo).
- Con terminal (macOS, Linux o Git Bash en Windows): elige tu agente y copia los comandos.
git clone --depth 1 https://github.com/inkeep/open-knowledge.git /tmp/skill-src
mkdir -p ~/.claude/skills
cp -r "/tmp/skill-src/packages/server/assets/skills/packs/software-lifecycle/record-a-decision" ~/.claude/skills/record-a-decision
rm -rf /tmp/skill-src| Agente | Para todos tus proyectos | Solo un proyecto |
|---|---|---|
| Claude Code | ~/.claude/skills | .claude/skills |
| GitHub Copilot | ~/.copilot/skills | .github/skills |
| Codex | ~/.agents/skills | .agents/skills |
| Gemini CLI | ~/.gemini/skills | .gemini/skills |
Muchos agentes leen también .agents/skills. Reinicia el agente después de instalar. Antes de instalar una skill, revisa su SKILL.md y los scripts que incluya: se ejecutan con tus permisos.
Más skills de inkeep/open-knowledge
- Trabajar con Codebase Wiki codebase-wiki
- Consolidar notas de investigación consolidate-notes
- Redactar una propuesta técnica frame-a-proposal
- Trabajar con base de conocimiento knowledge-base
- Tomar notas y diario diario note-taking
- Guía de Open Knowledge Format okf-knowledge-base
- Usar OpenKnowledge open-knowledge
- Descubrir OpenKnowledge open-knowledge-discovery
Explicación redactada con ayuda de IA a partir de la descripción original.