Can I customize the generated documentation templates?

Absolutely. Once the skill generates the initial 'docs' directory, you can modify the templates in 'docs/adr/000-template.md' or 'docs/runbook.md' to fit your team's specific requirements.

Does this skill provide interactive tools?

Yes, it generates TypeScript scripts that allow you to create new ADRs interactively or list existing ones directly from your terminal using the Bun runtime.

What is an Architecture Decision Record (ADR)?

An ADR is a document that captures an important architectural decision, including the context in which it was made, the options considered, and the resulting consequences and trade-offs.

How does this skill help with project compliance?

It provides a standardized structure for documenting technical decisions and operational procedures, ensuring that your project meets engineering best practices and maintains a clear audit trail of system changes.

Compliance & Architecture Documentation

Name: Compliance & Architecture Documentation
Author: mattwoodco

bymattwoodco

•

Aprendizaje y Documentación

Generates Architecture Decision Records (ADRs), operational runbooks, and standardized project documentation to maintain engineering rigor.

This skill automates the setup of a professional documentation ecosystem within your codebase to ensure long-term maintainability and team alignment. It establishes a structured directory for Architecture Decision Records (ADRs) complete with templates and interactive CLI management scripts, creates detailed operational runbooks for incident response, and generates clear contributing guidelines. By documenting the 'why' behind technical choices and the 'how' for operations, this skill helps teams reduce technical debt and improve knowledge retention across the development lifecycle.

Características Principales

01Built-in ADR indexing system to track decision status from 'Proposed' to 'Superseded'

02Standardized CONTRIBUTING.md generation for consistent team workflows

03Comprehensive operational runbook templates for incident playbooks and health checks

04Interactive CLI scripts for creating and listing documentation entries via Bun

053 GitHub stars

06Automated Architecture Decision Record (ADR) framework with versioned templates

Casos de Uso

01Establishing on-call runbooks for production services to reduce Mean Time to Recovery (MTTR)

02Creating a historical audit trail of architectural decisions for new team members and stakeholders

03Documenting major technical pivots like switching database engines or authentication providers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mattwoodco/skills compliance

For use in Claude.ai and ChatGPT

Download Skill