What problem does it solve? Architecture documentation often becomes either a bloated template nobody reads or a stale artifact disconnected from the actual code. This Skill produces compact, evidence-backed architecture briefs, decision records, and reviews that stay synchronized with the implementation. ## Core Features & Use Cases - Architecture Briefs: Create arc42-informed compact briefs covering purpose, quality scenarios, context, building blocks, critical flows, deployment, and risks, including only relevant sections. - Architecture Decision Records: Apply a significance test to decide when an ADR is warranted, then record context, drivers, options, consequences, and confirmation checks with a proper lifecycle (proposed, accepted, superseded). - Architecture Reviews: Audit drift between code, tests, deployment, and documentation with a structured findings template citing exact artifact evidence. - Use Case: When choosing between PostgreSQL advisory locks and a Redis lease for job ownership, use this Skill to produce one concise proposed ADR with both options, tradeoffs, and a conformance check, then update the architecture summary after acceptance. ## Quick Start Use the lightweight-architecture skill to write an architecture brief for the upload service based on its current code and deployment configuration.
