skills/stakeholders-org-design/SKILL.md
Provides frameworks for mapping stakeholder influence networks, designing team structures aligned with system architecture (Conway's Law), defining team interface contracts (APIs, SLAs, decision rights), and assessing capability maturity (DORA, CMMC, agile models). Use when designing org structure or team topologies, mapping stakeholders for change initiatives, defining team interfaces, assessing capability maturity, planning restructures, or when user mentions org design, team structure, stakeholder map, Conway's Law, or RACI.
npx skillsauth add lyndonkl/claude stakeholders-org-designInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Copy this checklist and track your progress:
Org Design Progress:
- [ ] Step 1: Map stakeholders and influence
- [ ] Step 2: Define team structure and boundaries
- [ ] Step 3: Specify team interfaces and contracts
- [ ] Step 4: Assess capability maturity
- [ ] Step 5: Create transition plan with governance
Step 1: Map stakeholders and influence
Identify all stakeholders, categorize by power-interest, map influence networks. See Stakeholder Mapping for power-interest matrix and RACI frameworks.
Step 2: Define team structure and boundaries
Design teams aligned with architecture and strategy. For straightforward restructuring → Use resources/template.md. For complex org design with Conway's Law → Study resources/methodology.md.
Step 3: Specify team interfaces and contracts
Define APIs, SLAs, handoff protocols, decision rights between teams. See Team Interface Contracts for contract patterns.
Step 4: Assess capability maturity
Evaluate current state using maturity models (DORA, CMMC, custom). See Capability Maturity for assessment frameworks.
Step 5: Create transition plan with governance
Define migration path, decision rights, review cadence. Self-check using resources/evaluators/rubric_stakeholders_org_design.json. Minimum standard: Average score ≥ 3.5.
| Quadrant | Engagement | Example | |----------|------------|---------| | High Power, High Interest | Manage Closely (frequent communication) | Executive sponsor, product owner | | High Power, Low Interest | Keep Satisfied (status updates) | CFO for tech project, legal | | Low Power, High Interest | Keep Informed (engage for feedback) | Individual contributors, early adopters | | Low Power, Low Interest | Monitor (minimal engagement) | Peripheral teams |
Identify: Champions (advocates), Blockers (resistors), Bridges (connectors), Gatekeepers (control access) Map: Who influences whom? Formal vs informal power, trust relationships, communication patterns
Specify: Endpoints, data format/schemas, authentication, rate limits, versioning/backward compatibility Example: Service: User Auth API | Owner: Identity Team | Endpoints: /auth/login, /auth/token | SLA: 99.95% uptime, <100ms p95
Define: Availability (99.9%, 99.99%), Performance (p50/p95/p99 latency), Support response times (critical: 1hr, high: 4hr, medium: 1 day), Capacity (requests/sec, storage)
Design → Engineering: Specs, prototype, design review sign-off | Engineering → QA: Feature complete, test plan, staging | Engineering → Support: Docs, runbook, training | Research → Product: Findings, recommendations, prototypes
D - Driver (orchestrates), A - Approver (exactly one), C - Contributors (input), I - Informed (notified) Examples: Architectural (Tech Lead approves, Architects contribute) | Hiring (Hiring Manager approves, Interviewers contribute) | Roadmap (PM approves, Eng/Design/Sales contribute)
| Metric | Elite | High | Medium | Low | |--------|-------|------|--------|-----| | Deployment Frequency | Multiple/day | Weekly-daily | Monthly-weekly | <Monthly | | Lead Time | <1 hour | <1 day | 1 week-1 month | >1 month | | MTTR | <1 hour | <1 day | 1 day-1 week | >1 week | | Change Failure Rate | 0-15% | 16-30% | 31-45% | >45% |
Level 1 Initial: Unpredictable, reactive | Level 2 Repeatable: Basic PM | Level 3 Defined: Documented, standardized | Level 4 Measured: Data-driven | Level 5 Optimizing: Continuous improvement
Template: Capability Name | Current Level (1-5 with evidence) | Target Level | Gap | Action Items
Pattern 1: Functional → Product Teams (Spotify Model)
Pattern 2: Platform Team Extraction
Pattern 3: Embedded vs Centralized Specialists
Pattern 4: Conway's Law Alignment
Pattern 5: Team Topologies (4 Fundamental Types)
Conway's Law is inevitable:
Team size limits:
Cognitive load per team:
Interface ownership clarity:
Avoid matrix hell:
Stakeholder fatigue:
Maturity assessment realism:
Resources:
5-Step Process: Map Stakeholders → Define Teams → Specify Interfaces → Assess Maturity → Transition Plan
Stakeholder Mapping: Power-Interest Matrix (High/Low × High/Low), RACI (Responsible/Accountable/Consulted/Informed), Influence Networks
Team Interfaces: API contracts, SLAs (availability/performance/support), handoff protocols, decision rights (DACI/RAPID)
Maturity Models: DORA (deployment frequency, lead time, MTTR, change failure rate), Generic CMM (5 levels), Custom assessments
Team Types: Stream-Aligned (product), Platform (internal products), Enabling (capability building), Complicated-Subsystem (specialists)
Guardrails: Conway's Law, team size (2-pizza, Dunbar), cognitive load limits, interface ownership clarity, avoid matrix hell
testing
--- name: advisory-edit description: A strict advisory-only editing discipline for a writer who dictates ("speaks out") essays and wants help WITHOUT having their voice changed. The editor directs structure, flags grammar, and suggests strategic language — but never modifies the writer's text unless the writer explicitly says "apply" / "make that change" / "rewrite this." Produces a line-referenced, suggestion-only critique where every item is marked the writer's call. Four passes: structural, l
testing
Provides the house style for analyst-grade strategist writing — third-person register with sparing first-person, no em dashes, no "not X, not Y, not Z" negation cascades, numbered footnote citations rather than inline source parentheticals, specific opinion-signaling phrases, and topic-forward paragraph structure modeled on voice patterns observed in Damodaran's Musings on Markets and Thompson's Stratechery. Use when consolidating working notes into a finished long-form strategist or analyst report that must read as written by a senior human analyst rather than an AI assistant.
testing
Renders a markdown report to a PDF using pandoc with xelatex (11pt serif body, 1-inch margins, numbered footnotes, formal heading hierarchy). Requires a one-time install of pandoc and a LaTeX engine on the user's machine — basictex on macOS or texlive-xetex on Linux. Does not attempt automatic install. Fails loudly with the exact install commands if pandoc or xelatex is missing on the user's PATH. Use when producing a finished strategist or analyst report PDF from a polished markdown source.
testing
Produces step-by-step computational walkthroughs of vector and matrix operations as a sequence of numbered "frames", showing the explicit state at each step. The text-equivalent of a 3Blue1Brown animation — each frame shows what changed and why, so the learner can re-trace the operation by hand. Use when the learner needs to *see* a computation unfold (eigenvalue computation, attention with 3 tokens, gradient descent step, SVD on a 2×2, layer norm on a 3-vector, softmax of a small input), when an explanation has been given but the learner needs to ground it in a worked example, or when introducing an operation that's intimidating in symbol form but trivial in pencil-and-paper form.