adr-eligibility-gate

Evaluate architectural choices against a five-question eligibility checklist.

8|2|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/SebastienDegodez/skraft-plugin --skill adr-eligibility-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-eligibility-gate
Source: https://github.com/SebastienDegodez/skraft-plugin/tree/main/plugins/skills/adr-eligibility-gate
Command: npx skills add https://github.com/SebastienDegodez/skraft-plugin --skill adr-eligibility-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires architecture-decisions, architecture-patterns, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps prevent ADR over-production by ensuring that only genuine open questions with real trade-offs are addressed in ADRs.

Core Features & Use Cases

  • Pre-draft Gate: Determines if an architectural choice warrants an ADR before writing any draft.
  • 5-Question Checklist: Provides a structured approach to evaluate the eligibility of an architectural choice.
  • Integration with architecture-decisions Skill: Precedes the architecture-decisions skill to filter out non-decisions.

Quick Start

Load the adr-eligibility-gate skill to assess the eligibility of a candidate architectural choice for an ADR.

Frequently Asked Questions about adr-eligibility-gate

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

FAQPage Schema
When do I need to write an architectural decision record?

You need to write an architectural decision record only for genuine open questions with real trade-offs. This Skill evaluates candidate architectural choices using a 5-question checklist to ensure they warrant an ADR before drafting begins.

How do I prevent ADR over-production in my engineering team?

To prevent ADR over-production, you can apply a pre-draft gate to filter out non-decisions. This Skill evaluates architectural choices based on baseline enforcement, complexity, raised questions, and trade-offs before any draft is written.

What questions should I ask before creating an ADR draft?

Before creating an ADR draft, ask questions related to baseline enforcement, complexity, raised questions, and trade-offs. This Skill provides a 5-question checklist to evaluate the eligibility of a candidate architectural choice.

Does the ADR eligibility gate require other architecture skills to work?

Yes, the ADR eligibility gate requires the `architecture-decisions` and `architecture-patterns` skills to provide context. It integrates as a pre-draft filter preceding the `architecture-decisions` skill to eliminate non-decisions.

When should I not use an ADR for an architectural choice?

You should not use an ADR when an architectural choice lacks real trade-offs or genuine open questions. This Skill acts as a constraint filter to prevent drafting records for non-decisions that do not meet baseline complexity requirements.