convention-conways-law

Map team boundaries to software modules and document ownership contracts.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill convention-conways-law
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convention-conways-law
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/reference/philosophy/laws/conways
Command: npx skills add https://github.com/sunLeee/optimization --skill convention-conways-law

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conway's Law states that the software architecture mirrors the organization's communication structure, which can cause alignment gaps when teams are not organized to reflect the desired system boundaries.

Core Features & Use Cases

  • Align team boundaries with modular boundaries to reduce integration overhead.
  • Define clear ownership and collaboration contracts to improve review cycles and accountability.
  • Use inverse Conway maneuvers to design teams around intended architecture or restructure architecture to reflect current teams.

Quick Start

Map your current team boundaries to software modules and document ownership contracts.

Frequently Asked Questions about convention-conways-law

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

FAQPage Schema
What is Conway's Law and how does it affect software architecture?

Conway's Law states that software architecture mirrors an organization's communication structure, causing alignment gaps when team boundaries do not reflect intended modular boundaries.

How do I align team boundaries with modular boundaries during a reorganization?

To align team boundaries with modular boundaries, map current team communication structures to software modules and establish explicit ownership contracts to enforce architectural alignment.

What is the inverse Conway maneuver and when should I use it?

The inverse Conway maneuver designs teams around the intended software architecture to minimize boundary misalignments. Use it during product development or organizational restructuring to reduce integration overhead.

How can ownership contracts improve software review cycles and accountability?

Defining clear ownership and collaboration contracts establishes explicit architectural boundaries, which improves review cycles and accountability by minimizing cross-team alignment gaps.

Does this approach work for teams undergoing organizational restructuring?

Yes, applying Conway's Law principles is specifically suited for teams undergoing organizational restructuring, product development, or reorganization to minimize boundary misalignments and integration overhead.

What are the limitations of aligning software design with team structure?

Aligning software design with team structure requires accurate mapping of communication paths to module boundaries; misaligned ownership contracts or rigid team structures can fail to reduce integration overhead.