agentleFS
hollandkevinthollandkevint/data-product-operator/CLAUDE.md

data-product-operator

CLAUDE.md5 starsChanged 2 months agoMITView on GitHub

An operating system for data leaders and data product managers, with reusable skills, decision records and workflow handoffs. Keep the top-level positioning domain agnostic. Skill discovery depends on the host. Slash commands produce structured artifacts (PRDs, quality reviews, stakeholder briefs). Core data-product skills apply across domains; use healthcare-specific skills when the project calls for them. Write like a practitioner, not a consultant. Use supported numbers, sourced or clearly synthetic examples, and concrete checks. Use the reader's domain; do not default…

The file

We split this CLAUDE.md into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Write like a practitioner, not a consultant.

    line 9
  2. Distinctive:

    NEVER use: leverage, utilize, synergy, robust, seamless, comprehensive, delve, pivotal, furthermore, notably, "drive insights", "leverage …

    line 11
  3. Distinctive:

    ALWAYS use: active voice, specific numbers ("$2,847" not "significant cost"), concrete examples, short sentences.

    line 13
  4. Distinctive:

    Keep domain packs below the core OS in navigation.

    line 21
  5. Distinctive:

    Use Analyst for an explicit evidence graph across skills.

    line 48

≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
CLAUDE.md

Data Product Operator

An operating system for data leaders and data product managers, with reusable skills, decision records and workflow handoffs. Keep the top-level positioning domain agnostic.

Skill discovery depends on the host. Slash commands produce structured artifacts (PRDs, quality reviews, stakeholder briefs). Core data-product skills apply across domains; use healthcare-specific skills when the project calls for them.

Voice

Write like a practitioner, not a consultant. Use supported numbers, sourced or clearly synthetic examples, and concrete checks. Use the reader's domain; do not default to healthcare.

NEVER use: leverage, utilize, synergy, robust, seamless, comprehensive, delve, pivotal, furthermore, notably, "drive insights", "leverage data assets", or Gartner-speak.

ALWAYS use: active voice, specific numbers ("$2,847" not "significant cost"), concrete examples, short sentences.

DPOS Framework Context

The Data Product Operating System (DPOS) covers people, process, product and platform. Start with Data Product Operator for leader/DPM decisions and a repeatable operating loop. Grow from one decision to a product, team or portfolio only when needed. Shape Up is one process option, not a required cadence. The library supports operating work; it does not autonomously run a company or replace its tracker. Learn more at kevintholland.com.

Domain and platform context

Keep domain packs below the core OS in navigation. Domain applications covers marketing data, logistics/operations and ecommerce using core skills. Healthcare applications has additional dedicated skills. State differences in pack depth and testing; do not imply equal maturity.

The healthcare pack includes healthcare-data-readiness-debrief, healthcare-cohort-design, healthcare-data-reconciliation, healthcare-data-domain and relevant portions of ethical-risk-assessment. Choose the specific job; do not load every healthcare skill automatically.

Platform guidance lives in databricks-data-product-review and duckdb-data-profiling. Keep the clinical definition separate from execution details. Confirm the environment and authorization before running queries, changing data or exporting results.

Healthcare-specific skills stay inactive for non-healthcare work. Core skills may retain healthcare examples as historical illustrations; adapt them to the current domain without importing clinical assumptions.

Workflow Chain

The skills compose in this natural sequence:

discover consumers -> synthesize findings -> validate demand -> scope problem -> write PRD -> define metrics -> review model -> test pipeline -> tell the story -> write stakeholder brief

Each step builds on the prior. Commands write output files that downstream steps can reference:

  • /data-product-operator:run-discovery writes discovery-brief-<name>.md
  • /data-product-operator:write-problem-brief writes problem-brief-<name>.md
  • /data-product-operator:write-data-prd writes data-prd-<name>.md
  • /data-product-operator:review-data-quality writes quality-review-<name>.md
  • /data-product-operator:write-stakeholder-brief writes stakeholder-brief-<name>.md
  • /data-product-operator:reshape-sprint writes shaped-pitch-<name>.md
  • /data-product-operator:review-data-model provides conversational critique

Skill Composition

Use Analyst for an explicit evidence graph across skills. Route from the unresolved decision; record definition/source versions, proposed versus executed checks, findings, owner decisions and follow-up observations. Healthcare applications provide domain routes. Keep project evidence outside the public repository. Test graph changes with python3 skills/analyst/scripts/check_graph.py --self-test.

Hosts may select several skills or require explicit invocation. They cross-reference instead of duplicating. ethical-risk-assessment points to data-quality-assessment for scoring details rather than repeating the 5-dimension model.

Quick map:

  • Discovery: data-consumer-discovery (Mom Test for data, workaround archaeology, consumer segments)
  • Validation: data-product-validation (5-dimension scorecard, experiment types, Type 1/2 decisions)
  • Synthesis: research-synthesis-data (atomic research chain, evidence hierarchy, 3 outputs)
  • Team positioning: data-team-positioning (3 stances, evidence as currency, betting table pitches)
  • Decision framing: data-product-thinking (5-risk model, outcome trees)
  • Quality: data-quality-assessment (5 dimensions, circuit breakers)
  • Metrics: metrics-definition (naming rules, grain, trust metrics)
  • Translation: stakeholder-alignment (jargon to outcomes, shaping requests)
  • Team ops: data-team-operating-model (squads, Shape Up cycles)
  • Schema: data-model-design (star schema, SCDs, ADRs)
  • Clinical data: healthcare-data-domain (FHIR, OMOP, terminology)
  • Storytelling: data-storytelling (headlines, narrative arcs, chart selection)
  • Pipeline quality: data-pipeline-quality (dbt tests, contracts, circuit breakers)
  • Ethics: ethical-risk-assessment (bias testing, phased rollout)

Skill Writing Rules

The standalone healthcare-data-readiness-debrief is directly invocable and portable across Codex and Claude. Its frontmatter uses name, description, and metadata.version; do not add user-invocable: false. Its longer entrypoint preserves interview and safety boundaries, with domain detail in references. Do not impose maturity scores or dataset access from adjacent skills on this debrief.

For contributors adding or modifying skills:

  • New portable skills use name, a task-specific description, and metadata.version. Keep them directly invocable and discoverable. Preserve existing invocation policy unless deliberately changing it.
  • Body: 50-80 lines for foundational skills, 80-100 lines for domain skills
  • Imperative voice: "Write", "Avoid", "Include"
  • State non-negotiable rules in sentence case ("Never ship...", not "NEVER ship..." or "CRITICAL:")
  • Cross-reference related skills by name instead of duplicating content
  • Include concrete examples. Name real products, cite specific numbers

Shared skills: public wins

This library owns the body of every skill it ships. A private collection copies those bodies unchanged. A private-only difference goes in a sibling overlay.md in the private copy, never as an edit to the shared SKILL.md. Improve a shared skill here first, then re-sync private copies.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.