Conway Method

Use when working in a project that has a `.agents/` directory or when the user asks about Conway Architecture, the conway-architecture plugin, domain agents, owned_paths enforcement, or how to coordinate a persistent subagent team that shadows the application's architecture

5 stars 2 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add tilmon-engineering/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tilmon-engineering/claude-skills --skill conway-method
Manual install
git clone --depth 1 https://github.com/tilmon-engineering/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/plugins/conway-architecture/skills/conway-method ~/.claude/skills/conway-method

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Conway Architecture: the method

## Core idea

Conway's Law observes that **a system's architecture tends to resemble the communication structure of the team that built it**. Usually treated as a warning. Here, it's used as a tool: design the team you want, and let the architecture follow.

The team is a **persistent, domain-scoped subagent team**. Each domain owns a disjoint slice of the codebase, declared as path globs. The coordinator (the main session agent) routes work; the domain agents do the work. The boundaries are enforced by a `PreToolUse` hook, not just by convention.

## When to use

- The project has (or should have) a `.agents/` directory with per-domain `AGENTS.md` files.
- You are about to delegate work across domains and need to know who owns what.
- The user mentions "Conway", "the team", "domain agents", or asks why a write was blocked.
- You see hook denials mentioning "Conway:" — that's this method enforcing itself.

Skip when: the project has no `.agents/` directory. The plugin is a no-op there.

## Vocabulary

| Term | Meaning |
|---|---|
| **Coordinator** | The main session agent. Owns the roadmap, never edits domain-owned files. Identifiable in hook input by the *absence* of `agent_type`. |
| **Domain agent** | A teammate spawned via `Agent(team_name=…, name=<domain>, …)`. The `name` matches a directory under `.agents/`. Identifiable in hook input by `agent_type == <domain>`. |
Read the full skill on GitHub

Details

Skill name
conway-method
Path
plugins/conway-architecture/skills/conway-method/SKILL.md
License
MIT
Repo updated
22 May 2026

FAQ

What does the Conway Method skill do?

Use when working in a project that has a `.agents/` directory or when the user asks about Conway Architecture, the conway-architecture plugin, domain agents, owned_paths enforcement, or how to coordinate a persistent subagent team that shadows the application's architecture

How do I install the Conway Method skill?

Claude Code plugin: /plugin marketplace add tilmon-engineering/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Conway Method popular?

It lives in tilmon-engineering/claude-skills, which has 5 GitHub stars and 2 forks.

Related skills

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.