skills.rest
shftwst
shftwstOFFICIAL
Explore all skills by this author →
GitHub

faffter-noon-adr

Authors Nygard-format architecture decision record bodies from settled decisions at graft time.

3|Updated Apr 16, 2026
Search Tags:#documentation#adr#decision logging#architecture decision record#nygard#graft#faff
One-click install
npx skills add https://github.com/shftwst/faff --skill faffter-noon-adr-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faffter-noon-adr
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faffter-noon-adr
Command: npx skills add https://github.com/shftwst/faff --skill faffter-noon-adr-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing architecture decision records by hand after a build is finished is repetitive and often skipped, leaving shipped work undocumented. This Skill automates the prose authoring of ADRs so every settled decision gets a consistent, structured record tied to what actually shipped. ## Core Features & Use Cases - Nygard ADR Authoring: Generates the Context, Decision, and Consequences sections of an architecture decision record from a settled decision plus the spec rationale. - Cross-Referencing: Links related or superseded ADRs by what they decide, using the existing ADR log as input. - Self-Review and Confidence Rating: Checks the Consequences against what actually shipped and emits an advisory high/medium/low confidence rating. - Use Case: During a graft run, a promoted decision like "Chosen: use event sourcing for the order ledger" is turned into a complete ADR body that the faff adr CLI scaffolds, numbers, validates, and commits on the feature branch. ## Quick Start Configure this producer as the adr slot so graft automatically authors the ADR body whenever a decision is promoted after a build.

Frequently Asked Questions about faffter-noon-adr

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

FAQPage Schema
How do I automatically generate architecture decision records?▼

Configure this producer as the adr slot in faff so graft invokes it when a decision is promoted. It writes the Context, Decision, and Consections sections from the settled decision and spec rationale, while the faff adr CLI handles scaffolding, numbering, and committing.

What format does the ADR output follow?▼

The output follows the Nygard ADR format with three sections: Context describing the forces behind the decision, Decision stating the settled choice with rationale, and Consequences describing downstream constraints and trade-offs.

When in the workflow are ADRs authored?▼

ADRs are authored at graft time, after the build completes, not at spec time. This ensures the Consequences section reflects what actually shipped rather than guesses made before implementation.

Can this skill record undecided or punted decisions?▼

No. It only authors settled decisions marked as Chosen. A Punt is not yet a decision, is never promoted, and therefore never reaches the ADR authoring step.

Does the confidence rating block ADR creation?▼

No. The confidence self-rating is advisory only with no pass/fail gate. Graft always records a promoted decision; the rating only influences how it is surfaced or whether a bounded auto-refinement pass runs.

Related Skills

Explore More Software Engineering Skills→
muddyrainmuddyrain
1

unity-adr

Document Unity architecture decisions with context, options, and rationale.

Community
Advanced
outfitter-devoutfitter-dev
4

trails-adrs

Document Trails ADRs with context, decisions, and consequences across CLI, MCP, and HTTP surfaces.

Official
Advanced
sddevelopment-besddevelopment-be
13

ARCHITECT ADR

Generate Proposed ADR Markdown files with decision sections and impact matrices.

Official
Advanced
zorgentechzorgentech

create-adr

Create Architecture Decision Records from pull request metadata and diffs.

Official
Intermediate