adr-workflow

Automate creation and management of Architecture Decision Records for Kubernetes governance.

Updated Aug 23, 2026

Search Tags:#devops #documentation #adr #kubernetes #architecture-decision #theseus

Ready to run

npx skills add https://github.com/HugoAlmeidaMoreira/zeus-agent --skill adr-workflow

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr-workflow
Source: https://github.com/HugoAlmeidaMoreira/zeus-agent/tree/main/skills/adr-workflow
Command: npx skills add https://github.com/HugoAlmeidaMoreira/zeus-agent --skill adr-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The ADR workflow provides a standardized process and template for documenting architectural decisions, ensuring traceability and governance over Kubernetes-related changes within Theseus.

Core Features & Use Cases

ADR Template: Provides a consistent structure with Context, Decision, Consequences and metadata fields.
Storage & Naming: Defines storage location and file-naming conventions to keep ADRs organized.
Execution Guidance: Step-by-step workflow for creating, saving, and reporting ADRs.

Quick Start

Draft a new ADR using the template and save it to the next available NNNN-title.md under ~/office/devops/adr/.

Frequently Asked Questions about adr-workflow

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

FAQPage Schema

How do I document Kubernetes architecture decisions for cluster configurations?▼

Architecture Decision Records for Kubernetes governance use a standardized template containing Context, Decision, Consequences, and metadata fields. This structure captures the reasoning behind tool changes, cluster configurations, and security considerations for consistent traceability.

What is the best way to standardize Architecture Decision Records for DevOps?▼

The best way to standardize ADRs for DevOps is applying a consistent template with defined storage paths and file-naming conventions. This enforces a structured workflow for creating, saving, and reporting architectural decisions across the infrastructure.

How do I create a new ADR and where should the file be saved?▼

Creating an ADR involves drafting a new document from the template and saving it as the next available NNNN-title.md file under the ~/office/devops/adr/ path. This standardized execution workflow ensures records remain organized and sequentially numbered.

Does the ADR workflow apply to security considerations and tool changes in Kubernetes?▼

Yes, the ADR workflow applies to security considerations and tool changes in Kubernetes. It standardizes documentation tasks for architectural decisions, ensuring governance over any infrastructure modifications within the Theseus environment.

What metadata fields are required when documenting an architecture decision?▼

Documenting an architecture decision requires a template structure with Context, Decision, Consequences, and metadata fields. These components ensure traceability and governance over Kubernetes-related changes within Theseus.