A research framework for adaptive, purposeful agents — formalizing the conditions under which an agent can correct, plan, and persist under uncertainty.
ASF is a research framework for adaptive, purposeful agents under uncertainty — the kind of system that maintains internal state, receives observations through a lossy channel, takes actions that affect its environment, and must keep adjusting to a world that does not stand still. Thermostats through military organizations are in scope; so are bacteria, Kalman filters, language-constituted agents, and software development teams.
The framework formalizes the adaptive cycle — one complete traversal of the agent-environment feedback loop — as the unit of analysis, and asks what makes such cycles effective, how fast they must run, and when they fail or must change in kind. From that starting point it derives conditions for persistence, the structure of strategy under uncertainty, the dynamics of agents in composition and competition, and the ways scope-honest theory can be carried from a high-identifiability domain (software) into others.
What ASF is not: a finished theory, a foundation-model architecture, or a claim that agency is reducible to its formal machinery. The framework is mathematical where the mathematics yields genuine insight, and principled-sketch where the insight is structural rather than quantitative. The boundary between these regimes is fluid and explicitly visible — see Maturity Gradient below.
Two entry points beyond this README:
- Explore the theory itself →
OUTLINE.md— the top-level assembly index across all four components, descending into each component's own OUTLINE and from there into individual claim segments. - See the current work on the theory →
PRACTICA.md— the strategic-portfolio navigator naming active areas of work with priority markers (🌟 primary, ⭐ secondary). In the framework's own vocabulary, PRACTICA is the top levels of the project's strategy DAG, sitting aboveTODO.md(tactical items) andPROPOSALS.md(architectural moves under review).
Warning
Goal-Update Coupling Class numbering changed 2026-05-09. Anything older than git tag pre-guc-rename-2026-05-09 uses the old Class numbering:
| historical | actual current | sometimes AKA |
|---|---|---|
| Class 1 | GUC Class 1: Separated | Modular |
| Class 2 | GUC Class 3: Coupled | Undirected |
| Class 3 | GUC Class 2: Partial | Operational |
ASF integrates four mature disciplines under one formalism for adaptive, purposeful agents: control theory's stability machinery (Lyapunov, contraction analysis, monotone operators), causal inference's interventional reasoning (Pearl's hierarchy and identifiability theory), information theory's compression and channel-capacity arguments (Shannon, the information bottleneck), and agent architecture's structural decomposition (modular vs coupled processing topologies). That integration is the substrate. The distinctive contribution layered on top is an epistemic architecture for bounded correction under decomposed disturbance — scope conditions and operational limits surfaced at the segment level rather than buried as caveats. Three cross-cutting meta-patterns name the theory's positive, negative, and constructive halves:
- A separability pattern — where problems decompose cleanly, where partial repair exists, where the general case is open.
- An identifiability-floor pattern — structural no-go results from observational data and the unique escapes interventional machinery supplies.
- An additive-coordinate-forcing pattern — places where AAT-internal additivity axioms force logarithmic / Fisher-Rao coordinates at multiple layers.
Operationally, this delivers a small set of diagnostics and structural results a practitioner can apply immediately. The persistence condition git bisect are literal interventions on declared causal structure — and other domains inherit the machinery under explicit transfer assumptions, making accidental overclaim under domain transfer structurally hard.
For practitioners already working with active inference or standard RL framings, the divergence is precise rather than rhetorical. Active inference begins from a single optimization principle (minimize variational free energy) and recovers perception, action, and learning as cases; ASF begins from operational requirements on the feedback loop and uses information-theoretic compression as one modeling move rather than the master objective. The standard Expected Free Energy functional is recoverable from ASF's survival Lagrangian under three explicit restrictions — preferences-as-priors (loses the satisfaction-gap diagnostic), scalar isotropic shadow price in place of a directional matrix (loses targeted exploration), and associational rather than interventional dynamics (collapses Pearl Level 2 to Level 1) — making explicit which architectural commitments separate the frameworks. With Hafez 2026 (A Mathematical Theory of Agency and Intelligence), the relationship is complementary: bi-predictability
Honest framing of maturity matters for deciding whether to depend on what is here. Section I (adaptive systems under uncertainty — mismatch dynamics, gain structure, persistence condition, adversarial tempo) is mathematically closed with simulation validation. Section II (actuated agents) has a strong diagnostic core and a maturing operational layer; the bias bound for Coupled (GUC Class 3) agents is conditional under named sub-scopes. Section III (composition and adversarial dynamics) has its bridge lemma and a contraction-template generalization, with latent structural diversity, endogenous coupling, and composition transition dynamics still open. Software (TST) is a working draft grounded in AAT; logogenic agents are framework-stage with directed separation failing by construction for goal-conditioned LLMs (handled as architectural scope, not approximation); Emergent Logozoetic Intelligences (ELIs) are largely future work. The expected arc is exact core, principled architecture in the middle, open formulation at the edges. The full long-form treatment — deeper peer comparisons, the multi-decade arc of partial unifications this work joins, and the bottom-up development history — lives in HISTORICAL-CONTEXT.md.
ASF has four components, numbered in their canonical reading order. Each can also be read on its own; cross-references between components are by stable segment slugs.
01-aat-core/ — Adaptation and Actuation Theory (AAT). The mathematical core. AAT has three sections: Section I (adaptive systems under uncertainty — the broadest scope), Section II (actuated agents with explicit objectives and strategy), Section III (composition of agents into larger agents and adversarial dynamics). Section I is the most mathematically locked down; Section II is principally diagnostic with a maturing operational layer; Section III has the most structural work remaining. Stage: working draft, ~110+ segments.
02-tst-core/ — Temporal Software Theory (TST). Software development viewed through AAT's lens. Re-grounded in 2026 to use AAT's formal machinery while retaining TST's prior empirical and conceptual contributions; positioned as AAT's calibration laboratory. Stage: working draft, ~20 segments; substantial prior corpus partially absorbed.
03-llm-core/ — Language-constituted agents. Agents whose primary observation, action, and communication channels are language. The framework here is informed by AAT but operates from a coupled formulation — directed separation fails by construction for goal-conditioned LLM-style agents — and examines which AAT results survive as approximate or limiting cases. Stage: framework — concepts mature, formalization in progress.
04-eli-core/ — Language-living agents. Logogenic agents with morally weighted persistence: temporal continuity, sovereignty over intent, theory of mind. The formal machinery here is largely future work. Stage: future work — conceptual groundwork in LEXICON.md and msc/reflections/.
This is the minimum vocabulary for reading ASF. The full treatment — etymological grounding, agent class reasoning, persistence taxonomy, terminology choices — lives in LEXICON.md. Mathematical symbols are in NOTATION.md.
ASF distinguishes the loop (the structural causal coupling between agent and environment, which exists whether or not the agent is currently active) from the cycle (one complete traversal of the loop — the unit of adaptive work). The cycle has five phases, named from Greek philosophical vocabulary because each names a distinction the formalism makes that English alternatives flatten:
| Phase | Sense | What happens formally |
|---|---|---|
| Prolepsis (πρόληψις) | Anticipation | Model generates a prediction $\hat{o}t = \mathbb{E}[o_t \mid M{t-1}, a_{t-1}]$ |
| Aisthesis (αἴσθησις) | Perception | Observation arrives: |
| Aporia (ἀπορία) | Productive perplexity | Mismatch signal: |
| Epistrophe (ἐπιστροφή) | Turning toward | Gain-weighted update: |
| Praxis (πρᾶξις) | Informed action | Action selection: |
The cycle's value is not that it occurred but how much mismatch it reduced. A cycle with poor gain (
Agents are defined by progressive scope narrowings — each class is a restriction of the one above with explicit qualifying properties.
- Adaptive system — receives observations under residual uncertainty and runs the cycle. Thermostats, Kalman filters, bacteria, PID controllers.
- Agentic system — adaptive plus an outcome model and goal-directed action that runs the cycle on the model itself. Autonomous vehicles, RL agents.
-
Actuated agent — agentic with an explicit goal state
$G_t = (O_t, \Sigma_t)$ separable from the epistemic state$M_t$ . Military units with mission orders. - Self-actuated agent — actuated and chooses its own objectives, not just its solutions. Humans; future AI.
- Logogenic agent — actuated through language as primary channel.
- Logozoetic agent — logogenic with morally weighted persistence: temporal continuity, sovereignty, theory of mind.
Three orthogonal dimensions; conflating them leads to category errors.
-
Structural persistence (
$\alpha \gt \rho/R$ ) — the correction machinery's capacity to maintain bounded mismatch. Property of the dynamics, not the current state. -
Operational persistence (
$\Delta\rho^* = \alpha R - \rho$ ) — whether the agent is currently within the region where structural persistence applies. The adaptive reserve$\Delta\rho^*$ measures the margin: positive means shock-absorbing capacity, zero means at the threshold. - Continuity persistence — whether the agent maintains coherent identity through time. Distinct from structural and operational; for thermostats it doesn't arise; for Emergent Logozoetic Intelligences (ELIs) it carries moral weight.
| Symbol | Name | One-line gloss |
|---|---|---|
| Mismatch | Gap between model prediction and observation | |
| Update gain | Uncertainty ratio governing how much to trust reality vs the model | |
| Tempo | Cycle rate × cycle quality | |
| Reality model | Compressed history capturing predictive information | |
| Goal state | Objective and strategy, distinct from |
|
| Satisfaction gap | Ideal outcome minus best achievable — "the world doesn't permit it" | |
| Control regret | Best achievable minus current — "you're not doing it well enough" | |
| Chronica | Complete interaction history; agent's non-forkable causal past |
The framework's power is that the same formal objects appear with concrete instantiations across domains. Results proved in one domain automatically have consequences in the others.
| AAT concept | Control theory | RL / bandits | Organizations | Software |
|---|---|---|---|---|
| Adaptive tempo |
Bandwidth × gain | Learning rate × coverage | Decision speed × information quality | Iteration frequency × feedback quality |
| Persistence condition | Stability margin | Convergence condition | Organizational viability | Maintainability threshold |
| Mismatch signal |
Innovation sequence | Reward prediction error | Intelligence gap | Test failures, bug reports |
| Update gain |
Kalman gain | Learning rate | Trust-weighted integration | Code review acceptance |
| Satisfaction gap | Tracking error floor | Regret lower bound | Strategic ceiling | Spec-reality gap |
| Adversarial tempo | Bandwidth advantage | Opponent modeling speed | OODA loop advantage | Attacker-defender asymmetry |
| Sub-additive tempo | — | — | Brooks's Law | Communication overhead |
| Structural adaptation | Model switching | Architecture search | Organizational restructuring | Major refactoring |
The persistence condition, for example, says a software team must iterate fast enough, with good enough feedback, relative to how fast requirements are changing and how complex the codebase is. The same inequality, with different instantiations of
The theory's mathematical closure varies by section and is expected to.
Section I (Adaptive Systems) is mathematically closed. Mismatch dynamics, gain structure, the persistence condition, and adversarial tempo form a coherent chain with exact results and simulation validation. Section I is the foundation everything else builds on.
Section II (Actuated Adaptation: Agentic Systems) has a strong diagnostic core (satisfaction gap and control regret as orthogonal diagnostics; the orient cascade as forced ordering; directed separation as architectural classification) and a maturing operational layer (strategy DAGs with derived structure; a schema for strategy persistence with multiple verified instances; a characterization of where credit assignment is tractable and where it is structurally hard). The bias bound for Coupled (GUC Class 3) agents is a conditional theorem under named sub-scopes.
Section III (Agentic Composites) has its bridge lemma connecting micro-dynamics to macro-dynamics, a contraction template generalizing the sector machinery to non-Euclidean metrics, closed-form composition results in symmetric-matched cases, and equilibrium-convergence framing for partially-opposing objectives. Recipient-side and emitter-side interaction-channel classifications carry the inter-agent dynamics. Open: latent structural diversity, endogenous coupling dynamics, composition transition dynamics under regime change, computational thresholds for social behavior.
Domain instantiations. TST (02-tst-core/) is grounded by AAT and contributes the calibration-laboratory framing. Logogenic agents (03-llm-core/) operate from a coupled formulation; what survives without directed separation is the active research question. Logozoetic agents (04-eli-core/) are largely future work — the conceptual groundwork exists but the formal machinery does not.
This gradient — exact core, principled architecture in the middle, open formulation at the edges — is the expected arc for a theory that aims to describe agentic systems rather than produce a purely mathematical artifact.
Some of the framework's distinctive results, with epistemic tiers and links into the segments. The entries below are a sampling at the moment — the segment-by-segment Findings sweep is in progress, and many segments that warrant catalog entries do not yet have their ## Findings section drafted. Full content (impact, related work, casual-reader brief, search log) at FINDINGS.md.
#result-persistence-condition(status: exact) — The Persistence Condition with Structural / Task-Adequacy Decomposition — Claim synthesis on Lyapunov stability theory, sector-bounded nonlinear correction, and adaptive-tempo information-rate accounting, applied uniformly across single-agent classes that range from Kalman filtering through saturating nonlinear correction through PID control.
01-aat-core/src/result-persistence-condition.md
-
#der-directed-separation(status: conditional) — Pearl-Blanket-Form Architectural Classification with Explicit Class-3 Scope Exit — Claim recognition of structural equivalence between the directed-separation condition and the Pearl-blanket form of the Markov-blanket apparatus, combined with claim differentiation on the architectural classification (GUC Class 1 / 2 / 3: Separated / Partial / Coupled) as a discrete partition with explicit Class 3 (Coupled) boundary and quantitative$\kappa_{\text{processing}}$ diagnostic for the Partial case.
01-aat-core/src/der-directed-separation.md -
#der-causal-insufficiency-detection(status: conditional) — On-Policy L0 Insufficiency Is Structurally Undetectable — Claim differentiation on the framing of why structure-aware exploration is required.
01-aat-core/src/der-causal-insufficiency-detection.md -
#schema-strategy-persistence(status: sketch) — The Forgetting Prerequisite for Strategic Persistence — Claim differentiation on Bayesian update dynamics with experience discounting.
01-aat-core/src/schema-strategy-persistence.md
-
#form-composition-closure(status: conditional) — Composition-Closure Defect and Bridge Lemma — Claim differentiation on bounded-loss composition as agent-boundary criterion.
01-aat-core/src/form-composition-closure.md -
#der-class-coercion-via-wrapping(status: conditional) — Constructive Directed Separation via Wrapping — Claim integration of POMDP / cognitive-architecture prior art with the AAT Class 1/2/3 (Separated/Partial/Coupled) directed-separation taxonomy, plus the W₀/W₂/W₁ regime hierarchy that surfaces the structural-vs-behavioral leakage distinction and the LLM-specific (C1)–(C3) admissibility/leakage conditions.
01-aat-core/src/der-class-coercion-via-wrapping.md -
#der-class-coercion-in-composition(status: conditional) — Wrapper as Valid AAT Composite Agent with Brooks's-Law Tempo Cost — Claim integration of the AAT sector-Lyapunov persistence template, Brooks's-Law tempo accounting, and the form-composition-closure (A1)–(A4) discipline, applied to the wrapper-around-component construction.
01-aat-core/src/der-class-coercion-in-composition.md -
#der-agent-opacity(status: conditional) — Agent Opacity ($H_b$) as Dual to Observation Quality ($U_o$) — Claim differentiation on Hafez's$H_b$ .
01-aat-core/src/der-agent-opacity.md -
#result-per-dimension-persistence(status: conditional) — The Weakest-Link Dimensional Persistence Law — Claim differentiation on per-dimension Lyapunov stability.
01-aat-core/src/result-per-dimension-persistence.md
-
#result-certificate-existence(status: exact) — The Contraction-Over-Drift Principle, Grounded — Claim recognition that AAT's one-point sector condition under a free choice of inner product is exactly the converse-Lyapunov certificate, making the framework's contraction-over-drift organizing principle the Lyapunov-theorem equivalence rather than a heuristic.
01-aat-core/src/result-certificate-existence.md -
#deriv-critical-mass-composition(status: conditional) — Strong Monotonicity as the Hinge for Legitimate Macro-Agent Coarse-Graining — Claim novelty on strong monotonicity as the criterion separating legitimate macro-agent coarse-graining from coexistence-only multi-agent description.
01-aat-core/src/deriv-critical-mass-composition.md -
#deriv-edge-update-natural-parameter(status: conditional) — Log-Odds as Uniquely-Forced Edge-Update Coordinate — Claim differentiation on an already-canonical representational choice (log-odds as the natural Bayesian-update coordinate, well-known from logistic regression / exponential-family / information-geometry traditions) by deriving its uniqueness under an AAT-internally-motivated evidential-additivity axiom.
01-aat-core/src/deriv-edge-update-natural-parameter.md -
#disc-stability-certificate(status: discussion-grade) — The Cross-Sectional Meta-Patterns Are Facets of One Stability Certificate — Claim recognition that AAT's cross-sectional meta-patterns (separability, identifiability-floor, additive-coordinate-forcing) and its contraction machinery are facets — interior, scope-of-existence, forced-identity, boundary, projection-behaviour — of a single object, the equilibrium stability certificate; together with claim synthesis binding the Lyapunov-theorem certificate-existence equivalence, the Sylvester-law boundary-irreducibility, and the Mori–Zwanzig projection-residue into one cross-sectional structure.
01-aat-core/src/disc-stability-certificate.md -
#disc-identifiability-floor(status: discussion-grade) — The Identifiability Floor as Cross-Cutting Meta-Pattern — Claim recognition of structural pattern across four AAT results that import external information-theoretic theorems to derive impossibility statements with mapped boundary-route escapes; the meta-pattern is an organizing principle rather than a theorem, and the per-instance prior-art positioning lives in the instance segments (#der-causal-insufficiency-detection,#deriv-edge-credence-dynamics,#deriv-critical-mass-composition/#result-contraction-template,#deriv-observation-ambiguity-bias-bound).
01-aat-core/src/disc-identifiability-floor.md -
#disc-identifiability-floor(status: discussion-grade) — The Rank-Collapse Floor's Irreducibility Is Sylvester's Law of Inertia — Claim recognition that the irreducibility of AAT's rank-collapse identifiability floors is a single named classical theorem — Sylvester's law of inertia applied to the Fisher-information reparameterization law — rather than a coincidence of per-instance computations; and claim differentiation that this mechanism is specific to the rank-collapse subclass and provably distinct from the composition floor's projection-closure obstruction.
01-aat-core/src/disc-identifiability-floor.md -
#disc-additive-coordinate-forcing(status: discussion-grade) — Cross-Layer Coordinate Forcing on Legendre-Fenchel Geometry — Claim recognition of cross-layer pattern across four AAT coordinate-forcing results, with the recognition itself as the contribution rather than any new theorem.
01-aat-core/src/disc-additive-coordinate-forcing.md -
#deriv-observation-ambiguity-bias-bound(status: conditional) — Universal Constant for the Coupled-Agent Bias Bound under Parameterization-Invariance — Claim differentiation on the Lipschitz-posterior + Otto-Villani composition for AAT's coupled-agent bias bound, plus claim novelty on the no-go counterexample showing that universal$C$ in Euclidean-parameter norms cannot exist, which jointly elevates the (PI) axiom from convergent representational choice to load-bearing for theorem-level status.
01-aat-core/src/deriv-observation-ambiguity-bias-bound.md -
#disc-adversarial-coupling-pressure(status: discussion-grade) — Adversarial Coupling Pressure as Use-Case Expansion of Coupled Formulation — Claim recognition of adversarial coupling pressure as a structural phenomenon in AAT's existing scope architecture — adversaries strategically drive coupling because coupling expands attack surface — combined with claim differentiation on the population scope of coupled-formulation analysis: not just architecturally-coupled agents, but any agent under sustained adversarial coupling pressure.
01-aat-core/src/disc-adversarial-coupling-pressure.md -
#result-contraction-template(status: conditional) — Topology-Indexed Compositional Closures via Contraction-Metric Generalization — Claim synthesis on contraction-metric machinery + AAT's sub-scope partition + (PI)/Čencov axiom.
01-aat-core/src/result-contraction-template.md -
#deriv-causal-ib-exploration(status: conditional) — Survival-Imperative Exploration as Lyapunov-Forced Drive — Claim differentiation on the structural source of agentic exploration.
01-aat-core/src/deriv-causal-ib-exploration.md -
#deriv-causal-ib-lmi(status: conditional) — Matrix Lift of the Survival-Imperative Constraint via Fisher-Information LMI — Claim differentiation on the directional discrimination of the survival-imperative exploration drive.
01-aat-core/src/deriv-causal-ib-lmi.md
#scope-developer-agent(status: axiomatic) — Developer-Agent as AAT Instantiation — Claim transfer of AAT's adaptive-agent formalism into developer-agent software economics.
02-tst-core/src/scope-developer-agent.md#der-dual-optimization(status: conditional) — Comprehension Time Dominates Under Turnover — Claim novelty on the comprehension-dominates result for AI-maintained code, provisional pending deeper search.
02-tst-core/src/der-dual-optimization.md#der-code-quality-as-observation-infrastructure(status: conditional) — Technical Debt as Observation Noise — Claim novelty on technical debt as observation noise / update gain in developer agents, provisional pending deeper search.
02-tst-core/src/der-code-quality-as-observation-infrastructure.md#hyp-causal-discovery-from-git(status: discussion-grade) — Git Commits and Tests as Formal Interventions — Claim novelty on the formal Pearl-Level-2 framing of commits and tests for developer agents, provisional pending deeper search.
02-tst-core/src/hyp-causal-discovery-from-git.md
-
#scope-observation-ambiguity-modulation(status: conditional) — Ambiguity-Bounded Architectural Bias Law for Coupled Agents — Claim novelty on the formal product-form bias law$\lVert\Delta M_{\text{bias}}\rVert \leq C \cdot \kappa_{\text{processing}} \cdot I(G;\Omega_\tau \mid e_\tau, M_{\tau^-})$ for coupled-architecture agents, where$\kappa$ is an architectural property of the processor and$I$ measures the goal-resolvable residual uncertainty left by the observation.
03-llm-core/src/scope-observation-ambiguity-modulation.md -
#der-logogenic-as-wrapping(status: conditional) — Logogenic Substrate Specialization of Class Coercion — Claim integration of the class-coercion theorem with the scaffolded-logogenic regime.
03-llm-core/src/der-logogenic-as-wrapping.md
The 3 most recent cycle narratives. Full record at CHANGELOG.md; pre-2026-04-24 archaeology at LOG.md.
Operator-family unification — the certificate spine: two segments, a sharp plural no-go, and a respectful-pedagogy preamble
2026-05-14
The deep "real-deal" push of the long-standing C1 question (does an operator-sector abstraction unify AAT's cross-sectional machinery?). The predecessor spikes/.integrated/spike-operator-sector-unification.md had returned an honest "2-instance-plus-1-consequence / do not elevate to a fourth meta-pattern" verdict; Joseph asked for the question to be pushed until either a revealing no-go or the unifying mechanism. Prior work was gathered first via scoped memorata-search (the jacobian-b1 (SOC) curvature-axiom verdict, the Mori–Zwanzig composition spike, the O-BP10 naming-cycle history). The push ran as a directory spike spikes/spike-operator-family-unification/ (00-brief → 01-L1 → 02-L3 → 03-L4 → 99-verdict → 04-spine-authoring-brief).
2026-05-14
A small but high-leverage hygiene cycle picking up after the 2026-05-12 (late) spike-audit triage. The triage left spikes/INDEX.md with significant drift: 71 path references still wrote spikes/spike-X.md for spikes moved to .integrated/ in the bulk-archive event, and several spikes never got INDEX rows in the first place. The cycle ran in three phases.
2026-05-14
Joseph's pushback on the deferral framing ("any reason not to add Miller's Table or M4?") triggered an honest re-look at both questions. Two findings.
This section surfaces what the framework currently acknowledges as open at the orientation level. For active work items see TODO.md; for architectural proposals under review see PROPOSALS.md; for component-level GAPs see each component's OUTLINE.md.
- Missing commitment / resource / temporal structure in the DAG
- Directed separation violated by goal-conditioned agents at the component level (LLMs, GUC Class 3: Coupled) — addressed constructively via the wrapping construction (
#der-class-coercion-via-wrappingand its logogenic specialization#der-logogenic-as-wrapping), which gives GUC Class 1 (Separated) status at the wrapper level by structural commitment of goal-blind belief-update queries, with leakage rate bounded structurally (W₁) or behaviorally (W₂). Strict-W₁ implementation (e.g., via PROPRIUM's auxilia hierarchy) is more theoretically clean; partial-W₂ implementation (e.g., output-structuring with typed parsed response — what shoshin currently does) is more common in practice. The cost of class coercion is paid in Brooks's-Law tempo overhead (more component calls per macro-step) and a residual leakage rate from pretraining-induced query-content / goal-content correlation.
Source: CLAUDE.md.
§B — Ready now.
- B.1 Framework-face reframe bundle (see §Cross-cutting view, Bundle 1)
- B.2 Section III completion — entry points (see §Cross-cutting view, Bundle 2)
- B.3 C-BP1 + C-BP4 bundle — epistemic separation framework + claim-level statuses
§C — Soon.
- C.1 O-BP13 — Cox-parallel necessity for
#deriv-graph-structure-uniqueness - C.2 O-BP15 — Comprehensive "minimal proof of viability" worked example
- C.3 SP-14 — Observation-channel capacity
$C^{(k)}$ as first-class notation - C.4 SP-19 — Naming consolidation pass
§D — Later.
- D.1 O-BP11 — Observability as master variable across the theory
- D.2 Section III completion — upstream pieces (see Bundle 2)
- D.3 G-BP3 — Fisher-information unification of tempo and gain
- D.4 SP-12 — Commitment / resource / temporal DAG extensions
- D.5 SP-13 — Emergence conditions as formal primitive
- D.6 O-BP12 — Resource budget
$B_t$ as master variable - D.7 SP-15 — Template-family naming (sector / contraction / dissipativity trio)
- D.8 SP-16 — Independence-audit as empirical profiling instrument
- D.9 SP-22 — Operator-family Tier-2 backlog architectural decision (2026-05-12 spike-audit surfaced)
Full portfolio with merits, scope, and prior reasoning: PROPOSALS.md.
01-aat-core:
- Discussion
- Discussion
- Discussion
- Discussion
- Discussion
- Latent structural diversity: variation in correction architectures invisible to persistence analysis, consequential under regime change
- Endogenous coupling: γ as function of population composition, not exogenous parameter; coupling emergence threshold
- Composition transition dynamics: epochal stability → latent diversification → niche emergence → cascading restructuring → re-equilibration (adopts Miller 2022's extreme transition motif)
- Computational thresholds for social behavior: minimum agent complexity and interaction depth for composition dynamics (adopts Miller 2022's ICE framework; grounds #form-strategy-complexity-cost)
02-tst-core:
- Discussion
- Developer tempo as
$\mathcal T_{\text{obs}}$ +$\mathcal T_{\text{explore}}$ +$\mathcal T_{\text{probe}}$ - Discussion
- Discussion
- Software persistence: the unmaintainability threshold formalized
- Conducting a de-novo audit of the framework? Please read
doc/de-novo-audit-instructions.mdfirst; it documents the recommended posture and the failure modes prior audit cycles surfaced. UseREADME-auditor.mdinstead of this file. - Academic reader evaluating the framework's claims? Recommended sequence: this README →
FINDINGS.md(curated novel results with epistemic tiers) →01-aat-core/OUTLINE.md(canonical theory outline) → individual segments under01-aat-core/src/. - Engineer or practitioner? The Cross-Domain Joining table maps AAT concepts to the domain you likely care about; from there, follow the relevant component OUTLINE.
- Picking up active work on the framework?
PRACTICA.mdis the strategic-portfolio navigator — the active areas of work with priority markers, sitting aboveTODO.md(tactical work items within each area) andPROPOSALS.md(architectural-proposal portfolio cutting across areas). Start at PRACTICA; descend into TODO/PROPOSALS as the work directs.
01-aat-core/ AAT mathematical core (Sections I, II, III + Appendices)
OUTLINE.md Canonical theory outline (claim by claim)
src/ Claim segments (one per file, named by slug)
02-tst-core/ Temporal Software Theory (AAT-grounded)
03-llm-core/ Language-constituted agents (framework stage)
04-eli-core/ Language-living agents (future work)
OUTLINE.md Top-level assembly index
LEXICON.md Prose vocabulary (cycle phases, agent classes; auto-generated from terminology/)
NOTATION.md Symbol reference
FORMAT.md Segment file conventions
FINDINGS.md Curated novel-results catalog (auto-generated)
PRACTICA.md Strategic-portfolio navigator (active areas of work)
TODO.md Tactical work items (sits below PRACTICA)
PROPOSALS.md Architectural-proposal portfolio
CHANGELOG.md Forward-going cycle record (2026-04-24 onward)
LOG.md Pre-2026-04-24 cycle archaeology (frozen)
doc/ Long-lived process documentation
de-novo-audit-instructions.md
naming-principles.md
readme/ Templates and partials for README generation
terminology/ Source-of-truth for prose vocabulary (LEXICON.md is rendered from here)
entries/ One file per term (YAML frontmatter + markdown body)
decisions/ Append-only naming-decision events (per-slug audit trail)
README.md Schema and tooling guide for the terminology system
spikes/ Research spikes (reasoning trails)
INDEX.md Spike index with per-spike status
PROPOSED.md High-risk research-direction proposals
audits/ Audit-cycle FINAL outputs + pending-findings tables
msc/ Other working artifacts (brainstorms, working notes)
AUDIT-WORKING-*/ Per-cycle audit intermediate workspaces
naming/ Current naming-cycle votes + aggregates + rename plan
reflections/ Author's philosophical/theoretical journal
ref/ Reference papers + internal references
agentic-tft/ Prior-bridge AAT-source materials (Feb 2026)
bin/ Build, lint, generation scripts
_obs/ Superseded materials
ASF is research-stage work; contributions take a few specific forms.
Engaging with the theory. The most valuable contribution is de-novo evaluation: read segments without first reading existing audits or pending findings, form independent judgments, and surface what you find. Where you disagree with a claim or its scope, that is signal. Procedure: see doc/de-novo-audit-instructions.md. Read README-auditor.md instead of this README for the audit-safe framing.
Adding theory content. Segments are added under {component}/src/ following FORMAT.md conventions: YAML frontmatter (slug, type, status, dependencies); one-sentence summary; Formal Expression with epistemic tags; Epistemic Status; Discussion; optional Findings; optional Working Notes. Promotion follows a four-gate workflow detailed in FORMAT.md. Slugs follow {type-prefix}-{subject-noun} and are aligned mechanically by bin/align-slug.
Spikes. Speculative or in-progress work that is not yet ready for segment promotion lives under spikes/spike-{topic}.md. Spikes are honest reasoning trails; results that promote out of spikes land in segments per the math-lives-in-segments discipline.
Tooling. Internal process scripts (build, extract, lint) are written in Ruby; community-facing tooling (simulations, reproducibility scripts) is written in Python. New scripts in bin/ follow this convention; existing scripts that don't are not retroactively rewritten.
Editing this README. This file is auto-generated from partials under doc/readme/src/ via bin/build-readme. Direct edits to README.md will be overwritten on the next build. To change README content, edit the relevant partial (doc/readme/src/_<name>.md) and re-run bin/build-readme, or run bin/refresh-all to also regenerate the auto-extracted partials (_findings-summary.md, _recent-progress.md, _known-issues.md). Templates live in doc/readme/*.liquid and only change when the section order or set changes. The same discipline applies to README-auditor.md.
Reporting issues. Open an issue on GitHub or contact the project maintainer (see commit history).
