algo-mfg-cpk

name	"algo-mfg-cpk"
description	"Calculate Cpk process capability index to assess whether a process meets specification requirements. Use this skill when the user needs to evaluate process capability, compare processes, or determine if quality targets are achievable — even if they say 'can our process meet spec', 'process capability', or 'Cpk calculation'.".
allowed-tools	Bash, Read, Write, Edit, Glob, Grep

Cpk Process Capability Index

Overview

Cpk measures how well a process fits within specification limits, accounting for both variation (spread) and centering. Cpk = min((USL - μ) / 3σ, (μ - LSL) / 3σ). Cpk ≥ 1.33 is typically required; Cpk ≥ 1.67 for critical characteristics. Unlike Cp, Cpk penalizes off-center processes.

When to Use

Trigger conditions:

• Assessing whether a manufacturing process can meet customer specifications
• Comparing capability across processes, machines, or time periods
• Qualifying a process for production readiness

When NOT to use:

• When the process is not in statistical control (stabilize first with SPC)
• For non-normal distributions without transformation

Algorithm

IRON LAW: Cpk Is Only Valid for a STABLE, IN-CONTROL Process
Computing Cpk on an unstable process gives a meaningless number.
The process MUST be in statistical control (per SPC charts) before
capability analysis. An unstable process with Cpk=2.0 today may
produce defects tomorrow when it shifts.

Phase 1: Input Validation

Collect: 100+ measurements from a stable process. Determine: USL, LSL (customer specifications). Verify process is in control (SPC charts show stability). Gate: Process in control, specifications defined, 100+ data points.

Phase 2: Core Algorithm

1. Compute process mean: μ = Σxᵢ / n
2. Compute process standard deviation: σ = estimated from R-bar/d₂ or S-bar/c₄ (within-subgroup) — NOT overall std dev
3. Cp = (USL - LSL) / 6σ (potential capability, ignoring centering)
4. Cpk = min((USL - μ) / 3σ, (μ - LSL) / 3σ) (actual capability)
5. Estimate PPM defective from Cpk (e.g., Cpk=1.33 → ~63 PPM)

Phase 3: Verification

Check: Cp vs Cpk difference indicates centering issue (Cp >> Cpk = off-center). Distribution is approximately normal (histogram, normality test). Gate: Capability computed, centering assessed, normality verified.

Phase 4: Output

Return capability indices with defect rate estimates.

Output Format

{
  "capability": {"cp": 1.8, "cpk": 1.45, "ppm_defective": 27},
  "centering": {"mean": 50.2, "target": 50.0, "offset_pct": 0.4},
  "specs": {"usl": 55, "lsl": 45, "target": 50},
  "metadata": {"samples": 200, "sigma_method": "rbar_d2", "normality_p": 0.35}
}

Examples

Sample I/O

Input: USL=55, LSL=45, μ=50.2, σ=1.5 Expected: Cp = (55-45)/(6×1.5) = 1.11. Cpk = min((55-50.2)/4.5, (50.2-45)/4.5) = min(1.07, 1.16) = 1.07. Below 1.33 target.

Edge Cases

Input	Expected	Why
μ exactly at target	Cp = Cpk	Perfectly centered
μ outside specs	Cpk < 0	Process mean beyond specification limit
One-sided spec only	Use Cpk for that side only	e.g., surface finish has only USL

Gotchas

• σ estimation method: Use within-subgroup σ (R̄/d₂), NOT overall σ. Overall σ includes between-subgroup variation that inflates σ and understates Cpk.
• Non-normal data: Cpk assumes normality. For skewed data (surface finish, concentricity), use Box-Cox transformation or non-parametric capability indices.
• Short-term vs long-term: Cp/Cpk are short-term (within subgroup variation). Pp/Ppk use overall variation (long-term). Customers often want Ppk.
• Sample size confidence: Cpk from 30 samples has wide confidence intervals. Report confidence intervals alongside point estimates.
• Cpk ≠ defect-free: Even Cpk=2.0 has a theoretical defect rate (~0.002 PPM). For ultra-critical applications, higher Cpk or process validation is required.

Scripts

Script	Description	Usage
scripts/cpk.py	Compute Cp, Cpk, Cpm, and PPM defective from process data	python scripts/cpk.py --help

Run python scripts/cpk.py --verify to execute built-in sanity tests.

References

• For Cp/Cpk/Pp/Ppk comparison, see references/capability-indices.md
• For non-normal capability analysis, see references/non-normal-capability.md