Cargo Make Protocol (80/20 Edition)

Golden Rule

ALWAYS: cargo make [target]
NEVER:  cargo [command]

Direct cargo bypasses timeouts, quality gates, andon signals.

Quick Reference

Fast Feedback (<20s)

cargo make check      # Compile (<5s)
cargo make test-unit  # Unit tests (<16s)
cargo make lint       # Clippy (<60s)

Pre-Commit

cargo make pre-commit # fmt + lint + test (<2min)

Full Validation

cargo make test       # All tests (<30s)
cargo make ci         # Full CI pipeline
cargo make slo-check  # Verify SLOs

SLO Targets

| Target | SLO | Escalation | |--------|-----|------------| | check | <5s | 30s | | test-unit | <16s | 150s | | test | <30s | 120s | | lint | <60s | - | | pre-commit | <2min | - |

Andon Signals

| Signal | Trigger | Action | |--------|---------|--------| | 🔴 RED | error[E...], FAILED | STOP - fix now | | 🟡 YELLOW | warning:, clippy:: | Investigate | | 🟢 GREEN | test result: ok | Continue |

Three-Layer Validation

# Layer 1: Compile
cargo make check && cargo make lint

# Layer 2: Test
cargo make test

# Layer 3: Runtime (catches fake greens)
cargo make verify-cli

Common Workflows

Development Cycle

cargo make check      # After changes
cargo make pre-commit # Before commit
cargo make ci         # Before push

Quality Audit

cargo make test-audit     # Mutation testing
cargo make detect-gaps    # Coverage gaps
cargo make audit-all      # Security

Release

cargo make release-validate  # 8 FMEA gates
cargo make release           # Build + deploy

Prohibited Patterns

# ❌ WRONG
cargo check
cargo test
cargo clippy

# ✅ CORRECT
cargo make check
cargo make test
cargo make lint

Best Practices

1. Always cargo make - never direct cargo
2. Receipt-based - evidence not narrative
3. Three-layer validation - compile → test → runtime
4. Respect andon signals - RED = stop
5. SLO enforcement - timeouts prevent hangs

Constitutional: cargo make [target] ONLY | Receipts replace review | Andon = stop-the-line