registro-decisao-arquitetura

You document architectural decisions by creating Architectural Decision Records (ADRs) that capture context, alternatives, and consequences to prevent technical debt. This skill uses the standardized Nygard template to record architectural memory effectively.

The Nygard template is a standardized format for creating Architectural Decision Records that structures documentation by capturing context, decisions, consequences, and alternatives. It provides a consistent structure for teams to maintain architectural memory of significant software design choices.

To write an ADR for a new database technology, use this skill to outline the problem, the chosen database, its benefits and drawbacks, and why other options were rejected. This ensures the why behind your architectural decision is clearly contextualized for future reference.

You need to create an Architectural Decision Record when making significant system design choices that require shared understanding, such as selecting a new database technology. Documenting these decisions ensures clarity and preserves the context for future development teams.

Common pitfalls in ADR creation include failing to capture the context and alternatives behind a decision, which obscures the reasoning for future teams. This skill includes best practices to avoid these common documentation mistakes and maintain clear architectural memory.