adr-writing-stinger

Create Architecture Decision Records with context, alternatives, and consequences.

72|28|Updated May 23, 2026
One-click install
npx skills add https://github.com/legioncodeinc/that-git-life --skill adr-writing-stinger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-writing-stinger
Source: https://github.com/legioncodeinc/that-git-life/tree/main/.claude/skills/adr-writing-stinger
Command: npx skills add https://github.com/legioncodeinc/that-git-life --skill adr-writing-stinger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams preserve the reasoning behind important architecture choices by turning complex technical decisions into clear, maintainable Architecture Decision Records instead of forgotten conversations or scattered documentation.

Core Features & Use Cases

  • ADR Authoring Guidance: Creates structured decision records using Nygard, MADR, and Y-statement approaches with context, decisions, consequences, and alternatives.
  • Decision Lifecycle Management: Supports superseding, deprecating, auditing, and maintaining ADR histories with traceable status transitions.
  • Tooling and Adoption Support: Guides teams through ADR log setup, adr-tools or Log4brains workflows, and onboarding practices based on architectural decision history.

Quick Start

Use the adr-writing-stinger skill to create an ADR for our decision to adopt a new database architecture and include the context, alternatives, consequences, and lifecycle status.

Frequently Asked Questions about adr-writing-stinger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an Architecture Decision Record for a new database architecture?

An Architecture Decision Record captures context, decisions, consequences, and alternatives. You can structure records using Nygard, MADR, or Y-statement formats to preserve technical rationale for major software architecture choices.

What is the best way to manage Architecture Decision Record lifecycle and supersession?

Manage Architecture Decision Record lifecycles by tracking supersession, deprecation, and audit workflows. This ensures traceable status transitions and maintains a clear architectural decision history for your software engineering team.

How does log4brains work with ADR documentation workflows?

Log4brains integrates with ADR documentation workflows by guiding teams through ADR log setup and onboarding practices. It helps maintain consistent decision formats and lifecycle tracking for software architecture decisions.

When do I need Architecture Decision Records for software architecture decisions?

You need Architecture Decision Records when you must preserve the reasoning behind important architecture choices. They replace forgotten conversations or scattered documentation with maintainable, structured technical rationale.

Can I use MADR and Nygard formats together for architecture decisions?

Yes, you can apply both MADR and Nygard formats for architecture decisions. This approach supports multiple templates, allowing you to capture context, alternatives, and consequences while maintaining consistent ADR documentation practices.

What are the limitations of maintaining ADR histories for team onboarding?

ADR histories require consistent formats and lifecycle tracking to remain useful for team onboarding. Without proper supersession workflows and decision audits, architecture documentation can become inconsistent and lose its traceable technical rationale.