architecture

Synthesize architectural decisions and persist constraints to docs/architecture.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecting complex software projects requires formal decisions to constrain downstream planning and implementation, preventing drift and misalignment.

Core Features & Use Cases

  • Silent mode coordinates recon and constraint embedding to steer the plan for MEDIUM changes.
  • Full mode orchestrates recon + domain specialists + lead architect for LARGE changes, producing persisted decisions and artifacts.
  • Artifacts and constraints are persisted to docs/architecture.md and the knowledge tier for reuse across projects.

Quick Start

Run the architecture skill on the current project to generate decisions and persist docs/architecture.md.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I synthesize architectural decisions to constrain downstream planning?▼

To synthesize architectural decisions for downstream planning, run the architecture Skill to coordinate recon, domain specialists, and a lead architect, producing final decision records and cross-domain constraints for DATA, STATE, UI, API, INFRA, and TEST.

What is the best way to prevent drift and misalignment in complex software projects?▼

Preventing drift and misalignment in complex software projects requires formal architectural decisions that constrain downstream implementation, coordinating cross-domain recon and domain specialists to produce persisted decision records.

How do I generate and persist an architecture artifact for my project?▼

You generate and persist an architecture artifact by running the architecture Skill on your current project, which synthesizes architectural decisions and saves the final output directly to docs/architecture.md for reuse across projects.

Does the architecture coordination mode change based on project size?▼

Yes, architecture coordination scales with project size: silent mode coordinates recon and constraint embedding for MEDIUM changes, while full orchestration coordinates recon, domain specialists, and a lead architect for LARGE changes.

When do I need formal architectural decision records for software changes?▼

You need formal architectural decision records when executing MEDIUM or LARGE changes that require cross-domain constraints across DATA, STATE, UI, API, INFRA, and TEST to prevent downstream implementation drift and misalignment.