source docs/techniques/audit-inventory.md · view on GitHub ↗

Audit 2026 Technique Inventory

This is the structured companion to ../audit_2026.md.

audit_2026.md is a prose audit. It mixes defaults, experimental features, flagged alternatives, and a few duplicate mentions where the same method is useful under different conditions. This file makes that treatment explicit.

Inventory Standard

An audit row is not automatically an attempt.

SurfaceMeaningWhere it belongs
Technique rowA method, feature, or implementation surface from audit_2026.mdThis file
Measured experimentA concrete before/after run with evidence, lesson, and next action../attempt-ledger.md
RecipeA concrete application of a method to a target/evalTarget-specific backlog, such as sql-technique-backlog.md
Product cleanupCLI, source layout, or UX simplification workPRD/backlog, not attempt ledger

Coverage Summary

Source: docs/audit_2026.md.

BucketAudit rowsTreatment
Keep/default45Default or required capability, but still needs run-level evidence before quality claims
Experimental8Accessible for learning or future recipes, not default
Flagged30Kept with caveats; use only when the condition matches
Delete0Empty under the stated conviction bar
Tracked audit rows83Row-level inventory, including intentional duplicate mentions

Duplicate / Overlap Notes

Some techniques appear in more than one bucket because the audit records both current utility and future conditions:

TechniqueWhy duplicatedExact treatment
YOCOListed as experimental and also flagged under architecture variantsKeep as long-context memory experiment; not a short-context speed default
BPE-dropoutListed in data-side results and flagged as training-time exoticStable implementation; quality benefit still needs behavioral eval
MoEExperimental architecture and separate measured dense-compute smokeCapacity experiment until sparse dispatch exists
Gradient checkpointingDefault keep at large scale, but scale-dependentUse for memory-bound large runs, not tiny/small defaults

Keep / Default Rows

AreaTechniqueEvidence in auditLedger treatment
TrainingAdamW optimizerOutperformed Lion/Sophia/Muon/Adafactor in 200-step testsTechnique row; optimizer comparison rows stay flagged unless promoted to attempts
Trainingbf16 dtypeMemory + range win; matches flagship trainingTechnique row
TrainingCosine LR + warmupUsed in flagship training runsTechnique row
TrainingGradient clippingPrevents bf16 blowups; no measured downsideTechnique row
TrainingGradient checkpointingBehemoth B=4 ctx=1024 27.7GB -> 17.8GBNormalized in attempt ledger as gradient-checkpointing-mac-training
TrainingSample packing for SFTCoV(length*freq) 0.582 -> 0.061Normalized in attempt ledger as data-perf-sample-packing-bpe-dropout
TrainingPersistent token cache10-30 min saved per re-runTechnique row; not enough standalone run detail here
TrainingCPU speedup bundle5.0 -> 6.8 step/s on small B=16Normalized in attempt ledger as cpu-speedup-bundle
TokenizationBPE via smollm2Used for real-text trainingTechnique row
TokenizationByte-level vocab=256Powers browser galleryTechnique row
TokenizationHFTokenizer wrapperLoads HF-family modelsTechnique row
AlignmentSFT with response maskingChatML, Alpaca, Llama, plain templates workTechnique row
AlignmentDPOSmoke tested; loss convergesTechnique row
AlignmentSimPOReference-free, lower memoryTechnique row; failed SQL hygiene SimPO is a separate attempt
AlignmentORPOMerges SFT + DPO stageTechnique row
AlignmentKTOSingle-side feedback pathTechnique row
PEFTLoRAStandard base adapterTechnique row
PEFTDoRA5-10% better than LoRA at same rank in smokeTechnique row
PEFTLoRA-FAHalves trainable paramsTechnique row
PEFTLoRA+B-LR multiplier verifiedTechnique row
PEFTNEFTunePaper-backed one-line SFT win; smoke testedTechnique row
PEFTAdapter file format.lora round-trip safetyTechnique row
PEFTMulti-LoRA compositionComposition implementation existsSQL static composition failure is normalized separately
InferenceKV cache470 vs 209 tok/s on flagshipTechnique row; later KV optimization bundle normalized
InferenceKIVI int8 KV100% greedy-prefix match vs fp32 on flagshipNormalized in attempt ledger as streamingllm-kivi-cache-compression
InferencePrefix cachingSystem-prompt reuseNormalized in attempt ledger as kv-cache-optimization-bundle where measured
InferenceStreamingLLM sinkQuality preserved at 500 tokensNormalized in attempt ledger as streamingllm-kivi-cache-compression
InferenceSpeculative decoding, vanilla draftStandard decode technique worksTechnique row; Medusa/EAGLE heads normalized separately
InferenceHF model loadingLoads Qwen, Llama, Mistral, PhiTechnique row
InferenceAWQ readerLoads AWQ-quantized HF modelTechnique row
InferenceANE Core ML inference path365 tok/s on Shakespeare via Core MLTechnique row; parked unless deploy path reactivates
InferenceOpenAI-compatible HTTP serveCurl-tested; lm-eval-harness compatibleTechnique row
Eval/benchposttrainllm evalPerplexity 4.71 on flagship matches valTechnique row
Eval/benchposttrainllm benchTTFT 1.91ms, 794 tok/s on ShakespeareTechnique row
Eval/benchposttrainllm score-bench + manifest patcherBrowser leaderboard pipeline worksTechnique row
Eval/benchlm-evaluation-harness HTTP adapterOpenAI-compatible serve verifiedTechnique row
Quality40 XCTestsCI gate with core coverageTechnique row
Qualityswiftformat + CI lint0 violations on 76 filesTechnique row
QualityCrash-recovery testsSIGTERM-race verifiedTechnique row
QualityGitHub Actions CIMac + Ubuntu runnersTechnique row
InfrastructureAtomic save-every + resumeSIGINT pause of v5 demonstratedTechnique row
InfrastructureOOMGuardPre-flight memory aborts doomed configsTechnique row
Web playgroundWebGPU + WASM browser trainingGallery models trained in browserBrowser/product attempts normalized where concrete
Web playgroundDynamic doc routeDocs web-visibleFactory/docs enforcement surface
Web playgroundLeaderboard pageScored entries existTechnique row

