Project Governance | Skills Pool
Project Governance Architecture Decision Records (ADRs), risk register management, KPI tracking,
phased execution planning, and documentation governance for the pipeline project.
Use when making architectural decisions, updating project status, managing risks,
or planning new phases.
stevef210 0 stars Mar 12, 2026 Occupation Categories Finance & Investment Expert knowledge for managing the project's decision records, risk register, KPIs, and phased execution plan.
Current Status
Metric Value v1 Completion 53/53 (100%) Post-v1 280/283 (3 deferred) Total 369/372 (100%) Health Score GREEN (98/100) ADRs 128 recorded (ADR-001 through ADR-135, gaps at 121-129)
Governance Documents
Document Purpose Location Roadmap Authoritative status & roadmap (v6.13) docs/ROADMAP.mdArchitecture Decisions ADR log (128 ADRs)
Quick Install
Project Governance npx skillvault add stevef210/stevef210-rust-media-pipeline-claude-skills-project-governance-skill-md
stars 0
Updated Mar 12, 2026
Occupation docs/DECISIONS.md
Risk Register Living risk tracker docs/RISKS.md
KPI Baseline Launch success metrics docs/KPI_BASELINE.md
Capabilities Runtime feature flags shared/capabilities.json
ARCHIVED (Do NOT Update)
docs/archive/ROADMAP_V3.2_ARCHIVED.md
docs/archive/IMPLEMENTATION_CHECKLIST_ARCHIVED.md
docs/archive/PROJECT_AUDIT_BASELINE_ARCHIVED.md
docs/archive/PIPELINE_CHECKLIST_ARCHIVED.md
Phase Tracker Phase Name Done/Total Status 0-4 v1 Core (Truth, Reliability, Shorts, Hardening, Creator) 53/53 COMPLETE S1 Synergy Calibration done COMPLETE Y1 YouTube Compilation Pipeline done COMPLETE A1 Fix Foundations done COMPLETE D1 Documentation & Guides done COMPLETE AI1 Claude AI Wiring done COMPLETE C0 Timeline Foundation done COMPLETE C1 Context Moment Detection done COMPLETE C2 Overlay Placement done COMPLETE U1 Human Override UX done COMPLETE DC1 IRL Director's Cut — 6-Stage Pipeline 26/26 COMPLETE W1 Wiring Audit II 17/17 COMPLETE DC2 Creative Rendering + Data Bridges 15/17 COMPLETE (DC2-10/11 deferred) Y2 YouTube Compilation Quality (ADR-048) 18/18 COMPLETE I1 Integration Testing 3/4 COMPLETE (I1-2 deferred) O1 Operations Hardening 4/4 COMPLETE C3 Visual Overlay Rendering (ADR-057) 6/6 COMPLETE C4 PiP & Multi-Layer (ADR-057) 5/5 COMPLETE C5 Temporal Storytelling Effects (ADR-057) 5/5 COMPLETE C6 Audio-Visual Context (ADR-057) 5/5 COMPLETE V1 IRL Compilation Quality (ADR-049/050/053/057) 11/11 COMPLETE DB1 Database Audit Fixes (ADR-055) 9/9 COMPLETE T1 Feature Telemetry (ADR-056/057) 4/4 COMPLETE R2 Cross-Module Resilience Audit (ADR-058/059) 10/10 COMPLETE SC1 Signal Contract + Integration Wiring (ADR-060) 8/8 COMPLETE QC1 Post-Export Quality Contract (ADR-061) 8/8 COMPLETE RH1 Resilience Hardening Audit (ADR-062) 6/6 COMPLETE RF1 Job Pipeline Decomposition (ADR-063) 6/6 COMPLETE PA1 Pipeline Audit Fixes (ADR-064) 13/13 COMPLETE 9 FFmpeg Safety & Process Hardening done COMPLETE 10 Transcription & Confidence done COMPLETE (10.2 confidence propagation) 11 Enrichment & Scoring done COMPLETE (11.4-M1 type safety remains) 12 Shorts Pipeline Parity (ADR-104/105) 8/8 COMPLETE 13 IRL Content Automation 6/6 COMPLETE 14 AI Enhancement Expansion (ADR-107) 10/10 COMPLETE 16 Advanced Features (16.1-16.7) 7/7 COMPLETE CC-1-6 Doc sync, metrics, contracts, fixtures, budgets, proof 6/6 COMPLETE 17.1-17.10 Preset registry, Drizzle, file refactor, route harden, validation 8/8 COMPLETE GPU GPU Validation done COMPLETE ADR-131 Intent-Driven Pipeline (6 phases) 6/6 COMPLETE ADR-133 Speaker-Face Identity Graph (3 phases) 3/3 COMPLETE ADR-134 IRL Speaker Attribution (6 phases) 6/6 COMPLETE ADR-135 Short Clip Evaluation (SCE-1-7) 7/7 COMPLETE IRL Semantic IRL Semantic Enrichment (4 buckets, 9 detectors) 4/4 COMPLETE EPCOT EPCOT Competitor Comparison Harness done COMPLETE Module Wiring Wave 3: 7 modules → routes + pipeline done COMPLETE
ADRs by Domain (128 Total — ADR-001 through ADR-135, gaps at 121-129)
Architecture & Core (ADR-001 through ADR-012) ID Decision 001 TypeScript is authoritative pipeline for v1 002 Replace Math.random() with deterministicSelect 003-005 Rust bridge decisions (superseded by 006) 006 Archive all 26 Rust crates 008 Consolidate to 3 export formats (MP4, Premiere, JSON) 009 FFmpeg dual-stream capture (stdout + stderr) 010 Loudness-aware adaptive threshold tuning 012 Claude API lazy initialization (ESM module order)
Scoring & Signals (ADR-014 through ADR-029) ID Decision 014 Synergy graduated activation + learned weights 017 AI Enhancement Layer (6 Claude modules, ~$0.07/job) 018 Export Data Enrichment (25+ clip fields) 019 Timeline Foundation (TimelineSpec, quality gate) 020 YouTube xfade batching (groups of 8, drift fix) 021 Show Bible route audit (data source mismatches) 022 Gesture detection multi-signal fusion 023 Overlay Placement Engine (Phase C2, 4-phase pipeline) 026 Wiring Audit I (C1→analysisData, C2→exports, Phase 4→routes) 027 Chat Emote Humor Signal (emote dictionary, humor heatmap) 028 V22 IRL Timeline Distribution (temporal zone round-robin, percentile arcs) 029 Content-Adaptive Pack Scoring + VOD-Duration Clip Count
Show Bible & Compilation (ADR-030, ADR-043, ADR-048) ID Decision 030 Show Bible Pipeline Integration (episode tier, 8 formats, act structure) 043 Rename chatScore → sentimentScore (DB + UI + exports) 048 Compilation Objective Function + Content-State Constraints (6-phase algorithm)
Wiring Audits (ADR-031 through ADR-035) ID Decision 031 Wiring Audit II — catalogued ~24 unwired modules 032 Metadata Rendering Wiring (audioClassifier, retentionPredictor, sceneClassification) 033 Wire Clip Reviews Into Real Weight Training 034 W1 Complete — 16/17 modules wired 035 Chat File Import + ADR-012 Enforcement + QSV Concurrency
IRL Director's Cut (ADR-036 through ADR-042, ADR-044-045, ADR-047) ID Decision 036 Segment Quality Gate & Vertical Crop Strategy (architecture) 037 IRL Director's Cut Pipeline v1 — Full Execution Spec 038 DC1 Stages 4-5: Adaptive crop + segment assembly 039 DC1 Stages 1-3 + Stage 6: Quality scan + subject scan + island extraction + verification 040 Humor as 11th Fusion Signal + Caption Burn-In for Shorts 041 5hr IRL VOD Audit Fixes (6 bugs) + DC1 Orchestrator Wiring 042 Creative Renderer + Pattern Interrupt FFmpeg Audit (7 bugs fixed) 044 Wire transitionDetection → Sequencer (last W1 gap) 045 Creative Rendering Quality Upgrade (reaction_freeze, split_screen, SFX, C3 overlay) 047 H0 Timeline Debias + Emotion Detection Overhaul (6 fixes)
Operations (ADR-046) ID Decision 046 Automated Data Retention Cleanup (scheduled, GDPR, disk metrics)
IRL Quality & Validation (ADR-049 through ADR-054) ID Decision 049 IRL Compilation Validation — FFmpeg outro/dimension fixes, clip type classifier 050 Cross-VOD Wiring Failures — content-state classifier, hookGrade, zone cap P0 fixes 051 Proxy Module Audit — 7 modules, 23 fixes, 26 regression tests 052 ONNX Fallback Hardening — race-safe lazy init, sentinel detection 053 V1 IRL Quality Audit — xfade PTS, Whisper bandpass, VOD segment detection 054 Real-Media Validation — transcript cap, face proxy, content-state IRL bias
Database & Storage (ADR-055, ADR-056) ID Decision 055 Database Audit — 9 fixes (field projection, batched writes, JSONB validation) 056 Feature Telemetry Schema — feature_telemetry table + 3 IStorage methods
Creative Rendering (ADR-057) ID Decision 057 C3-C6 Complete — visual overlays, PiP, temporal effects, audio-visual context
Resilience & Hardening (ADR-058 through ADR-062) ID Decision 058 IRL Transcript Resilience — 8 new modules, 308 tests 059 Cross-Module Resilience Audit — 10 fixes, 62 tests 060 Signal Contract + Integration Wiring — SignalContract type, quality gates 061 Post-Export QC Pack — 7 automated checks, 3 artifact tiers, 81 tests 062 Resilience Hardening — FFprobe validation, timer lifecycle, ONNX disposal
Architecture Refactoring (ADR-063, ADR-064) ID Decision 063 Job Pipeline Decomposition — routes/jobs.ts 3,156→275 lines 064 Pipeline Audit Fixes — adelay syntax, xfade timeout, packaging IRL calibration
Content Quality & Presets (ADR-065 through ADR-072) ID Decision 065 Clickbait/CTA Detection — metadata enrichment, not fusion signals 066 Evaluation ML — label leakage prevention, proper AUC, rollback verification 067 Retention Predictor — content-type adaptive thresholds 068 Content-Type Defaults — getContentTypeDefaults(), LUFS targets, hook thresholds 069 (reserved) 070 Content-State Rebalance — travel_transition requires location_change events 071 Dead Air Detection — content-type adaptive, precomputed reports, 4 dead air types 072 Sort Determinism — stable tie-breakers in highlightFusion, confMap batch warnings
Speaker & Transcription (ADR-073 through ADR-078) ID Decision 073 K-means Init Fix — diarization determinism 074 Narrative Arcs — percentile-based arc types, safeScore guard 075 (reserved) 076 Location Mention Tagging — IRL location detection 077 IStorage Methods + Speaker Diarization — FFmpeg k-means for 6 presets 078 Transcription 5 Backends — Canary GPU-PB, vocabulary boosting, post-ASR correction
IRL & Scoring Audits (ADR-079 through ADR-084) ID Decision 079 (superseded — scoring fixes are ADR-083) 080 IRL Scoring Pathologies — 7 fixes (ASR routing, prestream gate, confidence floor, brightness=0) 081 React Frontend Removal — API-only, CLI for all operations 082 vodDuration Stale Reference — in-memory sync after DB writes 083 Scoring Deflation — chatActivity missing, normalizer unbounded, loudness homogeneous 084 12-Signal Fusion — chatActivity as 12th signal, 14 synergy pairs, 7 triples
Pipeline Audits (ADR-085 through ADR-092) ID Decision 085 Dead Code Deletion — 5 modules removed (~2,840 lines), CLI export wired 086 E2E Audit Bug 1-2 — FinalScore packaging blend, post-packaging recomposition 087 E2E Audit Bug 3-4 — dominantSignals ranking, QC timeout scaling 088 Metadata Critical Fixes — production preset bypass, twitch/competitive_gaming, JSONB double-encoding 089 Deep Pipeline Audit — 15 fixes (VOD segment loss, chat suppression, JSONB prune, batch DB, WebSocket trim) 090 Show Bible Deep Audit — score scale mismatch, IRL hooks, face clamping, 46 new tests 091 Determinism & Resilience Audit — 17 sort tie-breakers, division-by-zero, signal type dedup 092 Job Pipeline Audit & Test Coverage
BRB & Compilation Quality (ADR-093 through ADR-096) ID Decision 093 BRB Segment Detection — chat heatmap dropout, excludeFromCompilation wired 094 Temporal Zone Round-Robin + Word-Level Speech Coverage 095 Compilation Enhancement Pipeline — 14 AI modules wired, data bridge fix 096 Reality TV Psychology — open loops, anticipation hooks, emotional contrast
Deep Audits & Engineering (ADR-097 through ADR-099) ID Decision 097 264-Finding Deep Audit — memory bombs, FFmpeg migration 098 8-Phase Health Hardening — runFFmpegAnalysisRaw, WebSocket dedup 099 12-PR Engineering Audit — security, reliability, observability
Universal Planner & Chat (ADR-100 through ADR-103) ID Decision 100 Universal VAD Transcription Planner — IRL gate removed, all presets use VAD 101 Chat System Deep Audit — 9 fixes (bucket keys, JSONB coercion, per-clip sentiment) 102 Pipeline Preset Consistency Audit 103 Confidence Propagation (Phase 10.2)
Shorts & AI Expansion (ADR-104 through ADR-107) ID Decision 104 Shorts Pipeline Parity — LUFS normalization, eligibility gates (Phase 12.1/12.2) 105 Shorts Phase 12.3-12.8 — captions, QC, hooks, transitions, loops, TikTok 106 EPCOT 6hr Fusion Threshold-Signal Mismatch (4 fixes) 107 Phase 14 AI Enhancement Expansion (14 modules)
KPI Tracking KPI Target Current Status Clip Yield ≥20 clips/hr VOD 25.0-25.2/hr PASS Processing Speed ≤15 min/hr VOD 11.4 min/hr (21x realtime) PASS Clip Quality P@10 ≥ 0.65 Needs labeled data OPEN Export Success ≥95% PASS PASS AI Cost ≤$2.00/hr VOD ~$0.07/job PASS
Risk Register Summary Active (4 MEDIUM, 0 HIGH): R20 (data-starved ML — needs YouTube/TikTok API), R29 (eval feedback loop — empty JSONL dataset), R30 (E2E test deferred — dashboard not in use)
Closed (39+): R01-R19, R21-R28, R31-R37, plus all HIGH/CRITICAL risks resolved
See docs/RISKS.md for full details.
Governance Rules
One source of truth : docs/ROADMAP.md for project status (v6.1)
ADR required : For any scoring/architecture change
No ghost docs : Do NOT update archived documents
capabilities.json : Must reflect actual (not aspirational) state
Phase updates : Mark items complete with date in execution plan
Risk review : Weekly 30-min self-triage of risk register
Doc integrity (CC-1) : Phase completion must update ROADMAP + CLAUDE.md + MEMORY.md in same commit. See ROADMAP "Document Cross-References" section
When to Write an ADR
Any change to the scoring formula or signal weights
Adding or removing analysis modules
Changing the pipeline architecture
Technology choices with long-term implications
Any decision that affects multiple modules
## ADR-NNN: Title of Decision
**Date:** YYYY-MM-DD
**Status:** PROPOSED | ACCEPTED | IMPLEMENTED | DEPRECATED
### Context
What problem or question prompted this decision?
### Decision
What was decided and why?
### Consequences
- Positive consequences
- Negative consequences or trade-offs
02
Governance Documents
Finance & Investment
Energy Procurement Codified expertise for electricity and gas procurement, tariff optimization, demand charge management, renewable PPA evaluation, and multi-facility energy cost management. Informed by energy procurement managers with 15+ years experience at large commercial and industrial consumers. Includes market structure analysis, hedging strategies, load profiling, and sustainability reporting frameworks. Use when procuring energy, optimizing tariffs, managing demand charges, evaluating PPAs, or developing energy strategies.
Finance & Investment
Carrier Relationship Management Codified expertise for managing carrier portfolios, negotiating freight rates, tracking carrier performance, allocating freight, and maintaining strategic carrier relationships. Informed by transportation managers with 15+ years experience. Includes scorecarding frameworks, RFP processes, market intelligence, and compliance vetting. Use when managing carriers, negotiating rates, evaluating carrier performance, or building freight strategies.