Skills
.Work. You
Rest

kata-architecture-brief

Official

Turn issues into scoped architectures fast.

Software Engineering#architecture#documentation#api design#adr#issue-driven#event design#scope mapping
Authorguardiatechnology
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps teams avoid vague architecture work by transforming an issue brief into a precise, reviewable architecture scope that maps impacted components and drives consistent decision-making.

Core Features & Use Cases

  • Affected component mapping: Identify which modules, contracts, specs, and events will change and consolidate them into a binding scope table.
  • Technical approach and architecture planning: Define the main flow, alternative/error/idempotency/retry flows, persistence needs, integrations, and observability.
  • Decision quality with ADR delegation: Determine which items require ADRs, delegate API/event design to specialist warriors when applicable, and generate proposed ADRs and the phase architecture document.

Quick Start

Use kata-architecture-brief to read phases 1 and 2 under .ahrena/issues/{n}/, then produce .ahrena/issues/{n}/03-architecture.md with the mapped scope, approach, specialist delegation references, and proposed ADRs.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: kata-architecture-brief
Download link: https://github.com/guardiatechnology/design-system/archive/main.zip#kata-architecture-brief

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.