Experimental Rows

TechniqueAudit reasonTreatment
MoEPedagogical paper reimplementationNormalized dense-compute smoke; future sparse dispatch needs new attempt
DistillationStandard, not used at scaleCandidate method for agent factory recipes
Magpie synthetic data generationUseful for future agent tracesFuture data method, not attempted here
Evolution StrategiesResearch curiosityParked learning/research surface
Tuned lensEducational interpretability toolReference/learning surface
Logit lens / attention heatmap / activation patching / layer ablationEducational interpretability toolsReference/learning surface
YOCOLong-context cache halvingNormalized smoke; future long-context gate needed
Sliding window attentionBounded long-context attentionFuture long-context method

Flagged Rows

AreaTechniqueTested / observedWhen useful
OptimizerLion200 steps tiny; loss 3.18 vs AdamW 2.62Longer convergence runs
OptimizerSophia200-step Sophia-light; slightly behind AdamWFull Sophia variant may differ
OptimizerMuonTiny preset; 5.2 vs 16.3 step/sLarger models where overhead amortizes
OptimizerAdafactorHuge preset 50 steps; 2x slower but lower state memoryBig memory-bound training
ArchitectureDiffAttention22M smoke; no measured benefitLarger or long-context reasoning runs
ArchitectureMoD soft routingNo compute savingsHard top-k plus scatter_add
ArchitectureMTPSmoke train; marginal regularizationMuch larger bases
ArchitectureALiBiNot tested at long contextContext extrapolation
ArchitectureSliding window attentionNot tested above ctx 4kLong agent histories
ArchitectureYOCO-51% cache, -12% short-context decodeLong contexts above short-ctx crossover
StabilityDeepNormUntested in flagship runsVery deep networks
StabilityLayer-wise LR decayNot wired to a real runFine-tuning specialists
StabilityEmbedding RMSNormv4/v5 with step-1 spike plus small liftNeeds longer controlled comparison
Training exoticGaLore100-step loss descends; memory win unrealizedOptimizer-state surgery lands
Training exoticBPE-dropout100 steps; regularization costRobustness evals
PEFT variantVeRA30 steps; 512x fewer trainable paramsMany-specialist factory
PEFT variantLoftQ30-step simulated int4 initReal int4 base model exists
PEFT variantAdaLoRA30-step importance scoringRank reallocation implemented
PEFT variantRsLoRAScale appliedHigh rank adapters
PEFT variantPISSA initFaster early convergenceSFT default candidate
PEFT variantLayerDropDegraded fine-tune qualityPretraining at depth
QuantizationSmoothQuantCalibration works; no float matmul gainint8 matmul kernel lands
QuantizationHQQ storage-onlyRoundtrip shrinks file; no runtime winPacked int4 matmul kernel
QuantizationGPTQ from-scratchRel error 0.1064; loads and samplesOwn-model export path
QuantizationQAT30-step loss descends; qat-err boundedint4/int8 specialist deployment
PruningUnstructured pruning50% sparsity; gzip -38%Download-size only until sparse matmul
PruningStructured head pruningDrop 4/8 heads; quality degradesPhysical removal implemented
PruningStructured layer pruning9.6M -> 8.0M, coherent samplesReal topology/wallclock path
Spec headsMedusa heads50 head-train steps; 21-23% acceptanceLong head training with production recipe
Spec headsEAGLE-250 head-train steps; 26.5% acceptanceLong head training with production recipe

Delete Rows

The delete bucket is intentionally empty in audit_2026.md.

The actionable cleanup is not source deletion. It is:

  1. Inline AUDIT FLAG notes at entry points.
  2. CLI curation into simple defaults plus experimental flags.
  3. Help text and docs that present one recipe per capability.

Those are product cleanup tasks, not attempt records.