architecture.artof.link
Site menu

Adaptive Experience Architecture

Adaptive Experience = Shared Understanding + Domain Services + Outer Harness.

In Plain English: A chatbot should not guess prices or invent inventory. This architecture pairs conversational AI with real store systems (stock, prices, delivery, payment) and an outer harness of checks so orders stay reliable, private, and honest.

This site is the public knowledge surface. It is not a shop, not a CMS, and not a pitch deck.

If this site and the repository docs disagree, docs/02-business-analysis/requirements.md and the ADRs win. This site does not invent requirement IDs.

AI may interpret. Domain services decide. Status words are claims; they need a probe. When the build teaches something, Keep Learning and Apply writes it into the harness before the next loop. External agent-OS learning (autonomy ladder, reversibility approvals, handoff packets, connection≠authority, independent checker) maps onto the six layers in Schema — Agent coordination; terms live in the Glossary. Decision-layer learning (thinking vs deciding; Choice·Score·Gate; rebuild option menus; cost per decision) is in Schema — Decision layer and Glossary. Anthropic Building effective agents learning (Workflow vs Agent; Augmented LLM; five composable workflows; ground truth / measured complexity / ACI) is in Schema — Agentic workflows and Glossary. Holmberg/LangChain harness learning (Model-tier Choice; AutoMode pre-tool Gate; recipe families) extends Schema — Decision layer and Glossary (2026-09-21). Status: Documented until Pages probed — cite as learning, not TypeSafe/Jev, Bot, Anthropic, or LangChain product endorsement; no runtime in the docs MR; CloudAgent held.

Adaptive Experience formula: Shared Understanding + Domain Services + Outer Harness
Path B web workspace and the Android companion share one store backend

The Six Outer Harness Layers

The outer harness wraps around domain services and shared understanding across six layers:

LayerPlain-English JobWhat It Prevents
1. GuidesClear instructions, role boundaries, and playbooksPrevents out-of-scope actions before work begins
2. SensorsAutomated test checks and fail-closed availabilityCatches errors before customers see them
3. LoopInterpret → Act → Verify → RememberStops sprawling tasks: 1 finding → 1 issue → 1 review
4. MemoryPersistent session context across page reloadsSolves AI amnesia without stuffing raw chat history
5. PermissionsStrict controls over who can touch data, funds, or codePrevents unauthorized merges and self-approval
6. ObservabilityReal-time telemetry and proof for every status claimEliminates guesswork; unprobed claims stay Unknown
The six layers of the outer harness

Research papers (2026-10-18)

Canon harness engineering papers on GitLab main under research/pdf-export/ (not shipped in Pages — PDFs stay on GitLab). Dated 2026-10-18 adds section XVIII-N: a "100 tips for a personal AI agent" post (ideas by u/palo888 on Reddit, repackaged by @humzaakhalid), claims unverified; it adds a rule class and reason to Guide Hygiene (#548), a data-freshness rule to Memory and State (#549), parks a devil's-advocate pass (#550) and sharpens #503, #543 and #545 by comment; umbrella #547. Prior tip 2026-10-11 added section XVIII-M: a model-plus-harness survey (arXiv 2606.20683), a Jev re-share and a five-repo agents list, post claims unverified; it adapts Layer/Cause fields on Findings (#543), a task-property table (#544), a confidence-routing policy for the decision layer (#545) and review of third-party skill packs (#546); umbrella #542. Prior tip 2026-10-07 added section XVIII-L: a "300+ AI agents mapped" post and the awesome-ai-agents list, claims unverified. It adapts an Adoption record for new tools and dependencies (#527) and proposes a passive DAST baseline of our own hosts (#528); AI pentesting is parked; umbrella #529. Undated names are the same canon tip. Prior tips: 2026-10-06 two-model search harness (#524–#526), 2026-09-30 r2 Graph Engineering (#509, #510), first 2026-09-30 file (#502–#505), 2026-09-24 Second Brain OS (#489–#495).

Full research

Visual guide

Status: Documented on this site until a post-merge Pages probe. Documented ≠ Live; CloudAgent held; SBOS/Claude, the /advisor feature, graph databases and the tools picked in the 7 Oct post (screenpipe, Cua, Open Interpreter, Strix) are not Path B dependencies. Links point at GitLab blob URLs; do not treat cts-ai copies as the tip.

Explore the Framework & Case Studies

The live flower shop at aea.artof.link is the reference case study. The pages below explain the architecture in plain English, with formal IDs where behavior is cited.