architecture

Identify and formalize architecture decisions and patterns for complex codebases.

1|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ormastes/simple --skill architecture-ormastes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/ormastes/simple/tree/main/.codex/skills/architecture
Command: npx skills add https://github.com/ormastes/simple --skill architecture-ormastes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codex architecture skill helps teams identify and formalize architecture decisions and patterns for complex codebases, enabling consistent design practices and traceable ADR generation.

Core Features & Use Cases

  • MDSOC pattern guidance — apply virtual capsules, feature transforms, adapters, and weaving to organizational architectures.
  • Module structure evaluation — assess cohesion, coupling, and layering across repo components to improve maintainability.
  • ADR writing and documentation — produce structured architecture decision records and related notes in doc/04_architecture.

Quick Start

Analyze the current codebase architecture and draft ADRs for notable decisions.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I generate ADRs for an existing complex codebase?▼

To generate ADRs for a complex codebase, you can analyze the current module structure and formalize notable architecture decisions into structured records within doc/04_architecture.

What is the MDSOC pattern and how does it apply to architecture evaluation?▼

MDSOC patterns guide architecture evaluation by applying virtual capsules, feature transforms, adapters, and weaving to organizational architectures to ensure consistent design practices.

How do I assess module structure for cohesion and coupling across repository components?▼

You can assess module structure by evaluating cohesion, coupling, and layering across repository components to improve maintainability and formalize architectural patterns.

Can I use this for architecture planning across large repositories?▼

Yes, architecture evaluation and ADR planning can be applied across large repositories to produce structured documentation, reference guidance, and consistent architecture planning.

What is the best way to document architecture decisions consistently?▼

The best way to document architecture decisions consistently is by producing structured architecture decision records and related notes directly in the doc/04_architecture directory.

When do I need to formalize architecture patterns for refactoring?▼

You need to formalize architecture patterns during refactoring when you must identify existing decisions, apply MDSOC patterns, and ensure traceable architecture generation across complex codebases.