Business Operations — Domain Orchestrator skill

Use when running, diagnosing, or designing internal business operations — process documentation, vendor SLAs, capacity planning, internal comms, SOP/runbook authoring, procurement spend.

by alirezarezvani·MIT license·★ 26,349 Stars on the repo·GitHub ↗

Use now

Files of Business Operations — Domain Orchestrator

alirezarezvani/main1 file shown
SKILL.md
Show the full text145 lines

Business Operations — Domain Orchestrator

The BizOps surface is internal: how the company actually runs. This orchestrator forks its conversation context, routes your inquiry to one of six sub-skills, then returns a tight digest to the parent thread. The heavy ingestion (vendor catalogs, process interviews, multi-doc SOP intake) stays in the forked context.

When to invoke

Symptom Sub-skill to route to
"Where does the work spend most of its time waiting?" process-mapper
"Is this vendor delivering against the SLA?" vendor-management
"Do we have enough people to ship in Q3?" capacity-planner
"I need to brief the company on a re-org" internal-comms
"Write me a runbook for the incident response process" knowledge-ops
"Why is our software spend up 40% YoY?" procurement-optimizer

Routing logic (deterministic)

The orchestrator classifies the inquiry by signals detected in the prompt. Two-signal threshold for confident routing; one-signal triggers a clarifying question.

Signal table
Signal class Keywords Sub-skill
PROCESS bottleneck, cycle time, waiting, handoff, BPMN, process map, workflow process-mapper
VENDOR vendor, supplier, SLA, contract, third-party, MSA, SaaS subscription, renewal vendor-management
CAPACITY headcount, capacity, utilization, planning, hiring sequence, FTE capacity-planner
COMMS all-hands, internal newsletter, announcement, change management, FAQ, town hall internal-comms
KNOWLEDGE SOP, runbook, knowledge base, wiki, playbook, documentation, onboarding doc knowledge-ops
PROCUREMENT spend, procurement, purchase, supplier rationalization, software audit, SaaS sprawl procurement-optimizer

If signals are mixed (e.g., "vendor SLA + spend audit"), run the highest-confidence sub-skill first, then chain into the second one in a follow-up forked turn.

Fallback

If no signal class scores ≥ 2, ask one clarifying question naming the two most likely candidates. Do NOT guess silently.

Workflow (Matt Pocock grill discipline)

Derived from Matt Pocock's grill-with-docs pattern: explore-then-ask, one question per turn with a recommended answer, walk the decision tree depth-first, track dependencies, anchor every challenge in the documented canon (references/).

Step 1 — Explore before asking

