Source profileQuality 94/100

event4u-app/agent-config/src/skills/org-design/SKILL.md

org-design

Use when shaping team structure — functional vs squad, span-of-control, reorg cost, Conway-aware boundaries. Triggers on 'should we reorg', 'how do we split this team'.

Source repository stars
9
Declared platforms
0
Static risk flags
0
Last source update
2026-08-28
Source checked
2026-08-28

Decision brief

What it does: where it fits

Triggers on 'should we reorg', 'how do we split this team'.

Best for

  • Team shape is becoming a bottleneck — handoffs are slow, decisions stall, the same conversations repeat across teams — and the question is what structure unblocks.
  • A reorg is being proposed (often for a different stated reason) and the question is what does this actually buy and what does it cost.
  • A new product line, segment, or geography is being added and the question is fold it into existing teams vs spin a new team vs embed people across teams.

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/event4u-app/agent-config --skill "src/skills/org-design"
Safe inspection promptEditorial

Inspect the Agent Skill "org-design" from https://github.com/event4u-app/agent-config/blob/6a5670b7881a676c0da90d2afb950298087c4ccb/src/skills/org-design/SKILL.md at commit 6a5670b7881a676c0da90d2afb950298087c4ccb. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Procedure

    Most "we need to reorg" requests are misdiagnosed. Run three checks first:

    Is the symptom a structure problem, a leadership problem, or a strategy problem? Reorgs solve only the first; the other two get worse with structural churn.Has the bottleneck been named with file:line precision? (which decision, which handoff, which dependency, which role). Un-named bottlenecks = no real constraint identified.Has the smallest local fix been tried? (move one role, redraw one boundary, add one decision-rights doc). A reorg is the heaviest tool; reach for it last.
  2. 02

    Step 0: Identify the real problem before redesigning anything

    Most "we need to reorg" requests are misdiagnosed. Run three checks first:

    Is the symptom a structure problem, a leadership problem, or a strategy problem? Reorgs solve only the first; the other two get worse with structural churn.Has the bottleneck been named with file:line precision? (which decision, which handoff, which dependency, which role). Un-named bottlenecks = no real constraint identified.Has the smallest local fix been tried? (move one role, redraw one boundary, add one decision-rights doc). A reorg is the heaviest tool; reach for it last.
  3. 03

    Step 1: Frame the structural options honestly

    Four canonical shapes; each has trade-offs:

    Functional — eng, design, PM, ops as separate orgs. Best for: deep specialisation, small co, shared platform. Cost: cross-functional handoff overhead.Cross-functional squad — eng + design + PM bundled per product area. Best for: product-led shipping cadence, autonomous outcomes. Cost: duplicated capability, harder craft-leveling.Matrix — functional reporting + squad allocation. Best for: balancing specialisation and outcome ownership. Cost: dual-reporting confusion, decision ambiguity.
  4. 04

    Step 2: Read Conway, both directions

    For the option in scope, draw the implied future architecture:

    Which interfaces become team-boundary interfaces? (these calcify as contracts).Which integrations cross team boundaries? (these slow down, gain meetings, accrete bureaucracy).Is the implied architecture the architecture we want? If yes, the structure is honest; if no, redraw.
  5. 05

    Step 3: Span-of-control and decision-rights audit

    For each manager / lead in the proposed shape:

    Span — how many direct reports. 7 is high-cost coaching; <4 is over-managed. Target 5–7 for engineering; varies for ops / design.Depth — layers between IC and CEO. Above 4 layers in a sub-150 org = excess.Decision rights — what does this role own vs need approval for? Un-named decision rights = stalls.

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score94/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars9SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
event4u-app/agent-config
Skill path
src/skills/org-design/SKILL.md
Commit
6a5670b7881a676c0da90d2afb950298087c4ccb
License
MIT
Collected
2026-08-28
Default branch
main
View the original SKILL.md

org-design

When to use

  • Team shape is becoming a bottleneck — handoffs are slow, decisions stall, the same conversations repeat across teams — and the question is what structure unblocks.
  • A reorg is being proposed (often for a different stated reason) and the question is what does this actually buy and what does it cost.
  • A new product line, segment, or geography is being added and the question is fold it into existing teams vs spin a new team vs embed people across teams.

Do NOT use as a hiring-plan substitute (route to forthcoming hiring-loop / comp skills for headcount and band shape), as a performance / individual-feedback surface (route to Q4 perf-feedback-craft), or for org-chart software / HRIS configuration.

