Documents & Data · IN-DEPTH PROFILE

create-architectural-decision-record

Structured ADRs with context, consequences, rejected alternatives, and implementation notes.

View listed source ↗Installation guide ↓
Best for

Architecture teams documenting consequential technical choices

What you get

Gather required inputs + Write a standard ADR

Main limitation

A fixed template cannot ensure the decision evidence is complete or correct.

First risk

Unreviewed decision presented as settled. Generated ADRs default to Proposed and may contain inferred stakeholders or rationale. Require owner review before acceptance and verify the next sequence number before writing.

EVIDENCE FRESHNESS

Three checks, kept separate

A recent source check is not a runtime test or security audit.

Upstream sourceChecked 2026-08-20

Pinned revision · 318066d2

Open pinned commit ↗
SkillSignal profileEditorial metadata

Updated 2026-08-20

Runtime & securityNot independently verified

Source review does not certify behavior or safety.

30-SECOND BRIEF

What it does—and when it fits

Create Architectural Decision Record is a GitHub Awesome Copilot template for durable architecture decisions. It captures context, the chosen decision, positive and negative consequences, rejected alternatives, implementation notes, stakeholders, and references in a predictable Markdown structure.

INSTALL BY AGENT

Choose your Agent

Paths come from official Agent docs or the universal installer behind skills.sh. Compatibility still follows this Skill's record.

Native

This Skill's current record explicitly names this Agent. Still inspect scripts, permissions, and external dependencies first.

Project scope.agents/skills/create-architectural-decision-record/
Personal scope~/.copilot/skills/create-architectural-decision-record/

Use project scope for team sharing and personal scope across repositories. The installer defaults to project scope; add -g for personal scope.

Install command (project scope)npx skills add github/awesome-copilot --skill create-architectural-decision-record --agent github-copilot
Official agent docs

Copilot also accepts .github/skills and .claude/skills at project scope. Preview untrusted Skills before enabling scripts.

View path evidence ↗

TYPICAL WORKFLOW

A practical workflow

01

Gather required inputs

Confirm context, decision, alternatives, and stakeholders.

02

Write a standard ADR

Generate numbered front matter and coded consequence sections.

03

Preserve rejected options

Document why alternatives were not selected and what may change later.

THE TRADEOFFS

Advantages and tradeoffs

Notable strengths

  1. Produces predictable, machine-readable decision records.
  2. Requires both benefits and trade-offs instead of documenting only the winning option.

Limitations

  1. A fixed template cannot ensure the decision evidence is complete or correct.
  2. The workflow writes Proposed ADRs but does not manage approval, supersession, or governance.

COMPARE THE TRADEOFF

Consider these close alternatives

These are deterministic nearby candidates, not paid placements or a universal ranking. Open the full profile before choosing.

01

Same job family · native to GitHub Copilot

brag-sheet

Evidence-backed impact statements reconstructed from work history without invented metrics.
Tradeoff to check
Local logs and repository history cannot capture unrecorded collaboration or business outcomes.
First risk
Sensitive work history aggregation · High
Source state
Pinned · 318066d2
Open profile ↗
02

Same job family · native to GitHub Copilot

daily-focus-board

A browser-based daily focus board with gentle prioritization, progress notes, counters, and local persistence.
Tradeoff to check
Progress lives in browser localStorage and the agent cannot read it back automatically.
First risk
Personal task data persists in the browser · Medium
Source state
Pinned · 318066d2
Open profile ↗
03

Same job family · native to GitHub Copilot

meeting-minutes

Concise internal meeting records centered on verified decisions, owned actions, due dates, and follow-up.
Tradeoff to check
Designed for internal meetings of 60 minutes or less; long workshops need a different synthesis approach.
First risk
Private conversation redistributed as a formal record · High
Source state
Pinned · 318066d2
Open profile ↗
Compare more in the directory →

BEST FIT

Who it is for

→

Architecture teams documenting consequential technical choices

→

Repositories that need searchable decision history

BEFORE YOU USE IT

Risks to review before use

Medium

Unreviewed decision presented as settled

Generated ADRs default to Proposed and may contain inferred stakeholders or rationale. Require owner review before acceptance and verify the next sequence number before writing.

SECURITY

What the permission profile means

  • Avoid embedding credentials, private architecture diagrams, or exploitable details in broadly shared ADRs.
  • Use repository review and ownership rules before changing status to Accepted.

Not a security certification. External ratings are attributed references. SkillSignal has not independently executed or security-reviewed this Skill.

INSIDE THE PACKAGE

Indexed files

SKILL.mdUpstream package contentSource-linked

TAGS

adrarchitecturedocumentation

Original SkillSignal editorial profile grounded in GitHub Awesome Copilot commit 318066d2, checked 2026-08-20; not independently executed or security-certified.