ADRs tagged docs¶
Auto-generated by scripts/docs/generate-adr-by-tag.sh. Edit ADR Tags: lines to update.
154 ADR(s) carry this tag.
| ID | Title |
|---|---|
| ADR-0005 | Adopt full framework adaptation scope a-g |
| ADR-0008 | Rewrite README with fork branding preserving Netflix attribution |
| ADR-0012 | Coding standards stack JPL + CERT + MISRA |
| ADR-0013 | Support full local dev distro matrix |
| ADR-0019 | .workingdir2 is the full planning dossier |
| ADR-0025 | Copyright handling preserves Netflix and adds Lusoris/Claude |
| ADR-0026 | Relocate Python harness workspace under python/vmaf/ |
| ADR-0028 | Every non-trivial decision gets its own ADR file before the commit |
| ADR-0029 | Relocate resource tree under python/vmaf/ |
| ADR-0031 | Fork-added docs live under docs/ |
| ADR-0042 | Tiny-AI PRs must ship human-readable docs in the same PR |
| ADR-0100 | Every user-discoverable change ships docs in the same PR |
| ADR-0105 | Copyright handling preserves Netflix and adds Lusoris/Claude |
| ADR-0106 | Every non-trivial decision gets its own ADR file before the commit |
| ADR-0108 | Every fork-local PR ships the six deep-dive deliverables |
| ADR-0116 | CI workflow naming convention — purpose-named files + Title Case display names |
| ADR-0122 | CUDA gencode coverage + actionable init-failure logging |
| ADR-0124 | Automate enforcement of process ADRs (0100 / 0105 / 0106 / 0108) |
| ADR-0126 | SSIMULACRA 2 perceptual metric as a fork-local feature extractor |
| ADR-0128 | Embedded MCP server in libvmaf — SSE + UDS + stdio transports, build-flag-gated |
| ADR-0129 | Tiny-AI post-training int8 quantisation — static + dynamic + QAT per model |
| ADR-0203 | Tiny-AI training prep — implementation decisions |
| ADR-0221 | CHANGELOG + ADR-index fragment-file pattern |
| ADR-0240 | GPU backend public-header pattern doc (PR3 of GPU dedup, doc-only) |
| ADR-0242 | Tiny-AI training on the original Netflix VMAF training corpus |
| ADR-0257 | MobileSal real-weights swap deferred (T6-2a-followup blocker) |
| ADR-0263 | OSSF Scorecard policy and remediation cadence |
| ADR-0264 | Vulkan 1.4 API-version bump blocked on shader FP-contraction audit |
| ADR-0265 | U-2-Net u2netp saliency replacement blocked on weights distribution + op allowlist |
| ADR-0270 | libFuzzer scaffold for parser surfaces (OSSF Scorecard remediation) |
| ADR-0286 | Fork-trained saliency student saliency_student_v1 on DUTS-TR |
| ADR-0311 | libFuzzer harness expansion — fuzz_yuv_input + fuzz_cli_parse |
| ADR-0335 | Hardware-capability priors for the FR-regressor corpus |
| ADR-0349 | fr_regressor_v3 namespace — reserve _v3plus_features for the next feature-set bump |
| ADR-0364 | saliency_student_v2 — Resize-decoder ablation on the v1 recipe |
| ADR-0386 | ADR Number Collision Prevention — Hook + CI Gate + Helper Script |
| ADR-0403 | mkdocs --strict validation policy — actionable carve-outs |
| ADR-0412 | Fork-local release-artefact mirror scaffold for u2netp.pth (Apache-2.0) |
| ADR-0417 | Tiny-AI Netflix corpus training scaffold — draft PR registration |
| ADR-0430 | Saliency RGB ingest and SSIMULACRA2 public docs |
| ADR-0435 | PR-body pre-push validation hook |
| ADR-0466 | mkdocs strict-mode pre-push hook |
| ADR-0484 | Extend kernel-scaffolding.md with HIP and Metal lifecycle contract |
| ADR-0486 | Codify the three-function GPU backend context-API contract in docs |
| ADR-0491 | Add dedicated docs/metrics/motion.md reference page |
| ADR-0497 | vmaf-tune BBB end-to-end bug cluster (compare / ladder / report) |
| ADR-0498 | vmaf-tune BBB end-to-end v2 bug cluster + explicit-backend semantics |
| ADR-0499 | vmaf-tune ladder must decode container/Y4M references before scoring |
| ADR-0501 | vmaf-tune ladder cross-resolution scoring + report degraded flag |
| ADR-0505 | vmaf-tune ladder container-source encode + full per-CRF sample cloud |
| ADR-0506 | vmaf-tune ladder duration clipping, raw-YUV cross-res decode, CLI exit code |
| ADR-0520 | Wire vmaf --no-reference through to the scoring path |
| ADR-0527 | Accept pre-extracted BVI-DVC YUVs via --bvi-dir |
| ADR-0535 | Atomic ADR Number Allocator with Cross-Branch Claim |
| ADR-0546 | Audit bundle — Vulkan motion dispatch wiring, saliency hard-fail, model-card placeholder |
| ADR-0549 | Audit cleanup bundle 2 |
| ADR-0597 | integer_vif is luma-only across every backend; CUDA enable_chroma is a documented no-op |
| ADR-0608 | Commit .zed/ project configuration for Zed editor parity with .vscode/ |
| ADR-0612 | Tiny-AI training on the original Netflix VMAF training corpus |
| ADR-0616 | VMAF NEG Integration into vmaf-tune |
| ADR-0621 | Scaffold Audit P3 — six cleanup items + state drift |
| ADR-0622 | VMAF NEG Integration Implementation |
| ADR-0623 | Scaffold audit P2 — half-finished implementation fixes |
| ADR-0638 | MCP P1 surface — vmaf-tune integration, list_extractors, describe_model, progress notifications |
| ADR-0639 | Scaffold-audit P1 — backend precheck, HIP picture, mobilesal bpc, DNN multi-output |
| ADR-0640 | Tiny-AI training on the original Netflix VMAF training corpus (2026-05-20 scaffold iteration) |
| ADR-0643 | vmaf-tune Reports Carry Encoder Profiles |
| ADR-0644 | Add vmaf-tune codec runtime variants |
| ADR-0655 | Saliency Feature Materializer |
| ADR-0658 | Project modernization audit |
| ADR-0659 | Modernization audit false-positive filter |
| ADR-0660 | Tiny-AI extractors check DNN availability before model paths |
| ADR-0678 | Shared AI Run Manifest Helper |
| ADR-0682 | Tiny-AI Netflix corpus training scaffold — 2026-05-22 prep scope |
| ADR-0685 | Tiny-AI Netflix corpus training scaffold — 2026-05-27 prep scope |
| ADR-0686 | VMAFX Rebrand and Aggressive Modernization — Umbrella ADR |
| ADR-0712 | IDE config audit and refresh for multi-language post-rebrand VMAFX |
| ADR-0771 | SIMD twin coverage inventory and gap prioritisation |
| ADR-0788 | Doxygen doc-comment and @thread-safety tags on public C-API |
| ADR-0810 | ADR-0108 Six-Deliverables Compliance Audit (2026-05-29) + D3 Gap Fixes |
| ADR-0841 | Environment variable reference page and canonical naming |
| ADR-0848 | Per-Surface Documentation Compliance Audit — Session 2026-05-29 |
| ADR-0861 | Drop "and Claude (Anthropic)" from fork copyright lines |
| ADR-0866 | Wire markdownlint-cli2 into make lint + pre-commit + CI |
| ADR-0901 | Governance file audit — add GOVERNANCE + MAINTAINERS, expand CODEOWNERS, document ADR-0108 in CONTRIBUTING |
| ADR-0905 | .gitignore + .github/workflows/ staleness audit (2026-05-30) |
| ADR-0910 | Project-wide codespell config + sweep policy |
| ADR-0911 | __init__.py export-completeness audit — __all__ + SPDX headers across fork-added Python packages |
| ADR-0913 | Changelog fragment renderer — splice contract is ^## \[, not ^## |
| ADR-0937 | mkdocs ADR nav — per-hundred bucket layout + auto by-tag indexes |
| ADR-0951 | GitHub Actions custom-action and reusable-workflow audit |
| ADR-0953 | Doxygen public-API build is warning-clean |
| ADR-0968 | CI scripts — rebrand-proof assertion-density grep + tempfile EXIT trap in changelog concat (Round 26 audit D.1 + D.2) |
| ADR-0979 | Tombstone: narrowing markdownlint to five rules, rejected |
| ADR-0980 | Markdown-lint full-ruleset discharge — content fixes + per-file scoped disables |
| ADR-0986 | Add PR trigger to docs.yml CI workflow |
| ADR-0995 | Shorten CI workflow and job display names |
| ADR-1000 | Tech-stack badges in README and Go/Rust version pin consistency |
| ADR-1096 | Doxygen @brief/@param coverage for core internal headers |
| ADR-1105 | fr_regressor_v2_ensemble production flip deferred to the one-shot post-RC retrain |
| ADR-1117 | MCP vmaf_score tiny-AI / feature / CTC parameter coverage |
| ADR-1126 | Retire the standalone isort hook; ruff's I rules own import sorting |
| ADR-1127 | Use one independent SemVer release stream |
| ADR-1128 | Make changelog fragments own release cuts |
| ADR-1140 | Route required CI work by measured impact instead of pre-declared path filters |
| ADR-1143 | CUDA and Intel SYCL Backend Gap Closure |
| ADR-1151 | Cut the fork's first release as v1.0.0 on a fresh number line |
| ADR-1152 | Exempt Dependency-Only Bot PRs from Documentation Gates |
| ADR-1154 | AMD ROCm HIP Backend Gap Closure and Extractor Promotion |
| ADR-1166 | Harvest stale upstream Netflix/vmaf reports, verify each against the fork, fix what still bites |
| ADR-1184 | The MCP gRPC control-plane bridge is Go-only |
| ADR-1185 | Per-backend performance baselines are median-of-N, one backend per build dir |
| ADR-1192 | Keep the recorded Netflix benchmark snapshot; do not regenerate it while the GPU paths are broken |
| ADR-1198 | An unknown changelog.d/ subdirectory fails the run instead of warning |
| ADR-1222 | In-code suppressions do not close code-scanning alerts; scope the scan instead |
| ADR-1223 | The CUDA backend requires compute capability 8.0 (Ampere), and CI standardises on CUDA 13.3.1 |
| ADR-1227 | Workflow display names are short labels; the axis list lives in the file |
| ADR-1231 | Container bases and toolchain versions come from one config file |
| ADR-1233 | GitHub generates the release body; CHANGELOG.md keeps an index |
| ADR-1241 | Keep Git hooks independent of installer worktrees |
| ADR-1242 | Require source-owned ADR metadata freshness |
| ADR-1249 | Adopt praetor governance, with lefthook owning the git hooks |
| ADR-1250 | Fork-authored code moves to EUPL-1.2; code that carries someone else's work does not |
| ADR-1255 | Correct the SPDX identifiers PR #1457 does not reach, to the licence this repository already declares |
| ADR-1274 | Make HISS-21 claims replayable and platform-gated |
| ADR-1277 | Separate private state, corpora, and tracked evidence |
| ADR-1287 | Bound the fork CLI tools' open-ended read and retry loops |
| ADR-1291 | A reversal an accepted ADR mandates is declared in the tree, not in the PR body |
| ADR-1294 | Scope the docs build's concurrency group to its ref, not to Pages |
| ADR-1297 | Every check that reports on a pull request is a required context |
| ADR-1303 | Give checklist backlog items explicit stable IDs |
| ADR-1315 | Drive libvmaf public C API Doxygen warnings to zero and fail closed |
| ADR-1335 | Bind research-digest debt to the trusted merge base |
| ADR-1341 | Stage correctness, benchmarking, and retraining across RC1 through RC3 |
| ADR-1345 | Exempt release changelog archives from the large-file gate |
| ADR-1417 | Integer AIM stays the unclipped ratio upstream defines; float AIM stays clipped at 1 |
| ADR-1428 | Exact GPU twins are declared by one fragment file each, not by a shared literal |
| ADR-1429 | vmaf_read_pictures() accepts an index that skips values and documents what the motion scores do |
| ADR-1454 | A large subtree AGENTS.md is a generated index over one page per topic |
| ADR-1492 | Tester image with one report command, hardware reports as tracked files |
| ADR-1507 | The bundled BRISQUE model is used and redistributed under the LIVE release notice as written, not as a research-only exception |
| ADR-1508 | Documentation site generator, charts, diagrams and typography for the redesign |
| ADR-1510 | Collapse the ADR navigation behind the index and tag pages |
| ADR-1512 | Site search covers user pages only; record bodies leave the index |
| ADR-1570 | Tiny models trained on restricted data stay, their cards quote the data's terms, and RC9 retrains them on cleared data |
| ADR-1571 | a GPU dispatch variable is documented only when library code reads it; VMAF_CUDA_DISPATCH is read at extractor init, VMAF_HIP_DISPATCH and its predicate are removed |
| ADR-1685 | A post-1.0 embedding milestone: zero-copy device-frame import with fences, asynchronous window scores, and an unchanged licence |
| ADR-1699 | The root licence files state ADR-1250's terms, and every package manifest declares the licences of the files it ships |
| ADR-2197 | Generated changelog, ADR index and rebase notes are rendered when pull requests land |
| ADR-2200 | The live source ADR-citation bindings are derived from the tree, not recorded |
| ADR-2461 | A lighter deliverables track for small pull requests |
| ADR-2485 | VMAFx keeps its own credits page, generated from a curated list and held to the tree |
| ADR-2689 | sponsorship is recognition only, in four monthly tiers, with one source file for the list |
| ADR-2705 | formulas are TeX rendered by self-hosted KaTeX, checked at build time |