skills.rest
GainInsightDev
GainInsightDevOFFICIAL
Explore all skills by this author →
WebsiteGitHub

af-architecture-expertise

Create, document, and review architectural decisions using ADR methodology.

Updated Feb 8, 2026
Search Tags:#architecture#code review#decision making#adr#compliance#patterns
One-click install
npx skills add https://github.com/GainInsightDev/websites --skill af-architecture-expertise
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: af-architecture-expertise
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-architecture-expertise
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-architecture-expertise

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for making, documenting, and enforcing architectural decisions, ensuring consistency and alignment across projects.

Core Features & Use Cases

  • ADR Lifecycle Management: Guides users through proposing, accepting, and managing Architecture Decision Records (ADRs).
  • Architectural Compliance: Helps review code and changes against established architectural patterns and decisions.
  • Use Case: When starting a new feature, use this Skill to quickly understand existing architectural constraints by reviewing the ADR index, and to create a new ADR if the feature introduces a significant architectural change.

Quick Start

Use the af-architecture-expertise skill to create a new ADR for a proposed change to the authentication system.

Frequently Asked Questions about af-architecture-expertise

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

FAQPage Schema
How do I create an Architecture Decision Record for a new feature?▼

To create an Architecture Decision Record (ADR), this skill guides you through the lifecycle management process to propose, document, and accept architectural decisions for new features. It enforces alignment with established architectural principles.

What is architectural drift detection and how does it work?▼

Architectural drift detection identifies deviations from established architectural patterns and decisions within projects. It enforces adherence to documented frameworks by reviewing code changes against accepted ADRs.

How do I review code for architectural compliance?▼

To review code for architectural compliance, this skill evaluates your changes against established architectural patterns and documented decisions. It identifies architectural drift to ensure consistency and alignment across projects.

When do I need to document architectural decisions using ADRs?▼

You need to document architectural decisions using ADRs when a new feature introduces significant architectural changes or constraints. Reviewing the ADR index first helps understand existing limitations before proposing new patterns.

Can I manage the full ADR lifecycle within standard projects?▼

Yes, you can manage the full ADR lifecycle within GainInsight Standard projects. This skill supports proposing, accepting, and managing Architecture Decision Records to enforce decision frameworks and maintain consistency.

What is the best way to enforce established architectural patterns?▼

The best way to enforce established architectural patterns is through architectural compliance reviews and drift detection. This skill checks code against documented decisions to prevent architectural drift and maintain alignment.

Related Skills

Explore More Software Engineering Skills→
KanakMalpaniKanakMalpani

architecture-decision-records

Document architectural decisions in ADR format with Context, Decision, Alternatives, and Consequences.

Community
Advanced
zgagnonzgagnon
1

adr-review

Review code against project ADRs and report violations with fixes.

Community
Advanced
stevolandstevoland

adr

Create and manage MADR-compliant Architecture Decision Records across projects.

Community
Basic
raykrayk
3

create-adr

Create Architecture Decision Records with ADR-NNN naming and lifecycle statuses.

Community
Advanced