skills.rest
HugoAlmeidaMoreira
HugoAlmeidaMoreiraCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/HugoAlmeidaMoreira/zeus-agent --skill adr-workflow
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
CaneproCanepro

kubernetes-platform-architecture

Design Kubernetes platform architectures for production workloads.

Community
Advanced
abdullah1854abdullah1854
1

adr-generator

Generate Markdown Architectural Decision Records from structured inputs with automatic numbering and date stamping.

Community
Advanced
PriyanshKuniyalPriyanshKuniyal

gitops-workflow

Automate Kubernetes resource deployment and reconciliation from a Git repository.

Community
Advanced
Partners-in-BizPartners-in-Biz

documentation-and-adrs

Document architectural decisions and design rationales in Markdown ADRs with YAML frontmatter.

Community
Advanced