Cognition cluster

  • Mental model — Theory of constraints. Org bottlenecks live in one or two places at a time; reorging everywhere else is theatre. Find the constraint (decision queue, dependency hub, single-threaded role), reshape around it, leave the rest. See mental-models.md.
  • Mental model — Conway's law. Systems mirror the communication structure that shipped them. If two services must integrate cleanly, the two teams must communicate cleanly. Org boundary = future architecture boundary. Use the inverse: pick the architecture you want, then draw the org to match.
  • Mental model 28 — Inversion. "What problem does the proposed structure prevent us from solving?" Every structure trades one class of problem for another. The honest question is which trade is acceptable, not which structure is best.
  • Mental model 26 — Optionality. Reorgs cost 3–6 months of throughput; the reorg is worth it only if the new shape preserves more optionality than the old shape forecloses. Reorging for short-term symptoms usually destroys optionality.
  • Context-spine — org-stage + product + customer-segment. Read org-stage for which problems are real (10-person co: structure barely matters; 50-person co: functional silos start; 150-person co: span-of-control breaks; 500+: Conway dominates). Read product for natural boundaries (modular product = squads work; tightly-coupled product = functional teams work better). Read customer-segment for whether segment-aligned teams pay off.

Cross-wing handoff

  • Composes P1 build-buy-partner for the insource-vs-outsource shape that affects whether a capability needs a team at all.
  • Hands off to Q2 comp-banding for the level / band design that the new shape implies.
  • Hands off to Q3 onboarding-program for the time-to-productivity shape that the new structure requires.
  • Hands off to S-block EM skills for the team-level mechanics within the chosen structure.

Procedure

Step 0: Identify the real problem before redesigning anything

Most "we need to reorg" requests are misdiagnosed. Run three checks first:

  1. Is the symptom a structure problem, a leadership problem, or a strategy problem? Reorgs solve only the first; the other two get worse with structural churn.
  2. Has the bottleneck been named with file:line precision? (which decision, which handoff, which dependency, which role). Un-named bottlenecks = no real constraint identified.
  3. Has the smallest local fix been tried? (move one role, redraw one boundary, add one decision-rights doc). A reorg is the heaviest tool; reach for it last.

If checks 1–3 don't justify a structural change, route the request elsewhere and stop.

Step 1: Frame the structural options honestly

Four canonical shapes; each has trade-offs:

  1. Functional — eng, design, PM, ops as separate orgs. Best for: deep specialisation, small co, shared platform. Cost: cross-functional handoff overhead.
  2. Cross-functional squad — eng + design + PM bundled per product area. Best for: product-led shipping cadence, autonomous outcomes. Cost: duplicated capability, harder craft-leveling.
  3. Matrix — functional reporting + squad allocation. Best for: balancing specialisation and outcome ownership. Cost: dual-reporting confusion, decision ambiguity.
  4. Segment-aligned — teams own a customer segment end-to-end. Best for: deeply different segments with different jobs. Cost: code / platform divergence.

Hybrid shapes exist (squads inside functions; functional platforms under segment-aligned product teams); name them explicitly, don't hide them.

Step 2: Read Conway, both directions

For the option in scope, draw the implied future architecture:

  1. Which interfaces become team-boundary interfaces? (these calcify as contracts).
  2. Which integrations cross team boundaries? (these slow down, gain meetings, accrete bureaucracy).
  3. Is the implied architecture the architecture we want? If yes, the structure is honest; if no, redraw.

Inverse Conway: if the desired architecture has clean modules A, B, C, draw teams around A, B, C — not around skill specialisations that will fight the architecture.

Step 3: Span-of-control and decision-rights audit