Before any clarifying question, check:

  • Does the user's working directory already contain a process map, vendor catalog, SOP, or org chart we can grep?
  • Does the inquiry already disambiguate the lane (e.g., "vendor SLA review" — that's vendor-management, no question needed)?
  • Is the lane unambiguous from filenames mentioned (procurement-Q3.csv → procurement)?

If the codebase resolves the lane, route silently. Don't ask.

Matt's rule: never bundle questions. Never default to "what do you think?". Always offer your recommendation.

Pattern:

Q1/1: [precise question naming the two candidate lanes]
Recommended: [Lane X, because <one-sentence rationale from the signal table>]

(Confirm, or override?)

Wait for the user's response. Then route. Never guess silently after a turn that asked a question.

Step 3 — Forking decision-tree walk (only if the inquiry crosses lanes)

If the user's inquiry legitimately crosses two lanes (e.g., "vendor SLA + spend audit" = VENDOR + PROCUREMENT), walk the tree depth-first:

  1. Resolve the higher-confidence lane first → run that sub-skill in forked context → return digest
  2. Ask: "Should we now run [second lane]? My recommendation: yes, because [dependency reason]."
  3. Only after explicit user confirmation, run the second sub-skill

Do NOT chain silently. Each fork is an explicit user-confirmed step.

Step 4 — Invoke sub-skill in forked context

Each sub-skill is invoked with the original prompt + a digest of any structured inputs (file paths, JSON inputs). The fork keeps heavy ingestion (vendor catalog, process transcripts, SOP source documents) out of the parent context.

Step 5 — Return digest with cited canon challenge

When the sub-skill completes, return a ≤ 200-word digest to the parent thread:

  • What was analyzed
  • Top 3 findings (each anchored in a reference doc citation — e.g., "Goldratt's Theory of Constraints: optimize the bottleneck, not the non-constraint")
  • Top 3 next actions (named owners if possible)
  • Path to the artifact(s) produced
  • One grill challenge for the user, cited: "Your value-add ratio is 12%. Lean canon (Womack & Jones 1996) classifies <15% as waste-heavy. What's blocking process redesign — political, technical, or budget?"

The parent agent can then ask follow-ups (each triggering new forked invocations).

Forcing-question library (grill-with-docs pattern)

When the user has provided enough context to enter a lane, the orchestrator may grill them on the decisions inside that lane before invoking the sub-skill. One question per turn, each with a recommended answer + canon citation. Examples:

  • PROCESS lane: "Before mapping: do you have measured cycle times per stage, or only estimates? Recommended: insist on measured data for the top-3 longest stages. Anti-pattern (Goldratt 1984): map estimates, optimize the wrong constraint."
  • VENDOR lane: "Before scoring: what's your tier-1 criticality threshold — by spend ($X/year), or by operational dependency (revenue-blocking if vendor fails)? Recommended: operational dependency. Anti-pattern (Gartner TPRM): spend-only tiering misses critical low-spend vendors like the HVAC vendor in the Target breach."
  • CAPACITY lane: "Before modeling: are you planning for utilization or throughput? Recommended: throughput (Little's Law). Anti-pattern (DORA): planning for utilization > 80% destroys throughput via queueing."

Never run a sub-skill until the lane-defining decision is locked.

Assumptions

  1. The user is acting on behalf of an organization with ≥ 10 employees (smaller orgs don't need this surface).
  2. The user has access to the data the sub-skill needs (process docs, vendor list, spend export, etc.) — or accepts the skill's templated dummy data.
  3. The user wants deterministic, repeatable analysis over LLM-flavored prose. Every sub-skill ships stdlib-only Python tools.

Non-goals

  • Not a substitute for an ERP, vendor management platform (Vendr, Tropic), or capacity-planning SaaS (Float, Runn).
  • Does not store state across sessions — every invocation is self-contained.
  • Does not call external APIs from Python tools (stdlib only, by design).

Distinct from

  • business-growth/* — that's the external sales motion (CSM, sales engineering, RevOps). BizOps is internal.
  • c-level-advisor/coo-advisor — that's strategic COO judgment ("should we restructure?"). BizOps is tactical ("here's the process map with bottlenecks").
  • engineering/slo-architect — that's system reliability with SLO/SLI/error budgets. process-mapper is business process reliability, not system reliability.
  • engineering/llm-wiki — that's a personal PKM (Karpathy's pattern). knowledge-ops is company-wide SOP authoring.

Output artifacts

Every sub-skill produces at least one artifact (markdown, CSV, or JSON) saved to the user's working directory. The orchestrator surfaces the file path in the digest.

Anti-patterns (do not)

  • ❌ Run all 6 sub-skills "to be thorough" — pick one based on signal, return digest, let user chain
  • ❌ Auto-approve a vendor or process change — surface findings; the human decides
  • ❌ Edit production process docs without asking — write to a new file, propose the diff
  • ❌ Skip the digest step — parent context needs ≤ 200-word digest, not the full sub-skill output

References

  • See c-level-advisor/coo-advisor for strategic COO framing
  • Path-B build pattern: documentation/implementation/bizops-commercial-expansion-plan.md
1---
2name: business-operations-skills
3description: Use when running, diagnosing, or designing internal business operations — process documentation, vendor SLAs, capacity planning, internal comms, SOP/runbook authoring, procurement spend. Triggers on "BizOps review", "where's the bottleneck", "vendor health", "internal SOP", "all-hands deck", "spend categorization", "capacity for Q3", "process mapping". Forks context to route to one of six BizOps sub-skills (process-mapper, vendor-management, capacity-planner, internal-comms, knowledge-ops, procurement-optimizer) and returns a digest. Distinct from business-growth (external sales motion) and c-level-advisor (strategic, not operational).
4context: fork
5version: 2.8.0
6author: claude-code-skills
7license: MIT
8tags: [bizops, operations, process, vendor, capacity, sop, procurement, coo, orchestrator]
9compatible_tools: [claude-code, codex-cli, cursor, antigravity, opencode, gemini-cli]
10---
11 
12# Business Operations — Domain Orchestrator
13 
14The BizOps surface is **internal**: how the company actually runs. This orchestrator forks its conversation context, routes your inquiry to one of six sub-skills, then returns a tight digest to the parent thread. The heavy ingestion (vendor catalogs, process interviews, multi-doc SOP intake) stays in the forked context.
15 
16## When to invoke
17 
18| Symptom | Sub-skill to route to |
19|---|---|
20| "Where does the work spend most of its time waiting?" | `process-mapper` |
21| "Is this vendor delivering against the SLA?" | `vendor-management` |
22| "Do we have enough people to ship in Q3?" | `capacity-planner` |
23| "I need to brief the company on a re-org" | `internal-comms` |
24| "Write me a runbook for the incident response process" | `knowledge-ops` |
25| "Why is our software spend up 40% YoY?" | `procurement-optimizer` |
26 
27## Routing logic (deterministic)
28 
29The orchestrator classifies the inquiry by **signals** detected in the prompt. Two-signal threshold for confident routing; one-signal triggers a clarifying question.
30 
31### Signal table
32 
33| Signal class | Keywords | Sub-skill |
34|---|---|---|
35| **PROCESS** | bottleneck, cycle time, waiting, handoff, BPMN, process map, workflow | `process-mapper` |
36| **VENDOR** | vendor, supplier, SLA, contract, third-party, MSA, SaaS subscription, renewal | `vendor-management` |
37| **CAPACITY** | headcount, capacity, utilization, planning, hiring sequence, FTE | `capacity-planner` |
38| **COMMS** | all-hands, internal newsletter, announcement, change management, FAQ, town hall | `internal-comms` |
39| **KNOWLEDGE** | SOP, runbook, knowledge base, wiki, playbook, documentation, onboarding doc | `knowledge-ops` |
40| **PROCUREMENT** | spend, procurement, purchase, supplier rationalization, software audit, SaaS sprawl | `procurement-optimizer` |
41 
42If signals are mixed (e.g., "vendor SLA + spend audit"), run the **highest-confidence sub-skill first**, then chain into the second one in a follow-up forked turn.
43 
44### Fallback
45 
46If no signal class scores ≥ 2, ask **one** clarifying question naming the two most likely candidates. Do NOT guess silently.
47 
48## Workflow (Matt Pocock grill discipline)
49 
50Derived from Matt Pocock's `grill-with-docs` pattern: **explore-then-ask, one question per turn with a recommended answer, walk the decision tree depth-first, track dependencies, anchor every challenge in the documented canon** (`references/`).
51 
52### Step 1 — Explore before asking
53 
54Before any clarifying question, check:
55- Does the user's working directory already contain a process map, vendor catalog, SOP, or org chart we can grep?
56- Does the inquiry already disambiguate the lane (e.g., "vendor SLA review" — that's `vendor-management`, no question needed)?
57- Is the lane unambiguous from filenames mentioned (`procurement-Q3.csv` → procurement)?
58 
59If the codebase resolves the lane, **route silently**. Don't ask.
60 
61### Step 2 — If still ambiguous, ONE forcing question with a recommended answer
62 
63Matt's rule: never bundle questions. Never default to "what do you think?". Always offer your recommendation.
64 
65Pattern:
66```
67Q1/1: [precise question naming the two candidate lanes]
68Recommended: [Lane X, because <one-sentence rationale from the signal table>]
69 
70(Confirm, or override?)
71```
72 
73Wait for the user's response. **Then** route. Never guess silently after a turn that asked a question.
74 
75### Step 3 — Forking decision-tree walk (only if the inquiry crosses lanes)
76 
77If the user's inquiry legitimately crosses two lanes (e.g., "vendor SLA + spend audit" = VENDOR + PROCUREMENT), walk the tree **depth-first**:
78 
791. Resolve the higher-confidence lane first → run that sub-skill in forked context → return digest
802. Ask: "Should we now run [second lane]? My recommendation: yes, because [dependency reason]."
813. Only after explicit user confirmation, run the second sub-skill
82 
83Do NOT chain silently. Each fork is an explicit user-confirmed step.
84 
85### Step 4 — Invoke sub-skill in forked context
86 
87Each sub-skill is invoked with the original prompt + a digest of any structured inputs (file paths, JSON inputs). The fork keeps heavy ingestion (vendor catalog, process transcripts, SOP source documents) out of the parent context.
88 
89### Step 5 — Return digest with cited canon challenge
90 
91When the sub-skill completes, return a **≤ 200-word digest** to the parent thread:
92 
93- What was analyzed
94- Top 3 findings (each anchored in a reference doc citation — e.g., "Goldratt's Theory of Constraints: optimize the bottleneck, not the non-constraint")
95- Top 3 next actions (named owners if possible)
96- Path to the artifact(s) produced
97- **One grill challenge** for the user, cited: "Your value-add ratio is 12%. Lean canon (Womack & Jones 1996) classifies <15% as waste-heavy. What's blocking process redesign — political, technical, or budget?"
98 
99The parent agent can then ask follow-ups (each triggering new forked invocations).
100 
101## Forcing-question library (grill-with-docs pattern)
102 
103When the user has provided enough context to enter a lane, the orchestrator may grill them on the **decisions inside that lane** before invoking the sub-skill. One question per turn, each with a recommended answer + canon citation. Examples:
104 
105- **PROCESS lane**: "Before mapping: do you have measured cycle times per stage, or only estimates? Recommended: insist on measured data for the top-3 longest stages. Anti-pattern (Goldratt 1984): map estimates, optimize the wrong constraint."
106- **VENDOR lane**: "Before scoring: what's your tier-1 criticality threshold — by spend ($X/year), or by operational dependency (revenue-blocking if vendor fails)? Recommended: operational dependency. Anti-pattern (Gartner TPRM): spend-only tiering misses critical low-spend vendors like the HVAC vendor in the Target breach."
107- **CAPACITY lane**: "Before modeling: are you planning for utilization or throughput? Recommended: throughput (Little's Law). Anti-pattern (DORA): planning for utilization > 80% destroys throughput via queueing."
108 
109Never run a sub-skill until the lane-defining decision is locked.
110 
111## Assumptions
112 
1131. The user is acting on behalf of an organization with ≥ 10 employees (smaller orgs don't need this surface).
1142. The user has access to the data the sub-skill needs (process docs, vendor list, spend export, etc.) — or accepts the skill's templated dummy data.
1153. The user wants **deterministic, repeatable analysis** over LLM-flavored prose. Every sub-skill ships stdlib-only Python tools.
116 
117## Non-goals
118 
119- Not a substitute for an ERP, vendor management platform (Vendr, Tropic), or capacity-planning SaaS (Float, Runn).
120- Does not store state across sessions — every invocation is self-contained.
121- Does not call external APIs from Python tools (stdlib only, by design).
122 
123## Distinct from
124 
125- **`business-growth/*`** — that's the **external sales motion** (CSM, sales engineering, RevOps). BizOps is **internal**.
126- **`c-level-advisor/coo-advisor`** — that's strategic COO judgment ("should we restructure?"). BizOps is tactical ("here's the process map with bottlenecks").
127- **`engineering/slo-architect`** — that's system reliability with SLO/SLI/error budgets. `process-mapper` is **business process** reliability, not system reliability.
128- **`engineering/llm-wiki`** — that's a **personal** PKM (Karpathy's pattern). `knowledge-ops` is **company-wide** SOP authoring.
129 
130## Output artifacts
131 
132Every sub-skill produces at least one artifact (markdown, CSV, or JSON) saved to the user's working directory. The orchestrator surfaces the file path in the digest.
133 
134## Anti-patterns (do not)
135 
136- ❌ Run all 6 sub-skills "to be thorough" — pick one based on signal, return digest, let user chain
137- ❌ Auto-approve a vendor or process change — surface findings; the human decides
138- ❌ Edit production process docs without asking — write to a new file, propose the diff
139- ❌ Skip the digest step — parent context needs ≤ 200-word digest, not the full sub-skill output
140 
141## References
142 
143- See `c-level-advisor/coo-advisor` for strategic COO framing
144- Path-B build pattern: `documentation/implementation/bizops-commercial-expansion-plan.md`
145 

Discussion

Alternatives