architecture-skill

Create and validate software architecture documentation with decision logs and dependency mappings.

Updated May 7, 2026
One-click install
npx skills add https://github.com/cornellsh/arch-dotfiles --skill architecture-skill-cornellsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-skill
Source: https://github.com/cornellsh/arch-dotfiles/tree/main/agents/skills/architecture-skill
Command: npx skills add https://github.com/cornellsh/arch-dotfiles --skill architecture-skill-cornellsh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill helps users create comprehensive, validated architectural documents for complex software systems, reducing ambiguity and ensuring alignment.

Core Features & Use Cases

  • Structured Documentation: Guides users through capturing architecture layers, decisions, risks, and dependencies.
  • Retrospective Analysis: Supports retrofitting existing systems for accuracy and clarity.
  • Decision Discipline Enforcement: Ensures decisions are falsifiable, ownership-bound, and well-annotated with switch criteria.
  • Use Case: Architects can document a multi-year system, align teams, and identify gaps or conflicts, facilitating safer deployment planning.

Quick Start

Input your current system description and prompt the AI to generate a detailed architecture plan with decision rationales.

Frequently Asked Questions about architecture-skill

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

FAQPage Schema
How do I create software architecture documentation with decision logs and dependency mappings?

To create software architecture documentation, input your current system description to generate a detailed plan capturing architecture layers, decision rationales, risks, and dependency mappings. This structured documentation ensures team alignment and reduces system ambiguity.

What is the best way to retrofit existing systems for architectural clarity?

The best way to retrofit existing systems is through retrospective analysis, which supports retrofitting current architectures to validate accuracy and identify gaps. This process improves clarity and ensures your documented decisions remain falsifiable and ownership-bound.

How does system documentation enforce decision discipline in phased planning?

System documentation enforces decision discipline by ensuring architectural decisions are falsifiable, ownership-bound, and well-annotated with switch criteria. This discipline integrates directly into phased planning to facilitate safer deployment and multi-year system alignment.

Can I use this for both greenfield design and system retrospection?

Yes, you can use this for both greenfield design and system retrospection. It facilitates the creation and validation of architectural documents, supporting new system builds while allowing existing systems to be retrofitted for improved accuracy and gap identification.

Do I need any specific dependencies to generate an architecture plan?

No specific dependencies are required to generate an architecture plan. You simply input your current system description, and the tool guides you through capturing architecture layers, decisions, and dependencies without needing external frameworks or libraries.

What are the limitations of relying on automated system documentation for complex architectures?

Automated system documentation does not replace human architectural validation but structures it. While it guides capturing layers and enforcing decision discipline, architects must still manually verify dependency mappings and switch criteria to ensure safer deployment planning.