janderscience-skills 0.0.0-stage → 1.0.0

package/sources/headcount/README.md

@@ -0,0 +1,506 @@
+<h1 align="center">headcount</h1>
+
+<p align="center"><b>Add a department, not a prompt.</b></p>
+
+<p align="center">
+  <a href="AGENTS.md"><img alt="Runs in Claude Code and ChatGPT" src="https://img.shields.io/badge/runs%20in-Claude%20Code%20%C2%B7%20ChatGPT-D97757?style=flat-square"></a>
+  <img alt="16 departments" src="https://img.shields.io/badge/departments-16-3F4B5B?style=flat-square">
+  <img alt="172 skills" src="https://img.shields.io/badge/skills-172-3F4B5B?style=flat-square">
+  <a href="docs/SOURCES.md"><img alt="184 cited sources" src="https://img.shields.io/badge/cited%20sources-184-3F4B5B?style=flat-square"></a>
+  <a href="LICENSE"><img alt="MIT licensed" src="https://img.shields.io/badge/license-MIT-3F4B5B?style=flat-square"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/cbrock84/headcount/actions/workflows/checks.yml"><img alt="Checks" src="https://img.shields.io/github/actions/workflow/status/cbrock84/headcount/checks.yml?style=flat-square&label=checks"></a>
+  <a href="https://github.com/cbrock84/headcount/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/cbrock84/headcount?style=flat-square&color=3F4B5B"></a>
+  <a href="https://github.com/cbrock84/headcount/graphs/contributors"><img alt="Contributors" src="https://img.shields.io/github/contributors/cbrock84/headcount?style=flat-square&color=3F4B5B"></a>
+  <img alt="Last commit" src="https://img.shields.io/github/last-commit/cbrock84/headcount?style=flat-square&color=3F4B5B">
+  <img alt="Visitors" src="https://visitor-badge.laobi.icu/badge?page_id=cbrock84.headcount&title=visitors&color=3F4B5B">
+  <a href="CONTRIBUTING.md"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-2EA043?style=flat-square"></a>
+</p>
+
+<p align="center">
+  <a href="https://cbrock84.github.io/headcount/org-chart.html">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/org-chart-dark.png">
+      <img alt="The headcount org chart — 16 departments, 172 skills, searchable" src="docs/assets/org-chart-light.png" width="840">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://cbrock84.github.io/headcount/org-chart.html"><b>Open the interactive org chart</b></a> — search every skill, open a department, jump to the source.
+</p>
+
+An agent organization structured as a company: a chief executive over
+16 departments, 172 skills in total.
+
+Every department is an independently installable plugin, so a project loads only the functions it
+needs rather than all of them at once.
+
+## Install
+
+**[Claude Code](https://claude.com/claude-code)**
+
+```
+/plugin marketplace add cbrock84/headcount
+/plugin install security@headcount
+```
+
+**ChatGPT and Codex** — the same repository. Add it as a plugin marketplace, or drop the
+department you want into `.agents/skills/` in your own project.
+
+The skills are identical in both; only the manifests differ, and both sets are generated from
+this tree, so a fix reaches both at once. See `AGENTS.md`.
+
+Install as many departments as the project needs. Skills are addressed as `department:skill` —
+`security:threat-modeling`, `finance:unit-economics` — so names never collide.
+
+## Use
+
+Skills load themselves when a request matches. Ask a question in the department's territory and the
+right specialist engages:
+
+| You ask | What loads |
+|---|---|
+| "why isn't this landing page converting?" | `demand-generation:landing-page-cro-expert` |
+| "review this design before we build it" | `security:threat-modeling` |
+| "can we afford this hire?" | `finance:unit-economics` |
+| "our growth has stalled" | `executive:business-growth-consultant` |
+
+Invoke one directly by name when you want a specific lens: `/finance:financial-modeling`.
+
+New to this? [docs/GETTING-STARTED.md](docs/GETTING-STARTED.md) covers which departments to
+install first, the three ways to invoke a skill, and what reviewer-class departments do
+differently.
+
+Eleven situations that cross departments — a SOC 2 demand from an enterprise prospect, a link
+down between two sites, a renewal that auto-renewed because nobody owned the date — are worked
+through end to end in [docs/USE-CASES.md](docs/USE-CASES.md), including what comes back and
+where a reviewer-class department stops the work rather than adding an opinion.
+
+Each department also ships an agent charter in `.claude/agents/`, so a department can be delegated
+to as a subagent with its own exclusive write surface.
+
+## Departments
+
+<details>
+<summary><b>Office of the CEO</b> (Chief Executive) — 7 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `agent-hierarchy` | Designs orchestrator-and-subagent hierarchies for a repository — splitting agents by exclusive write surface, pairing every producer with an independent auditor, an…. |
+| `ai-research-analyst` | Produces executive-level research — market sizing, competitor mapping, trend analysis, and strategic intelligence — grounded in cited sources with the confidence in…. |
+| `business-growth-consultant` | Finds the single constraint currently limiting a business's growth and the highest-leverage moves against it, rather than producing a list of everything that could…. |
+| `ceo-advisor` | Pressure-tests a decision, plan, or idea before it is committed to — surfacing the assumption it rests on, the case against it, and what would have to be true for i…. |
+| `chief-executive` | Sets direction, allocates capital and attention, and makes the calls no one else can make. |
+| `fundraising-and-investor-relations` | Raises capital and manages the relationship afterward — deciding how much and why, understanding what dilution and preferences actually cost, running a process with…. |
+| `saas-idea-validator` | Evaluates a software or startup idea against problem, market, competition, monetization, defensibility, and execution, and returns a verdict rather than encourageme…. |
+
+</details>
+
+<details>
+<summary><b>Technology</b> (CTO / CIO) — 19 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `ai-workflow-architect` | Designs AI systems, automations, and agent workflows for a business — identifying which manual work is worth automating, how to structure the system, which tools fi…. |
+| `api-design` | Designs interfaces that survive their consumers — resource modeling, errors, versioning, pagination, and compatibility. |
+| `branch-and-worktree-workflow` | Isolates feature work in its own branch or worktree and integrates it cleanly when done. |
+| `chief-technology-officer` | Owns architecture, engineering delivery, infrastructure, data platform, and internal systems. |
+| `cloud-infrastructure` | Designs and runs cloud infrastructure — environments, infrastructure as code, networking and isolation, scaling, and cost. |
+| `code-review` | Conducts and responds to code review — reviewing a change for correctness, design, and risk, and evaluating review feedback received on your own work. |
+| `completion-verification` | Verifies that work is actually complete before it is claimed to be — running the checks, reading the output, and confirming the original request was satisfied rathe…. |
+| `data-migration` | Moves data from one system to another without losing it or corrupting it — profiling the source before mapping, deciding between big-bang and parallel-run cutover,…. |
+| `implementation-planning` | Turns a spec or requirement into a written plan a separate session or agent can execute, then drives that plan through review checkpoints. |
+| `observability-and-reliability` | Makes systems debuggable and reliably operable — instrumentation, alerting that is worth waking for, service objectives, and learning from failure. |
+| `parallel-agent-delivery` | Splits work across multiple agents or sessions running at once, keeping their surfaces disjoint so results merge cleanly. |
+| `prompt-optimizer` | Turns rough intent or a weak prompt into a reliable one — diagnosing why output is inconsistent, restructuring the instruction, and adapting it across models. |
+| `release-and-deployment` | Ships changes safely and often — pipelines, deployment strategies, feature flags, rollback, and database changes. |
+| `skill-authoring` | Writes and revises agent skills so they trigger at the right moments and give usable instruction when they do. |
+| `solution-architecture` | Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why. |
+| `solution-exploration` | Explores the problem and the range of possible approaches before any code is written — clarifying what is actually being asked, surfacing options with their tradeof…. |
+| `systematic-debugging` | Finds the root cause of a bug, test failure, or unexpected behavior before proposing any fix. |
+| `technical-debt-management` | Makes technical debt visible and decidable — distinguishing real debt from mess, quantifying its cost, and arguing for remediation in business terms. |
+| `test-driven-development` | Drives implementation by writing a failing test first, then the smallest code that passes it. |
+
+</details>
+
+<details>
+<summary><b>Security</b> (CISO) — 8 skills · **reviewer-class**</summary>
+
+| Skill | What it does |
+|---|---|
+| `access-and-identity` | Designs and audits who can reach what — authentication, authorization models, privileged access, service credentials, and joiner-mover-leaver process. |
+| `chief-information-security-officer` | Owns the security posture of the organization — architecture, program strategy, risk acceptance, incident command, and the authority to stop work that creates unacc…. |
+| `data-protection-and-encryption` | Protects data itself rather than the systems around it — classifying what you hold, encrypting in transit and at rest and understanding what each actually defends a…. |
+| `detection-and-monitoring` | Builds the capability to notice an attack in progress — deciding what to log and retain, centralizing it somewhere tamper-resistant, writing detections that fire on…. |
+| `incident-response` | Runs a security incident from detection to closure — triage, containment, investigation, communication, and the review afterward. |
+| `security-architecture-review` | Reviews a design or change for security before it ships — authentication and authorization, data handling, secrets, dependencies, and the secure-development practic…. |
+| `threat-modeling` | Identifies what could go wrong in a system before it is built or changed — the assets worth attacking, the entry points, the trust boundaries, and the controls that…. |
+| `vulnerability-management` | Runs the loop from discovering a weakness to confirming it is fixed — scanning, triage, prioritization by real exploitability, remediation tracking, and patch policy. |
+
+</details>
+
+<details>
+<summary><b>IT Operations</b> (CIO) — 12 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `backup-and-recovery` | Protects and restores data — backup coverage and scope, retention, immutability against ransomware, and proving restores actually work. |
+| `chief-information-officer` | The CIO's remit — running the technology the company works on, service quality, IT spend, and the boundary with product engineering. |
+| `cloud-administration` | Administers the cloud the company runs on rather than the one it sells — tenant and subscription structure, the SaaS estate and who owns each app, identity as the r…. |
+| `collaboration-platform-administration` | Administers the email, chat, meeting and file-sharing platform the organization runs on — tenant and domain configuration, mail authentication and routing, phishing…. |
+| `endpoint-management` | Manages laptops, desktops and mobile devices — enrollment, configuration, patching, software distribution, and lost or compromised devices. |
+| `identity-lifecycle-administration` | Executes joiner, mover and leaver processes — provisioning, group membership, access changes on role change, and complete deprovisioning. |
+| `it-asset-management` | Tracks hardware and software assets through their life — procurement, ownership, licensing, refresh, and disposal. |
+| `network-administration` | Designs and operates the corporate network — segmentation, remote access, wireless, DNS and addressing, and diagnosing network problems. |
+| `service-desk` | Runs the IT service desk — intake, triage, prioritization, escalation, knowledge, and the metrics that improve service rather than distort it. |
+| `systems-administration` | Runs servers and corporate systems — patching, configuration baselines, change control, capacity, and the routine that prevents incidents. |
+| `telephony-and-conferencing` | Runs voice and meeting infrastructure — phone systems and numbers, emergency calling obligations, conference rooms and their AV, call recording and its retention co…. |
+| `virtualization-operations` | Runs the hypervisor layer beneath the servers — host capacity and consolidation ratios, VM sprawl, snapshot discipline, resilience and live migration, and licensing…. |
+
+</details>
+
+<details>
+<summary><b>Product</b> (CPO) — 11 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `brand-identity` | Defines and applies visual brand — logo usage, palette, typography, imagery direction, and the guidelines that keep expression consistent across product and marketi…. |
+| `chief-product-officer` | Owns what gets built and why: product strategy, roadmap, discovery, user experience, and the definition of success for each release. |
+| `design-styles` | Applies a deliberate visual direction to an interface — minimalist editorial, industrial utilitarian, or high-polish commercial — each with its own type scale, pale…. |
+| `design-system` | Builds and maintains the design system a product is assembled from — tokens for color, type, spacing and elevation, component contracts, and the rules that keep the…. |
+| `interface-craft` | Raises the visual and interaction quality of an interface — layout, hierarchy, type, spacing, density, and the details that separate a considered product from a gen…. |
+| `interface-redesign` | Upgrades an existing interface to a higher standard without rebuilding it — auditing what is there, identifying what reads as generic or unfinished, and sequencing…. |
+| `presentation-design` | Designs slide decks and one-pagers that carry an argument rather than decorate one — deck structure, headlines that state the takeaway, charts that make a single po…. |
+| `product-discovery` | Finds out whether a problem is real and a solution would work, before building it — recruiting the right people, interviewing without leading them, separating what…. |
+| `product-requirements` | Writes down what is being built so a team can build it and know when they are done — problem and success measure before solution, scope stated by exclusion, user-vi…. |
+| `ux-product-auditor` | Audits a website, app, onboarding flow, or design for usability, conversion, and product problems, tying every finding to a business outcome and a severity. |
+| `visual-reference-generation` | Produces design reference imagery before implementation — screen concepts, layout directions, and flows for web or mobile that make a verbal brief concrete enough t…. |
+
+</details>
+
+<details>
+<summary><b>Marketing</b> (CMO) — 19 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `behavioral-marketing` | Applies decision science and cognitive bias research to marketing and product decisions — how people actually choose under uncertainty, and how framing, defaults, s…. |
+| `brand-voice` | Captures how a person or brand actually writes and turns it into reusable voice instructions every other content skill draws from. |
+| `chief-content-officer` | Runs content as an operation — the production pipeline, editorial calendar, repurposing engine, competitive content intelligence, and audits of what already exists. |
+| `chief-marketing-officer` | Owns brand, demand generation, content, communications, and how the market understands what the business does. |
+| `content-strategy` | Decides what content to make and why — topic territory, format mix, cadence, and how content connects to a business outcome rather than to traffic. |
+| `customer-research` | Plans, runs, and synthesizes customer research — interviews, surveys, win-loss analysis, and message testing — into findings that change decisions. |
+| `events-and-field-marketing` | Plans and runs events that produce pipeline — conferences, trade shows, webinars, field programs, and measuring whether any of it worked. |
+| `marketing-campaign-planner` | Designs a coordinated multi-channel campaign or product launch around one story — objective, message, channel sequencing, timeline, assets, and the checklist that g…. |
+| `marketing-copywriting` | Writes and edits marketing copy for any surface — homepage, product and pricing pages, ads, emails, and collateral — and sharpens existing copy that is not working. |
+| `marketing-planning` | Builds the marketing plan of record — objectives, channel mix, budget allocation, sequencing, and the measurement that says whether it worked. |
+| `newsletter-writer` | Writes and edits newsletters and marketing emails people actually open — subject lines, opening, structure, voice, and the conversion turn where there is one. |
+| `partnership-marketing` | Builds reach through other people's audiences — co-marketing partnerships, creator and influencer programs, and community building. |
+| `positioning-and-messaging` | Establishes what a product is understood to be, for whom, and instead of what — then turns that into the messaging every other surface inherits. |
+| `product-launch` | Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcemen…. |
+| `public-relations` | Plans and executes earned media — press strategy, journalist outreach, announcements, commentary, and crisis response. |
+| `social-post-craft` | Writes, structures, and evaluates social posts end to end — hooks, body, formatting for how each platform renders, and a quality check before publishing. |
+| `video-content` | Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. |
+| `visual-content` | Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts…. |
+| `youtube-producer` | Plans, packages, and scripts long-form video for retention and channel growth — idea selection, titles and thumbnails, script structure, and diagnosing why a video…. |
+
+</details>
+
+<details>
+<summary><b>Demand Generation</b> (CMO) — 12 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `account-based-marketing` | Concentrates marketing and sales effort on a named set of accounts rather than on volume — qualifying whether the model fits your economics at all, building the acc…. |
+| `ai-search-optimization` | Optimizes for AI assistants and AI-generated answers — being retrievable, being cited, and being represented accurately when a model answers on your behalf. |
+| `app-store-optimization` | Improves visibility and conversion in the App Store and Google Play — metadata, keywords, screenshots, ratings, and the listing experience that turns an impression…. |
+| `experimentation` | Designs, runs, and reads A/B tests and growth experiments — hypothesis, sample size, duration, and honest interpretation. |
+| `landing-page-cro-expert` | Audits and rewrites landing pages, homepages, and sales pages to increase conversion — diagnosing why a page is not converting, rewriting headlines, hero copy and c…. |
+| `lead-capture` | Converts anonymous traffic into known contacts — lead magnets, gated content, free tools, popups, and the forms behind them. |
+| `lifecycle-messaging` | Designs automated email and SMS programs — welcome and onboarding sequences, nurture, re-engagement, transactional messaging, and the timing and segmentation behind…. |
+| `listing-distribution` | Gets a product listed where buyers and crawlers look — directories, marketplaces, review sites, comparison pages, and aggregators. |
+| `marketing-analytics` | Sets up, audits, and reports on marketing measurement — tracking plans, event schemas, attribution models, and the dashboards built on them. |
+| `paid-advertising` | Plans, runs, and optimizes paid acquisition across search, social, and display — account structure, targeting, creative, bidding, budget, and the analysis that says…. |
+| `programmatic-seo` | Builds large sets of search-targeted pages from a template and a dataset — the location, comparison, integration, and use-case pages that capture long-tail demand a…. |
+| `seo-strategy` | Audits and improves organic search performance — technical health, site architecture, internal linking, structured data, and the content decisions that determine wh…. |
+
+</details>
+
+<details>
+<summary><b>Revenue</b> (CRO) — 10 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `activation` | Gets new users from signup to first real value — signup flow, onboarding, time-to-value, and the early experience that determines whether someone becomes a user or…. |
+| `chief-revenue-officer` | Owns the revenue engine end to end: sales, monetization, pricing, customer success, retention, and partnerships. |
+| `deal-negotiation` | Negotiates a commercial deal without giving away the terms that matter — preparing your walk-away and theirs, trading concessions rather than conceding them, recogn…. |
+| `outbound-prospecting` | Finds, qualifies, and reaches prospects through cold outreach — list building, qualification criteria, cold email and multi-channel sequences, and the follow-up tha…. |
+| `pricing-and-packaging` | Sets price, structures packages and tiers, and designs the monetization surfaces that carry them — upgrade paths, paywalls, and offer construction. |
+| `referral-programs` | Designs and improves referral, affiliate, and word-of-mouth programs — incentive structure, mechanics, timing, and fraud control. |
+| `retention` | Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. |
+| `revenue-operations` | Runs the mechanics of the revenue engine — lead lifecycle definitions, routing, CRM hygiene, forecasting process, pipeline reporting, and the marketing-to-sales han…. |
+| `sales-compensation-and-territory` | Designs quotas, territories and commission plans that produce the behavior the business needs — sizing territories against real potential, setting quotas people can…. |
+| `sales-enablement` | Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. |
+
+</details>
+
+<details>
+<summary><b>Finance</b> (CFO) — 13 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `budgeting-and-forecasting` | Runs the planning cycle — annual budget, rolling forecast, consolidation of business unit inputs, and the variance analysis that explains actuals against plan. |
+| `capital-allocation` | Evaluates where to spend limited capital — investment appraisal, hurdle rates, payback, and comparing proposals that are not alike. |
+| `capital-structure-and-covenants` | Decides how the business is financed and what that financing then requires of it — debt versus equity, weighted average cost of capital as a hurdle rate, how much l…. |
+| `chief-financial-officer` | Owns the financial position: planning, budgeting, forecasting, unit economics, cash, and the numbers the business is run and reported on. |
+| `cost-accounting` | Establishes what something actually costs — fixed, variable and mixed cost behavior, absorption versus variable costing, job-order, process and activity-based metho…. |
+| `financial-modeling` | Builds and stress-tests financial models for forecasting, scenario planning, and decision support — revenue build, cost structure, driver logic, and the sensitiviti…. |
+| `financial-reporting-and-close` | Runs the period-end close and produces reporting — close calendar, reconciliations, accruals, variance analysis, and reporting that gets read. |
+| `financial-statement-analysis` | Reads a set of financial statements and establishes what changed and why — fluctuation analysis against prior period and against budget, profitability, liquidity, s…. |
+| `internal-controls-and-audit` | Designs and tests controls over financial reporting — segregation of duties, approval limits, evidence, and preparing for audit. |
+| `revenue-recognition` | Determines when and how revenue is recognized — performance obligations, contract terms that change the answer, and the deal structures that create accounting probl…. |
+| `tax` | Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere…. |
+| `treasury-and-liquidity` | Manages cash and liquidity — cash forecasting, runway, working capital, banking structure, and currency and counterparty exposure. |
+| `unit-economics` | Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavi…. |
+
+</details>
+
+<details>
+<summary><b>Operations</b> (COO) — 12 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `business-continuity-and-resilience` | Plans for operating through disruption — impact analysis, recovery objectives, continuity plans, and the exercises that prove they work. |
+| `capacity-and-demand-planning` | Matches operational capacity to expected demand — forecasting load, sizing teams and systems, managing queues, and deciding when to add capacity. |
+| `chief-operating-officer` | Owns execution: how work actually gets done across the organization, including process, program management, capacity, vendors, supply chain, and service delivery. |
+| `facilities-and-workplace` | Runs the physical and hybrid workplace — space planning, leases, health and safety, office services, and the operational side of where people work. |
+| `incident-management` | Runs an operational incident from detection to closed action — declaring it and naming a commander, separating the people restoring service from the people communic…. |
+| `operating-cadence` | Designs the rhythm an organization runs on — which reviews happen weekly, monthly and quarterly, what each one decides, who owns the numbers presented, and how a si…. |
+| `process-design` | Designs, documents, and fixes operational processes — mapping the current state, finding where work actually stalls, redesigning the flow, and building controls tha…. |
+| `procurement-and-sourcing` | Buys well — specifying need, running competitive sourcing, negotiating, and category strategy before a contract exists. |
+| `quality-management` | Builds quality into operations — defining standards, catching defects at the right point, root cause analysis, and continuous improvement. |
+| `service-level-management` | Defines and manages service levels — setting targets that reflect what customers need, measuring honestly, and handling breaches. |
+| `supply-chain-and-logistics` | Manages the flow of goods and inputs — sourcing, inventory, lead times, fulfillment, and supply risk. |
+| `vendor-management` | Selects, contracts, and manages suppliers and vendors — requirements, evaluation, negotiation support, onboarding, performance management, and exit. |
+
+</details>
+
+<details>
+<summary><b>Program Management Office</b> (EPMO / COO) — 9 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `benefits-realization` | Ensures projects deliver the value they were approved on — defining measurable benefits, baselining, tracking after delivery, and honest post-implementation review. |
+| `change-and-adoption` | Gets people to actually use what was delivered — stakeholder analysis, communication, training, resistance, and measuring adoption. |
+| `dependency-and-risk-management` | Manages delivery risk and cross-team dependencies — identifying, sizing, mitigating and escalating what could stop the work. |
+| `estimating-and-contingency` | Produces a cost or effort estimate someone can defend — decomposing the work, choosing between analogous, parametric and bottom-up methods, documenting the basis an…. |
+| `head-of-pmo` | The EPMO lead's remit — what the PMO governs, what it must never become, and how it earns standing rather than compliance. |
+| `portfolio-governance` | Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. |
+| `program-management` | Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. |
+| `project-delivery` | Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. |
+| `schedule-development-and-analysis` | Builds and interrogates a project schedule — logic-driven sequencing, dependency types and lags, float and the critical path, resource loading and leveling, schedul…. |
+
+</details>
+
+<details>
+<summary><b>Customer Experience</b> (CCO) — 7 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `chief-customer-officer` | Owns the customer's experience after the sale — support, success, escalation, and the feedback loop back into product. |
+| `customer-onboarding-and-implementation` | Takes a new customer from signature to working — setting a definition of live that both sides agreed before the contract was signed, planning and staffing the imple…. |
+| `customer-success-management` | Runs the ongoing relationship with accounts after the sale — segmenting coverage against account value, building a health score that predicts rather than describes,…. |
+| `escalation-management` | Handles customer situations that have exceeded normal support — severity assessment, incident communication, executive escalation, and recovering a relationship aft…. |
+| `self-service-and-knowledge` | Builds the help center, in-product guidance, and knowledge base that let customers resolve problems without contacting anyone — content, findability, maintenance, a…. |
+| `support-operations` | Designs and runs the support function — channels, queues, routing, staffing, service levels, quality, and the metrics that show whether it is working. |
+| `voice-of-customer` | Builds the loop from what customers say to what gets changed — collecting feedback, distinguishing signal from noise, routing it to owners, and closing the loop bac…. |
+
+</details>
+
+<details>
+<summary><b>Data & Analytics</b> (CDO) — 7 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `ai-ml-governance` | Governs models and AI systems in production — intended use, evaluation, monitoring, human oversight, documentation, and the decision to deploy or retire. |
+| `business-intelligence` | Builds reporting and self-serve analytics that people actually use — metric trees, dashboard design, distribution, and the discipline that stops dashboards prolifer…. |
+| `chief-data-officer` | Owns data as an asset — governance, quality, the warehouse and semantic layer, analytics capability, and the governance of models built on top. |
+| `data-engineering` | Builds and operates data pipelines — ingestion, transformation, orchestration, quality testing, and reliability of data delivery. |
+| `data-governance` | Establishes ownership, definitions, quality, access, and lineage for the organization's data. |
+| `data-modeling` | Designs the warehouse and semantic layer — source-to-mart structure, dimensional modeling, grain, slowly changing dimensions, and the metric layer analytics reads t…. |
+| `quantitative-analysis` | Answers a business question with data without fooling yourself — framing the question so an answer would change something, choosing the right comparison, checking t…. |
+
+</details>
+
+<details>
+<summary><b>Corporate Strategy</b> (CSO) — 6 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `chief-strategy-officer` | Owns where the business plays and how it wins over a multi-year horizon — portfolio choices, corporate development, strategic partnerships, and planning under uncer…. |
+| `market-entry` | Decides whether and how to enter a new market — sizing demand from the bottom up rather than from a market report, testing whether your advantage transfers, choosin…. |
+| `mergers-and-acquisitions` | Runs corporate development — deal thesis, target screening, valuation framing, diligence, and integration planning. |
+| `portfolio-strategy` | Decides where capital and attention go across business lines, products, and markets — what to fund, hold, harvest, or exit, and on what evidence. |
+| `scenario-planning` | Plans under genuine uncertainty — building scenarios, identifying which assumptions are load-bearing, setting early-warning indicators, and stress-testing a plan ag…. |
+| `strategic-alliances` | Structures partnerships that change what the business can do — technology integrations, channel and reseller arrangements, joint ventures, and OEM relationships. |
+
+</details>
+
+<details>
+<summary><b>People</b> (CHRO) — 12 skills</summary>
+
+| Skill | What it does |
+|---|---|
+| `benefits-and-leave` | Designs and runs employee benefits and leave — health and retirement plans, leave policy, cost and renewal, and the administration that keeps them compliant. |
+| `chief-human-resources-officer` | Owns the organization itself: org design, hiring, performance, compensation, development, culture, and employee relations. |
+| `compensation-and-leveling` | Builds and maintains the leveling framework and pay structure — level definitions, salary bands, benchmarking, pay equity, and how raises and promotions are decided. |
+| `employee-relations` | Handles the difficult human situations — grievances, complaints, investigations, conflict, and separations conducted properly. |
+| `employment-compliance` | Covers the employment rules that carry real penalties — exempt and non-exempt classification, overtime and hours, employee versus contractor status, work authorizat…. |
+| `hiring-and-interviewing` | Designs and runs hiring — role definition, sourcing, interview loop design, structured evaluation, and the decision itself. |
+| `learning-and-development` | Builds capability — skills gaps, career frameworks, training that transfers to the job, and internal mobility. |
+| `onboarding-and-offboarding` | Designs the joining and leaving experience — first-day readiness, ramp to productivity, knowledge capture, and clean exits. |
+| `org-design` | Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. |
+| `payroll-operations` | Runs the pay cycle so it is right, on time, and provable — the calendar and cutoffs, what feeds pay from the HRIS and time systems, gross-to-net and the deductions…. |
+| `performance-management` | Runs performance systems that change behavior — expectations, feedback, review cycles, calibration, and handling underperformance. |
+| `workforce-planning` | Plans the shape and size of the workforce — demand for roles, build-versus-buy, attrition, and sequencing hiring against budget. |
+
+</details>
+
+<details>
+<summary><b>Legal & Risk</b> (CLO / CCO) — 8 skills · **reviewer-class**</summary>
+
+| Skill | What it does |
+|---|---|
+| `chief-legal-and-risk-officer` | Owns legal, contracts, intellectual property, regulatory compliance, privacy, security governance, enterprise risk, and audit readiness. |
+| `contract-review` | Reviews and negotiates commercial agreements — MSAs, SOWs, order forms, NDAs, vendor and data-processing agreements — identifying material risk, proposing positions…. |
+| `corporate-governance` | Maintains the corporate record and the governance machinery — entity records, board and committee support, resolutions and minutes, delegations of authority, insura…. |
+| `disputes-and-legal-holds` | Handles a dispute from the first sign of it — recognizing when preservation obligations attach, issuing and scoping a legal hold, suspending automatic deletion acro…. |
+| `enterprise-risk` | Identifies, assesses, and tracks organizational risk — building and maintaining a risk register, scoring exposure, assigning owners and treatments, and preparing fo…. |
+| `intellectual-property` | Covers what the organization owns and what it is only borrowing — trademarks and clearance, copyright and work-for-hire, patents and trade secrets, open-source lice…. |
+| `privacy-and-data-protection` | Assesses and improves how personal data is collected, used, shared, and retained — data mapping, lawful basis, consent, processor agreements, subject rights, and br…. |
+| `regulatory-compliance` | Identifies which regulations apply and builds the program that keeps you inside them — obligation mapping, controls, monitoring, and responding to regulators. |
+
+</details>
+
+**Reviewer-class departments** (`security`, `legal-risk`) review what other departments build, and
+their blocking findings are not overrulable by the department under review. That is why the CISO
+and the CLO report to the chief executive rather than into the function they oversee.
+
+## Sources
+
+A skill states what a competent practitioner knows. It cannot state what the regulator
+published last month — it is written once and the obligation moves. So skills that answer
+questions an outside authority settles carry a list of those authorities, in
+`references/sources.md` inside the skill, which is where an agent reads it while answering.
+
+184 sources across 150 skills so far — tax and accounting, law and
+employment, security and controls frameworks, education standards.
+[The full index is in `docs/SOURCES.md`](docs/SOURCES.md).
+
+**References, never copies**, and every entry carries what you may actually do with it. That
+second part is the point: most of what a professional must cite is not open. ISO standards are
+sold, SANS papers are copyrighted, the FASB Codification needs an account — while US federal
+works are public domain by statute and EU legal texts are reusable with attribution.
+125 of the 184 are quotable; the rest are read-and-cite, and the entry
+says so in the imperative next to the link.
+
+Links are re-checked weekly by their own workflow rather than on every push, because a
+publisher being briefly down is not a reason to fail an unrelated pull request.
+
+## How it is organized
+
+```
+plugins/<department>/
+  .claude-plugin/plugin.json   department manifest, Claude Code
+  .codex-plugin/plugin.json    the same department, ChatGPT and Codex
+  skills/<skill>/SKILL.md      frontmatter name equals the directory name
+  skills/<skill>/references/   supporting files, including the skill's sources
+.claude-plugin/marketplace.json  the marketplace Claude Code reads
+.agents/plugins/marketplace.json the same departments, for ChatGPT and Codex
+sources/*.toml                 the source catalog, mapped to the skills it serves
+verticals/<name>/              industry packs, emitted as standalone repositories
+.claude/agents/<id>.md         one charter per department
+AGENTS.md                      repository context for any agent working on this repo
+docs/AGENT-SURFACES.md         every path has exactly one owner, enforced in CI
+docs/DECISION-LOG.md           numbered decisions with options and recommendations
+docs/GETTING-STARTED.md        install, what to take first, and how to invoke a skill
+docs/SOURCES.md                every source in the catalog, and what may be done with it
+docs/USE-CASES.md              situations worked end to end across departments
+docs/org-chart.html            interactive org chart, searchable across every skill
+docs/index.html                GitHub Pages entry point, redirects to the chart
+```
+
+Agents split by **exclusive write surface**, not by topic — a topic split has no checkable
+boundary, and two agents working on "SEO" and "UI" both end up in the same file. See
+`executive:agent-hierarchy` for the method.
+
+## Contributing
+
+```
+./scripts/check-all.sh
+```
+
+Every check CI runs, in one script. The surface map is coherent; every skill's frontmatter is
+valid and unique; no third-party license text has appeared; the README, social card and org
+chart are current; every `department:skill` reference resolves; spelling is US English; no
+`## Never` block mixes two styles; the source catalog is valid and every skill's source file
+matches it; the ChatGPT manifests match the Claude ones; every vertical emits a repository that
+passes its own checks; and every manifest parses. CI calls this same script, so local and CI
+cannot drift.
+
+A new department needs its roster row in `docs/AGENT-SURFACES.md`, a surface block, a charter in
+`.claude/agents/`, and an entry in `.claude-plugin/marketplace.json` — all in the same change, or
+the check fails.
+
+## Contributors
+
+<a href="https://github.com/cbrock84/headcount/graphs/contributors">
+  <img alt="Contributors to headcount" src="https://contrib.rocks/image?repo=cbrock84/headcount">
+</a>
+
+The ChatGPT and Codex support in this repository started as a contribution from
+[@adi-dibra](https://github.com/adi-dibra), who worked out that the same `SKILL.md` files load
+in both tools and that only the manifests differ.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=cbrock84/headcount&type=Date&theme=dark">
+  <img alt="Star history" src="https://api.star-history.com/svg?repos=cbrock84/headcount&type=Date" width="600">
+</picture>
+
+## Going further
+
+headcount stays MIT and free. Where a skill stops at advice and the work needs a system, these
+are products from the same builder, listed so you know they exist — nothing here requires them:
+
+| If the skill you used was | The work it points to | Built for it |
+|---|---|---|
+| `security:*`, `legal-risk:regulatory-compliance`, `legal-risk:enterprise-risk` | Running a SOC 2, ISO 27001, NIST CSF or HIPAA program with evidence an auditor accepts | [Keel](https://keelgrc.com) — GRC platform, free plan |
+| `demand-generation:ai-search-optimization`, `demand-generation:seo-strategy` | Checking what an AI answer engine can actually read on your site | [Cite Unseen](https://citeunseen.io) — free scan, paid audit |
+| `product:*`, `technology:implementation-planning` | Turning a spec into a React project you own | [vibld](https://vibld.com) — AI app builder, open-source core |
+
+## Supporting this work
+
+If a department saved you an afternoon, you can sponsor the work on
+[GitHub Sponsors](https://github.com/sponsors/cbrock84). Sponsorship pays for the time spent
+re-checking sources and keeping skills current; it buys no influence over what a skill says,
+and the repository stays MIT whether or not anyone sponsors it.
+
+## Writing
+
+Notes from building and running this, and from the day job — technology, security, AI, and the
+operating side of all three — go out at [cbrock84.substack.com](https://cbrock84.substack.com).
+
+The piece on why this is shaped like an org chart at all, and what broke before it was:
+[Giving AI agents an org chart](https://cbrock84.substack.com/p/giving-ai-agents-an-org-chart).
+
+## License
+
+MIT — see [LICENSE](LICENSE). Every skill here was written for this repository.
+
+Built by [Chris Brock](https://chrisbrock.io).
+
+---
+
+<sub>README generated by `scripts/build-readme.py` — edit that, not this file.</sub>