For each manager / lead in the proposed shape:

  1. Span — how many direct reports. >7 is high-cost coaching; <4 is over-managed. Target 5–7 for engineering; varies for ops / design.
  2. Depth — layers between IC and CEO. Above 4 layers in a sub-150 org = excess.
  3. Decision rights — what does this role own vs need approval for? Un-named decision rights = stalls.
  4. Single-threaded role check — is there exactly one owner per significant outcome? (Amazon's STO principle).

Span and decision-rights gaps are usually the actual fix, not a wholesale restructure.

Step 4: Reorg cost sizing

For any structural change, name:

  1. Disruption window — 3–6 months of degraded throughput is typical for non-trivial reorgs. Larger structural changes can take 9–12 months to settle.
  2. Attrition risk — every reorg loses 5–15 % of impacted ICs to voluntary attrition; senior people more than juniors.
  3. Re-platforming cost — if Conway implies architecture change, the eng cost of that change.
  4. Customer-facing disruption — relationship continuity for account-aligned segments.

A reorg whose stated benefit is smaller than these costs = don't do it. Force the sizing before approving.

Step 5: Validate the org-design read before emitting

Before producing the artifact, verify three things:

  1. Real-problem confirmation — confirm Step 0 named the bottleneck with precision; un-named bottlenecks mean the reorg is theatre and must be re-run or abandoned.
  2. Trade-off honesty — assert each proposed shape names what it foreclose s, not just what it enables; structures sold as pure upside fail the check.
  3. Cost sizing present — verify Step 4 disruption / attrition / re-platforming / customer costs are sized in calendar units and % terms; un-sized reorgs are unrealistic and must be re-run.

All three must pass. If any fails, return to the failing step.

Step 6: Emit the org-design read

Produce the org-design artifact for the leadership decision-maker. The artifact frames the bottleneck, the candidate shapes, the Conway implications, the span / decision-rights audit, and the sized cost. The decision stays human.

Related Skills

WHEN to use this

  • Reorg proposals (real or implied).
  • Adding a new product line, segment, or geo and choosing fold-vs-spin-vs-embed.
  • Span-of-control / decision-rights audits.

WHEN NOT to use this

  • Hiring-plan / headcount shape — out of scope here; this skill answers what shape, hiring answers how many of each.
  • Performance / individual-feedback work — route to perf-feedback-craft (Q4).
  • Team-level engineering management — route to S-block EM skills.
  • Compensation banding — route to comp-banding (Q2).

When the agent should load this

  • "Should we reorg?"
  • "How do we split this team?"
  • "Functional vs squad?"
  • "Span-of-control read on engineering."
  • "Wie strukturieren wir das Team neu?"

Output

  1. bottleneck-diagnosis.md — named constraint, evidence, smallest-local-fix check.
  2. shape-options.md — candidate structures × what each enables × what each forecloses × Conway implications.
  3. span-and-decision-rights.md — manager span audit, decision-rights mapping, single-threaded-role check.
  4. reorg-cost-sizing.md — disruption window, attrition risk, re-platforming cost, customer-facing impact.

Gotcha

  • "We need a reorg" is usually a strategy or leadership problem in disguise. Diagnose first.
  • Conway's law cuts both ways — pick the architecture, draw the org. Don't pick the org and hope the architecture follows.
  • Matrix structures sound balanced and run terribly without explicit decision-rights docs.
  • Reorgs done in <6-month cycles destroy more value than they create; structural change is a multi-quarter commitment.

Do NOT

  • Do NOT propose a reorg as the first response to a velocity / quality complaint; smaller fixes usually exist.
  • Do NOT design a structure whose Conway-implied architecture you'd reject if drawn directly.
  • Do NOT skip the cost sizing; un-sized reorgs are wishful.

Runnable example

100-person SaaS, eng leadership claims "we need to move to squads because shipping is slow".

  • Step 0 — Diagnose: shipping-slow is the symptom; bottleneck inspection shows two PMs serving 8 engineers each, decision queue at the PM layer, not the eng-design boundary. Smallest local fix: hire 2 PMs. Reorg not yet justified.
  • Step 1 — Frame anyway as sanity check: functional vs cross-functional squad vs matrix.
  • Step 2 — Conway read: current platform is modular by domain (billing / scheduling / reporting); squad-by-domain is Conway-aligned; squad-by-customer-segment would fight architecture.
  • Step 3 — Span audit: VP Eng spans 9 direct reports (too wide); 1 EM has 11 reports (too wide); decision rights for "ship a public-API change" undefined.
  • Step 4 — Reorg cost sizing: 4-month throughput drop, 8–12 % attrition risk on senior eng who joined for current shape, no re-platforming needed.
  • Step 5 — Validate: bottleneck was misdiagnosed at the start; trade-off honest (squads cost shared-platform leveling); cost sizing present. Pass.
  • Step 6 — Emit org-design read: recommend (a) hire 2 PMs to clear the actual bottleneck, (b) shrink VP Eng span by promoting an Eng Director, (c) write decision-rights doc for public-API changes, (d) revisit squad question in 6 months with fresh data. Net: smallest-fix path beats reorg by a wide margin.

Frequently asked questions

What to verify before installation and use

What does the org-design source document cover?

Triggers on 'should we reorg', 'how do we split this team'.

How do I install org-design?

The source record exposes this install command: npx skills add https://github.com/event4u-app/agent-config --skill "src/skills/org-design". Inspect the command and pinned source before running it.

Alternatives

Compare before choosing

Computed 10045,960

coreyhaines31/marketingskills

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program

Computed 10045,960

coreyhaines31/marketingskills

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o

Computed 10014,706

prowler-cloud/prowler

postgresql-indexing

PostgreSQL indexing best practices for Prowler: index design, partial indexes, partitioned table indexing, EXPLAIN ANALYZE validation, concurrent operations, monitoring, and maintenance. Trigger: When creating or modifying PostgreSQL indexes, analyzing query performance with EXPLAIN, debugging slow queries, reviewing index usage statistics, reindexing, dropping indexes, or working with partitioned table indexes. Also trigger when discussing index strategies, partial indexes, or index maintenance

Computed 100147

oaustegard/claude-skills

featuring

Generate hierarchical _FEATURES.md files that describe what a codebase DOES from a user/consumer perspective, anchored to source symbols via tree-sitting. Supports large complex codebases through feature-driven decomposition into sub-feature files. Uses a multi-pass synthesis: orientation → detail → overview rewrite. Use when someone says "what does this do", "document features", "feature inventory", "_FEATURES.md", or needs to understand a codebase's purpose before modifying it. Complements tre