Value: Communication -- architecture decisions recorded before implementation ensure every contributor (human or agent) understands why the system is shaped the way it is. Decisions made in silence are decisions lost.
Teaches the agent to record architecture decisions before implementing them, maintain a living architecture document, and facilitate structured decision-making. Prevents the common failure mode where architecture emerges accidentally and rationale is lost.
Never implement a structural change without first recording the decision. An architecture decision is any choice that affects system structure, technology stack, domain boundaries, integration patterns, or cross-cutting concerns.
Registros de decisiones arquitectónicas y documentación de arquitectura viva. Actívelo al tomar decisiones tecnológicas, definir los límites del sistema, registrar decisiones arquitectónicas o crear/actualizar ARCHITECTURE.md. Cubre el formato ADR, la gobernanza de decisiones, la facilitación del diseño y la revisión arquitectónica. Fuente: jwilger/agent-skills.