skills.rest
VictorHueni
VictorHueniCOMMUNITY
Explore all skills by this author →
GitHub

spec-adr-manager

Create, update, and review Architecture Decision Records following MADR 4.x conventions.

1|Updated Feb 22, 2026
Search Tags:#architecture#decision making#documentation#adr#technical specification#madr
One-click install
npx skills add https://github.com/VictorHueni/openAI-agentic-codebase-scaffold --skill spec-adr-manager
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-adr-manager
Source: https://github.com/VictorHueni/openAI-agentic-codebase-scaffold/tree/main/harness/workforce/agent-template/skills/spec-adr-manager
Command: npx skills add https://github.com/VictorHueni/openAI-agentic-codebase-scaffold --skill spec-adr-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation, review, and maintenance of Architecture Decision Records (ADRs), ensuring clear, auditable documentation of technical choices.

Core Features & Use Cases

  • ADR Creation: Generates new ADRs based on MADR conventions and repository patterns.
  • ADR Updating: Revises existing ADRs while preserving decision history.
  • ADR Review: Audits ADRs for quality, completeness, and adherence to standards, providing actionable feedback.
  • Use Case: When a significant technical choice needs to be made for a new feature, use this Skill to document the problem, explore options, justify the chosen solution, and record its consequences.

Quick Start

Use the spec-adr-manager skill to create a new ADR for the authentication service.

Frequently Asked Questions about spec-adr-manager

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

FAQPage Schema
What is an Architecture Decision Record and when do I need to document one?▼

An Architecture Decision Record (ADR) documents a significant technical choice, capturing the problem, explored options, and consequences. You need an ADR when making architectural decisions that require clear, auditable justification for future review and traceability.

How do I create a new ADR following MADR conventions?▼

To create a new ADR following MADR 4.x conventions, provide the technical context and decision problem. The skill generates structured Markdown output documenting the decision, adhering to repository-specific patterns and decision quality criteria for traceability.

Can I update an existing technical specification without losing the decision history?▼

Yes, you can update an existing technical specification or ADR without losing decision history. The skill revises Architecture Decision Records while preserving the original context and maintaining an auditable trace of architectural changes over time.

How do I review an ADR for completeness and adherence to standards?▼

You review an ADR by auditing its content against decision quality criteria and MADR 4.x standards. The skill audits Architecture Decision Records for completeness, providing actionable feedback to improve technical specification documentation and adherence.

Does this ADR manager work with repository-specific documentation patterns?▼

Yes, this ADR manager works with repository-specific patterns by adapting the MADR 4.x conventions to fit your existing documentation structure. It ensures generated technical specifications integrate smoothly with your current architecture documentation workflow.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

webapp-testing

Generate Markdown Architectural Decision Records from structured inputs.

Community
Advanced
microsoftmicrosoft
2.9k

wiki-vitepress

Package wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.

Official
Advanced
1479089714790897
7

kwp-engineering-code-review

Analyze source code for security vulnerabilities, performance bottlenecks, and maintainability issues from pull request URLs or local file paths.

Community
Advanced
VictorHueniVictorHueni

arch-adr

Automate creation, review, and maintenance of Architecture Decision Records using MADR 4.x conventions.

Community
Advanced