# AffineDrift > Control-affine golf swing research, educational textbooks, and a governed companion catalog for UpstreamDrift models. Read notation and conventions before theory pages; use the programming companion catalog for UpstreamDrift model and engine maps. ## Notation and Conventions ## Repository and Agent Policy - [AGENTS.md](https://github.com/D-sorganization/AffineDrift/blob/main/AGENTS.md): Fleet agent coding standards, CI gates, and Quarto authoring rules for this repository. - [NOTATION.md](https://github.com/D-sorganization/AffineDrift/blob/main/NOTATION.md): Authoritative symbol, sign, and control-affine terminology source for the site registry. ## Notation, Conventions, and Parameters - [Mathematical Notation and Terminology](https://affinedrift.com/pages/notation.html): Rendered NOTATION.md: drift, control, ZTCF/ZVCF, DCR, frames, and overload rules. - [UpstreamDrift Conventions Reference](https://affinedrift.com/pages/upstreamdrift-conventions.html): Pinned per-engine state layout, quaternion order, spatial Jacobian stacking, and gravity at the active UpstreamDrift pin. - [Canonical Parameters Reference](https://affinedrift.com/pages/parameters.html): Parameter symbols, units, and admissible ranges for textbook models. - [Governance Vocabulary Glossary](https://affinedrift.com/pages/glossary.html): Plain-language and technical definitions with stable def-* anchors. - [UpstreamDrift Conventions Reference](https://affinedrift.com/pages/upstreamdrift-conventions.html): Pinned UpstreamDrift state layouts, frames, quaternion order, and analytics sign conventions. ## Theory and Model Maps - [Theory Part 1: Affine Control Interpretation](https://affinedrift.com/articles/theory-part1.html): Primary control-affine state representation; opts in to symbol hover registry. - [Zero-Torque Counterfactual Family](https://affinedrift.com/articles/zero-torque-counterfactual.html): ZTCF constructions (pointwise, stitched, forward, branched) and frozen-plant rules. - [Drift-Control Ratio](https://affinedrift.com/articles/drift-control-ratio.html): Canonical DCR definition, weighting, admissible control set, and regularizer. - [Lagrangian Reference](https://affinedrift.com/articles/lagrangian-reference.html): Derivation of control-affine manipulator dynamics and mass-matrix structure. ## UpstreamDrift Install and Headless Use - [UpstreamDrift: Getting Started](https://affinedrift.com/pages/upstreamdrift-getting-started.html): Clone, mandatory vendor/ud-tools submodule, editable install, verify_installation, and launch commands aligned with upstream README. - [UpstreamDrift: Headless Simulation and Agent Use](https://affinedrift.com/pages/upstreamdrift-headless-and-agents.html): ud-sim CLI, ud-sim-mcp tools, REST /api/v1/simulate boundary, and feature_registry diagnostic for agents. - [UpstreamDrift Engine Protocol](https://affinedrift.com/pages/upstreamdrift-engine-protocol.html): PhysicsEngine counterfactual method names versus AffineDrift ZTCF/ZVCF notation. ## Programming Companion and Engine Protocol - [Programming Companion Index](https://affinedrift.com/models/programming/index.html): Pinned UpstreamDrift companion catalog entry point. - [Engines](https://affinedrift.com/models/programming/engines.html): Physics engine roster, tiers, and equivalency contract references. - [Programs](https://affinedrift.com/models/programming/programs.html): Declared executable programs and surfaces from the pinned companion manifest. - [Workflows](https://affinedrift.com/models/programming/workflows.html): Companion workflow identifiers and governance metadata. - [Provenance](https://affinedrift.com/models/programming/provenance.html): Provider pin, schema version, and acquisition record for the active companion lock. ## Claims and Evidence - [Scientific Claims Ledger](https://affinedrift.com/evidence/claims.html): Human-readable projection of the governed claim registry. - [Claim registry (JSON)](https://affinedrift.com/data/trust/claim_registry.json): Machine-readable claim ids, evidence paths, and adjudication status. ## Machine-Readable Registries - [Symbol registry](https://affinedrift.com/data/symbol_references.json): Equation symbols generated from NOTATION.md - [Canonical pages manifest](https://affinedrift.com/data/agent/canonical_pages.json): Structured list of agent entry pages ## Optional - [Repository README](https://github.com/D-sorganization/AffineDrift/blob/main/README.md): Build commands and local development - [SPEC.md](https://github.com/D-sorganization/AffineDrift/blob/main/SPEC.md): Repository specification and architecture pointers