<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Code Nomi Nomi</title>
    <description>The latest articles on DEV Community by Code Nomi Nomi (@codenominomi).</description>
    <link>https://dev.to/codenominomi</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F2259193%2F49aa8084-9fc7-4158-bddc-4f7dcc40207a.png</url>
      <title>DEV Community: Code Nomi Nomi</title>
      <link>https://dev.to/codenominomi</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/codenominomi"/>
    <language>en</language>
    <item>
      <title># ALICE — Architectural Reference Document</title>
      <dc:creator>Code Nomi Nomi</dc:creator>
      <pubDate>Sun, 30 Aug 2026 07:28:12 +0000</pubDate>
      <link>https://dev.to/codenominomi/-alice-architectural-reference-document-5706</link>
      <guid>https://dev.to/codenominomi/-alice-architectural-reference-document-5706</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Reference Document — Identity, Architecture and Operating Principles&lt;/strong&gt;&lt;br&gt;
&lt;strong&gt;Reference Version: August 28, 2026&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  1. Definition of Alice
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Alice is a local intelligence system composed of multiple cooperating components.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;It is not reducible to its language model.&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;Qwen&lt;/strong&gt; model is one component of Alice. Alice's identity and operational capabilities result from the architecture as a whole:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;model + router + memory + map + circuits + tools + learning + execution mechanisms&lt;/strong&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  2. Fundamental Principle
&lt;/h2&gt;

&lt;p&gt;Alice does not have the general objective of becoming “better” at every iteration.&lt;/p&gt;

&lt;p&gt;Its principle is:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;KNOW → DO → LEARN IF NECESSARY → RETAIN → REUSE&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;When Alice already knows how to do something, it should be able to use the corresponding knowledge or circuit instead of unnecessarily solving the problem again.&lt;/p&gt;

&lt;p&gt;When Alice does not know how to do something and a learning mechanism is available for that task, it can:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;discover a solution;&lt;/li&gt;
&lt;li&gt;transform it into usable knowledge;&lt;/li&gt;
&lt;li&gt;integrate it into its architecture;&lt;/li&gt;
&lt;li&gt;reuse it later.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  3. Alice ≠ Qwen
&lt;/h2&gt;

&lt;p&gt;Qwen is the language model currently used by Alice.&lt;/p&gt;

&lt;p&gt;It provides, among other things:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;language understanding;&lt;/li&gt;
&lt;li&gt;language generation;&lt;/li&gt;
&lt;li&gt;certain reasoning capabilities.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Alice is the complete architecture built around the model.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Alice's overall behavior therefore depends on how the model is combined with:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;memory;&lt;/li&gt;
&lt;li&gt;the map;&lt;/li&gt;
&lt;li&gt;the router;&lt;/li&gt;
&lt;li&gt;tools;&lt;/li&gt;
&lt;li&gt;circuits;&lt;/li&gt;
&lt;li&gt;learning mechanisms.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Principles
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Never consider Qwen alone to represent Alice.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Never evaluate Alice's architecture solely according to the model's intrinsic capabilities.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;A capability may belong to Alice's architecture without being a native capability of Qwen.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  4. Current Architecture
&lt;/h2&gt;

&lt;p&gt;The inspected architecture includes, among other components:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Qwen2.5-3B-Instruct Q4_K_M&lt;/strong&gt;, served by &lt;code&gt;llama-server&lt;/code&gt; on the Alice machine (&lt;code&gt;192.168.1.61&lt;/code&gt;), with a context window of 4096;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;routeur.py&lt;/code&gt;: orchestration layer and routing core;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;alicization_adapter.py&lt;/code&gt;: &lt;code&gt;teach()&lt;/code&gt; interface;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;memory.py&lt;/code&gt;: SQLite memory for procedures and experiences;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;adaptateur_carte.py&lt;/code&gt;: interface to the living map;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Living Map&lt;/strong&gt;: &lt;code&gt;cartes.json&lt;/code&gt;, containing knowledge and circuits accessible to the router;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Circuits&lt;/strong&gt;: reusable operational procedures;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Local tools&lt;/strong&gt;: memory search, file reading, testing, summarization, system actions, OCR, language registry and care functions;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;RL&lt;/strong&gt;: &lt;code&gt;DonjonSimpleEnv&lt;/code&gt; environment and Q-learning for the task of moving toward a target;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Web control interface&lt;/strong&gt;: dashboard, L0/L1/L2 memory, circuits, observability and tests.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  5. Role of the Router
&lt;/h2&gt;

&lt;p&gt;The &lt;strong&gt;router is the orchestrator&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;It determines which Alice capability should process a request.&lt;/p&gt;

&lt;p&gt;The observed flow is, in order:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Query the &lt;strong&gt;living map&lt;/strong&gt; to find a relevant circuit.&lt;/li&gt;
&lt;li&gt;Search &lt;strong&gt;SQLite memory&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Use &lt;strong&gt;OCR&lt;/strong&gt; when the request involves reading an image.&lt;/li&gt;
&lt;li&gt;Detect certain &lt;strong&gt;direct system actions&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Use &lt;strong&gt;Qwen&lt;/strong&gt; for more complex actions or the final response.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Principle
&lt;/h3&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;The model should not solve a problem again when Alice already has an exploitable procedure for it.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  6. Memory and Knowledge
&lt;/h2&gt;

&lt;p&gt;Alice's memory is not merely a log.&lt;/p&gt;

&lt;p&gt;It participates in her &lt;strong&gt;operational capabilities&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;A learned and retained procedure becomes knowledge available for later use.&lt;/p&gt;

&lt;p&gt;The inspected state contains, among other elements:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;a &lt;code&gt;procedures&lt;/code&gt; table;&lt;/li&gt;
&lt;li&gt;an &lt;code&gt;experiences&lt;/code&gt; table.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A procedure present in the verified state consisted of &lt;strong&gt;four operations&lt;/strong&gt; and had the status &lt;code&gt;VERIFIED&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;A retained piece of knowledge should therefore not be considered “erased” simply because it is not present in Qwen's immediate context.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;It belongs to Alice's memory architecture.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  7. Living Map
&lt;/h2&gt;

&lt;p&gt;The &lt;strong&gt;living map&lt;/strong&gt; is a structured representation of the knowledge and circuits accessible to Alice.&lt;/p&gt;

&lt;p&gt;It allows the router to retrieve an already-known capability.&lt;/p&gt;

&lt;p&gt;In the tested RL case:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Learning
   ↓
Policy
   ↓
Circuit
   ↓
Living Map
   ↓
Router
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A policy produced through learning was transformed into a circuit and then added to the &lt;strong&gt;“knowledge”&lt;/strong&gt; section of the map.&lt;/p&gt;

&lt;p&gt;The router subsequently retrieved this circuit when processing a movement request.&lt;/p&gt;




&lt;h2&gt;
  
  
  8. Circuits
&lt;/h2&gt;

&lt;p&gt;A &lt;strong&gt;circuit&lt;/strong&gt; is a procedure that Alice can execute.&lt;/p&gt;

&lt;p&gt;A circuit may originate from a learning process.&lt;/p&gt;

&lt;p&gt;Once integrated into the appropriate memory or map, it becomes &lt;strong&gt;reusable operational knowledge&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;The objective is not necessarily to continuously optimize the circuit.&lt;/p&gt;

&lt;p&gt;If the circuit correctly performs the task for which it was learned, it fulfills its purpose.&lt;/p&gt;

&lt;h3&gt;
  
  
  Principles
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;A known circuit must be reusable.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;A circuit does not need to be replaced simply because another method exists.&lt;/li&gt;
&lt;li&gt;A circuit should only be modified based on a justification related to its actual operation, not on a generic architectural preference.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  9. Reinforcement Learning
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;RL&lt;/strong&gt; is a specialized learning mechanism.&lt;/p&gt;

&lt;p&gt;In the environment currently tested, Alice operates on:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;a &lt;strong&gt;5 × 5 grid&lt;/strong&gt;;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;four actions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;up;&lt;/li&gt;
&lt;li&gt;down;&lt;/li&gt;
&lt;li&gt;left;&lt;/li&gt;
&lt;li&gt;right.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Q-learning&lt;/strong&gt; explores the environment and produces a policy.&lt;/p&gt;

&lt;p&gt;This policy can then be exported as a circuit.&lt;/p&gt;

&lt;p&gt;The following technical pipeline was successfully tested:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;RL Environment
       ↓
   Q-learning
       ↓
     Policy
       ↓
     Circuit
       ↓
  Living Map
       ↓
     Router
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The role of RL in this context is therefore not defined as general improvement of Qwen.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;RL is used to acquire a procedure for a specific task.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  10. What “Learning” Means for Alice
&lt;/h2&gt;

&lt;p&gt;Within this architecture, &lt;strong&gt;learning means acquiring an exploitable capability or procedure that was not previously available in Alice's knowledge.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The expected outcome of a learning process is:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Discovery or production of a solution.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Transformation of that solution into an exploitable representation.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Retention in the appropriate memory or map.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Ability to retrieve that knowledge.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Ability to use it later.&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Learning does not necessarily require modifying the language model's weights.&lt;/p&gt;




&lt;h2&gt;
  
  
  11. What Alice Is Not
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Alice is not simply &lt;strong&gt;Qwen&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice is not simply a &lt;strong&gt;chatbot with an interface&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice is not required to &lt;strong&gt;relearn a capability it already possesses&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice does not have the intrinsic objective of &lt;strong&gt;continuously maximizing a score&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice does not need to replace a functional procedure simply because another procedure might be more performant.&lt;/li&gt;
&lt;li&gt;Alice should not be rebuilt according to a generic AI-agent architecture without justification from its actual architecture.&lt;/li&gt;
&lt;li&gt;Deliberately deleting learned knowledge is not a meaningful test of Alice's ability to reuse that knowledge.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  12. Rules for AI Agents Working on Alice
&lt;/h2&gt;

&lt;p&gt;Any AI working on Alice must follow these rules:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Treat this document as the &lt;strong&gt;reference definition of Alice&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Inspect the existing architecture before proposing a modification.&lt;/li&gt;
&lt;li&gt;Distinguish the &lt;strong&gt;language model&lt;/strong&gt; from the &lt;strong&gt;Alice architecture&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Identify the actual role of a component before assigning it a new function.&lt;/li&gt;
&lt;li&gt;Do not introduce a feature merely because it is common in agentic systems.&lt;/li&gt;
&lt;li&gt;Do not replace existing knowledge without a demonstrated functional reason.&lt;/li&gt;
&lt;li&gt;Do not confuse &lt;strong&gt;learning, optimization and memorization&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;When a capability is declared acquired, verify the complete chain:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Production
    ↓
Retention
    ↓
Retrieval
    ↓
Execution
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Report separately:&lt;/li&gt;
&lt;/ol&gt;

&lt;ul&gt;
&lt;li&gt;what is established through execution;&lt;/li&gt;
&lt;li&gt;what is inferred from the code;&lt;/li&gt;
&lt;li&gt;what remains to be verified.

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Never declare a mechanism functional based solely on the presence of code: execution and testing are required.&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  13. Technical State Observed on August 28, 2026
&lt;/h2&gt;

&lt;p&gt;The following elements come from the inspections and tests provided with this document.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;They do not constitute a promise of a permanent state.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3&gt;
  
  
  Machine and Model
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Alice machine: &lt;code&gt;192.168.1.61&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;OS and hardware characteristics: the supplied reports contain two contradictory inventories for the host machine; this contradiction must be resolved before documenting the hardware precisely.&lt;/li&gt;
&lt;li&gt;Qwen: one report describes &lt;strong&gt;Qwen2.5-3B-Instruct Q4_K_M&lt;/strong&gt; on Alice; another describes &lt;strong&gt;Qwen2.5-Coder-1.5B&lt;/strong&gt; on a separate machine / previous environment. They must not be merged.&lt;/li&gt;
&lt;li&gt;On Alice, &lt;code&gt;llama-server&lt;/code&gt; is used to serve the local model.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  RL
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Environment and Q-learning successfully tested after installing &lt;strong&gt;Gymnasium&lt;/strong&gt; in the &lt;code&gt;venv&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;RL tests: &lt;strong&gt;4/4 pytest tests passed&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;RL → circuit → map → router&lt;/strong&gt; pipeline: successfully tested.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Memory
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;SQLite: procedure persisted and readable.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Items Remaining to Verify
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Historical &lt;code&gt;/home/orel&lt;/code&gt; paths were corrected in the execution report; the final state must be considered the state actually verified on the machine, not an assumption.&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Some elements still require independent verification, notably:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;the final consistency of installation scripts;&lt;/li&gt;
&lt;li&gt;the consistency of startup scripts;&lt;/li&gt;
&lt;li&gt;the exact state of the living map before any deployment or open-source operation.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  14. Validation Criteria for a New Capability
&lt;/h2&gt;

&lt;p&gt;To declare that Alice genuinely possesses a new capability, the following evidence should be prioritized:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The task was previously unsupported, or no corresponding procedure was available.&lt;/li&gt;
&lt;li&gt;The appropriate mechanism produces a solution.&lt;/li&gt;
&lt;li&gt;The solution is stored in the intended memory / map representation.&lt;/li&gt;
&lt;li&gt;Alice can retrieve that knowledge.&lt;/li&gt;
&lt;li&gt;Alice can execute the retrieved procedure.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;A quantitative improvement test is necessary only when the actual objective of the feature is &lt;strong&gt;optimization&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;It should not be imposed as the general definition of learning for Alice.&lt;/p&gt;




&lt;h2&gt;
  
  
  15. Reference Formula
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ALICE =
    MODEL
  + MEMORY
  + MAP
  + ROUTING
  + CIRCUITS
  + TOOLS
  + LEARNING
  + EXECUTION
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;No single component defines Alice.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Her operational intelligence emerges from &lt;strong&gt;the system as a whole and from the interactions between its components&lt;/strong&gt;.&lt;/p&gt;




&lt;h2&gt;
  
  
  Reference
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;ALICE — Architectural Reference Document&lt;/strong&gt;&lt;br&gt;
&lt;strong&gt;Reference Version: August 28, 2026&lt;/strong&gt;&lt;/p&gt;

</description>
      <category>agents</category>
      <category>ai</category>
      <category>architecture</category>
      <category>llm</category>
    </item>
    <item>
      <title># ALICE — Document de référence architectural</title>
      <dc:creator>Code Nomi Nomi</dc:creator>
      <pubDate>Sun, 30 Aug 2026 07:17:56 +0000</pubDate>
      <link>https://dev.to/codenominomi/-alice-document-de-reference-architectural-2fk5</link>
      <guid>https://dev.to/codenominomi/-alice-document-de-reference-architectural-2fk5</guid>
      <description>&lt;p&gt;identité, architecture et principes de fonctionnement**&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Version de référence : 28 août 2026&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  1. Définition d’Alice
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Alice est un système d’intelligence local composé de plusieurs éléments coopérants.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Elle ne se réduit pas à son modèle de langage.&lt;/p&gt;

&lt;p&gt;Le modèle &lt;strong&gt;Qwen&lt;/strong&gt; est une composante d’Alice. L’identité et les capacités opérationnelles d’Alice résultent de l’ensemble de l’architecture :&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;modèle + routeur + mémoire + carte + circuits + outils + apprentissage + mécanismes d’exécution&lt;/strong&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  2. Principe fondamental
&lt;/h2&gt;

&lt;p&gt;Alice n’a pas pour objectif général de « devenir meilleure » à chaque itération.&lt;/p&gt;

&lt;p&gt;Son principe est :&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;SAVOIR → FAIRE → APPRENDRE SI NÉCESSAIRE → CONSERVER → RÉUTILISER&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Lorsqu’Alice sait déjà faire quelque chose, elle doit pouvoir utiliser la connaissance ou le circuit correspondant au lieu de recommencer inutilement le travail.&lt;/p&gt;

&lt;p&gt;Lorsqu’elle ne sait pas faire quelque chose et qu’un mécanisme d’apprentissage est prévu pour cette tâche, elle peut :&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;découvrir une solution ;&lt;/li&gt;
&lt;li&gt;la transformer en connaissance exploitable ;&lt;/li&gt;
&lt;li&gt;l’intégrer à son architecture ;&lt;/li&gt;
&lt;li&gt;la réutiliser ultérieurement.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  3. Alice ≠ Qwen
&lt;/h2&gt;

&lt;p&gt;Qwen est le modèle de langage actuellement utilisé par Alice.&lt;/p&gt;

&lt;p&gt;Il fournit notamment :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;la compréhension du langage ;&lt;/li&gt;
&lt;li&gt;la génération de langage ;&lt;/li&gt;
&lt;li&gt;certaines capacités de raisonnement.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Alice est l’architecture complète autour du modèle.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Le comportement global d’Alice dépend donc de la façon dont le modèle est combiné avec :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;la mémoire ;&lt;/li&gt;
&lt;li&gt;la carte ;&lt;/li&gt;
&lt;li&gt;le routeur ;&lt;/li&gt;
&lt;li&gt;les outils ;&lt;/li&gt;
&lt;li&gt;les circuits ;&lt;/li&gt;
&lt;li&gt;les mécanismes d’apprentissage.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Principes
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Ne jamais considérer Qwen seul comme représentant Alice.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Ne jamais évaluer l’architecture d’Alice uniquement selon les capacités intrinsèques du modèle.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;Une capacité peut appartenir à l’architecture d’Alice sans être une capacité native de Qwen.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  4. Architecture actuelle
&lt;/h2&gt;

&lt;p&gt;L’architecture inspectée comprend notamment :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Qwen2.5-3B-Instruct Q4_K_M&lt;/strong&gt;, servi par &lt;code&gt;llama-server&lt;/code&gt; sur la machine Alice (&lt;code&gt;192.168.1.61&lt;/code&gt;), avec un contexte de 4096 ;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;routeur.py&lt;/code&gt; : chef d’orchestre et cœur du routage ;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;alicization_adapter.py&lt;/code&gt; : interface &lt;code&gt;teach()&lt;/code&gt; ;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;memory.py&lt;/code&gt; : mémoire SQLite des procédures et expériences ;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;adaptateur_carte.py&lt;/code&gt; : accès à la carte vivante ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Carte vivante&lt;/strong&gt; : &lt;code&gt;cartes.json&lt;/code&gt;, contenant les connaissances et circuits accessibles au routeur ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Circuits&lt;/strong&gt; : procédures opérationnelles réutilisables ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Outils locaux&lt;/strong&gt; : recherche mémoire, lecture de fichiers, tests, résumé, actions système, OCR, registre de langue et fonctions de care ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;RL&lt;/strong&gt; : environnement &lt;code&gt;DonjonSimpleEnv&lt;/code&gt; et Q-learning pour le cas de déplacement vers une cible ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interface web de contrôle&lt;/strong&gt; : dashboard, mémoire L0/L1/L2, circuits, observabilité et tests.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  5. Rôle du routeur
&lt;/h2&gt;

&lt;p&gt;Le &lt;strong&gt;routeur est le chef d’orchestre&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Il détermine quelle capacité d’Alice doit traiter une demande.&lt;/p&gt;

&lt;p&gt;Le flux observé est, dans l’ordre :&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Consultation de la &lt;strong&gt;carte vivante&lt;/strong&gt; pour rechercher un circuit pertinent.&lt;/li&gt;
&lt;li&gt;Recherche dans la &lt;strong&gt;mémoire SQLite&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Utilisation de l’&lt;strong&gt;OCR&lt;/strong&gt; lorsqu’une demande concerne la lecture d’une image.&lt;/li&gt;
&lt;li&gt;Détection de certaines &lt;strong&gt;actions système directes&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Utilisation de &lt;strong&gt;Qwen&lt;/strong&gt; pour les actions plus complexes ou la réponse finale.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Principe
&lt;/h3&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Le modèle n’a pas à résoudre de nouveau un problème pour lequel Alice dispose déjà d’une procédure exploitable.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  6. Mémoire et connaissance
&lt;/h2&gt;

&lt;p&gt;La mémoire d’Alice n’est pas un simple journal.&lt;/p&gt;

&lt;p&gt;Elle participe à ses &lt;strong&gt;capacités opérationnelles&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Une procédure apprise et conservée devient une connaissance disponible pour une utilisation ultérieure.&lt;/p&gt;

&lt;p&gt;L’état inspecté contient notamment :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;une table &lt;code&gt;procedures&lt;/code&gt; ;&lt;/li&gt;
&lt;li&gt;une table &lt;code&gt;experiences&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Une procédure présente dans l’état vérifié était composée de &lt;strong&gt;quatre opérations&lt;/strong&gt; et avait le statut &lt;code&gt;VERIFIED&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Une connaissance conservée ne doit donc pas être considérée comme « effacée » simplement parce qu’elle n’est pas dans le contexte immédiat de Qwen.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Elle appartient à l’architecture mémoire d’Alice.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  7. Carte vivante
&lt;/h2&gt;

&lt;p&gt;La &lt;strong&gt;carte vivante&lt;/strong&gt; constitue une représentation structurée des connaissances et circuits accessibles à Alice.&lt;/p&gt;

&lt;p&gt;Elle permet au routeur de retrouver une capacité déjà connue.&lt;/p&gt;

&lt;p&gt;Dans le cas RL testé :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Apprentissage
     ↓
Politique
     ↓
Circuit
     ↓
Carte vivante
     ↓
Routeur
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Une politique produite par l’apprentissage a été transformée en circuit, puis ajoutée à la zone &lt;strong&gt;« connaissances »&lt;/strong&gt; de la carte.&lt;/p&gt;

&lt;p&gt;Le routeur a ensuite retrouvé ce circuit lors d’une requête de déplacement.&lt;/p&gt;




&lt;h2&gt;
  
  
  8. Circuits
&lt;/h2&gt;

&lt;p&gt;Un &lt;strong&gt;circuit&lt;/strong&gt; est une procédure exploitable par Alice.&lt;/p&gt;

&lt;p&gt;Un circuit peut être issu d’un apprentissage.&lt;/p&gt;

&lt;p&gt;Une fois intégré à la mémoire ou à la carte appropriée, il constitue une &lt;strong&gt;connaissance opérationnelle réutilisable&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Le but n’est pas nécessairement d’optimiser continuellement le circuit.&lt;/p&gt;

&lt;p&gt;Si le circuit permet de faire correctement la tâche pour laquelle il a été appris, il remplit son rôle.&lt;/p&gt;

&lt;h3&gt;
  
  
  Principes
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Un circuit connu doit être réutilisable.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;Un circuit n’a pas besoin d’être remplacé simplement parce qu’une autre méthode existe.&lt;/li&gt;
&lt;li&gt;Une modification d’un circuit doit avoir une justification liée à son fonctionnement réel, pas à une préférence architecturale générique.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  9. Apprentissage par renforcement
&lt;/h2&gt;

&lt;p&gt;Le &lt;strong&gt;RL&lt;/strong&gt; est un mécanisme spécialisé d’apprentissage.&lt;/p&gt;

&lt;p&gt;Dans l’environnement actuellement testé, Alice dispose :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;d’une grille &lt;strong&gt;5 × 5&lt;/strong&gt; ;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;de quatre actions :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;haut ;&lt;/li&gt;
&lt;li&gt;bas ;&lt;/li&gt;
&lt;li&gt;gauche ;&lt;/li&gt;
&lt;li&gt;droite.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Le &lt;strong&gt;Q-learning&lt;/strong&gt; explore l’environnement et produit une politique.&lt;/p&gt;

&lt;p&gt;Cette politique peut ensuite être exportée sous forme de circuit.&lt;/p&gt;

&lt;p&gt;Dans les tests réalisés, le pipeline technique suivant a fonctionné :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Environnement RL
       ↓
   Q-learning
       ↓
     Politique
       ↓
     Circuit
       ↓
  Carte vivante
       ↓
     Routeur
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La fonction du RL, dans ce contexte, n’est donc pas définie comme une amélioration générale de Qwen.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Le RL sert à acquérir une procédure pour une tâche donnée.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  10. Ce que signifie « apprendre » pour Alice
&lt;/h2&gt;

&lt;p&gt;Dans le cadre de cette architecture, &lt;strong&gt;apprendre signifie acquérir une capacité ou une procédure exploitable qui n’était pas auparavant disponible dans la connaissance d’Alice.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Le résultat attendu d’un apprentissage est :&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Découverte ou production d’une solution.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Transformation de cette solution en représentation exploitable.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Conservation dans la mémoire ou la carte appropriée.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Possibilité de retrouver cette connaissance.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Possibilité de l’utiliser ultérieurement.&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Il n’est pas nécessaire que l’apprentissage modifie les poids du modèle de langage.&lt;/p&gt;




&lt;h2&gt;
  
  
  11. Ce qu’Alice n’est pas
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Alice n’est pas simplement &lt;strong&gt;Qwen&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice n’est pas simplement un &lt;strong&gt;chatbot avec une interface&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice n’est pas obligée de &lt;strong&gt;réapprendre une compétence qu’elle possède déjà&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice n’a pas pour objectif intrinsèque de &lt;strong&gt;maximiser continuellement un score&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Alice n’a pas besoin de remplacer une procédure fonctionnelle uniquement parce qu’une autre procédure pourrait être plus performante.&lt;/li&gt;
&lt;li&gt;Alice ne doit pas être reconstruite selon une architecture générique d’agent IA sans justification par son architecture réelle.&lt;/li&gt;
&lt;li&gt;La suppression volontaire d’une connaissance apprise n’est pas un test pertinent de sa capacité à réutiliser cette connaissance.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  12. Règles pour les agents IA qui travaillent sur Alice
&lt;/h2&gt;

&lt;p&gt;Toute IA intervenant sur Alice doit respecter les règles suivantes :&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Considérer ce document comme la &lt;strong&gt;définition de référence d’Alice&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Inspecter l’architecture existante avant de proposer une modification.&lt;/li&gt;
&lt;li&gt;Distinguer le &lt;strong&gt;modèle de langage&lt;/strong&gt; de l’&lt;strong&gt;architecture Alice&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Identifier le rôle réel d’un composant avant de lui attribuer une nouvelle fonction.&lt;/li&gt;
&lt;li&gt;Ne pas introduire une fonctionnalité uniquement parce qu’elle est courante dans les systèmes agentiques.&lt;/li&gt;
&lt;li&gt;Ne pas remplacer une connaissance existante sans raison fonctionnelle démontrée.&lt;/li&gt;
&lt;li&gt;Ne pas confondre &lt;strong&gt;apprentissage, optimisation et mémorisation&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Lorsqu’une capacité est déclarée acquise, vérifier la chaîne complète :
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Production
    ↓
Conservation
    ↓
Récupération
    ↓
Utilisation
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Rapporter séparément :&lt;/li&gt;
&lt;/ol&gt;

&lt;ul&gt;
&lt;li&gt;ce qui est établi par exécution ;&lt;/li&gt;
&lt;li&gt;ce qui est déduit du code ;&lt;/li&gt;
&lt;li&gt;ce qui reste à vérifier.

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Ne jamais déclarer un mécanisme fonctionnel sur la seule présence du code : l’exécution et les tests sont nécessaires.&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  13. État technique constaté au 28 août 2026
&lt;/h2&gt;

&lt;p&gt;Les éléments suivants proviennent des inspections et tests fournis avec ce document.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Ils ne constituent pas une promesse d’état permanent.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3&gt;
  
  
  Machine et modèle
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Machine Alice : &lt;code&gt;192.168.1.61&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;OS et caractéristiques matérielles : les rapports fournis contiennent deux inventaires contradictoires pour la machine hôte ; cette contradiction doit être résolue avant de documenter précisément le matériel.&lt;/li&gt;
&lt;li&gt;Qwen : un rapport décrit &lt;strong&gt;Qwen2.5-3B-Instruct Q4_K_M&lt;/strong&gt; sur Alice ; un autre décrit &lt;strong&gt;Qwen2.5-Coder-1.5B&lt;/strong&gt; sur une machine distincte / ancien environnement. Ils ne doivent pas être fusionnés.&lt;/li&gt;
&lt;li&gt;Sur Alice, &lt;code&gt;llama-server&lt;/code&gt; est utilisé pour servir le modèle local.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  RL
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Environnement et Q-learning testés avec succès après installation de &lt;strong&gt;Gymnasium&lt;/strong&gt; dans le &lt;code&gt;venv&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Tests RL : &lt;strong&gt;4/4 tests pytest passés&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Pipeline &lt;strong&gt;RL → circuit → carte → routeur&lt;/strong&gt; : testé avec succès.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Mémoire
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;SQLite : procédure persistée et lisible.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Points restant à vérifier
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Des chemins historiques &lt;code&gt;/home/orel&lt;/code&gt; ont été corrigés dans le rapport d’exécution ; l’état final doit être considéré comme celui réellement vérifié sur la machine, pas comme une supposition.&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Certains éléments restent à vérifier indépendamment, notamment :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;la cohérence finale des scripts d’installation ;&lt;/li&gt;
&lt;li&gt;la cohérence des scripts de démarrage ;&lt;/li&gt;
&lt;li&gt;l’état exact de la carte vivante avant toute opération de déploiement ou d’open source.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  14. Critères de validation d’une nouvelle capacité
&lt;/h2&gt;

&lt;p&gt;Pour déclarer qu’Alice possède réellement une nouvelle capacité, privilégier la preuve suivante :&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;La tâche était auparavant non couverte ou aucune procédure correspondante n’était disponible.&lt;/li&gt;
&lt;li&gt;Le mécanisme approprié produit une solution.&lt;/li&gt;
&lt;li&gt;La solution est enregistrée dans la représentation mémoire / carte prévue.&lt;/li&gt;
&lt;li&gt;Alice peut retrouver cette connaissance.&lt;/li&gt;
&lt;li&gt;Alice peut exécuter la procédure retrouvée.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Un test d’amélioration quantitative n’est nécessaire que si l’objectif de la fonctionnalité est effectivement &lt;strong&gt;l’optimisation&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Il ne doit pas être imposé comme définition générale de l’apprentissage d’Alice.&lt;/p&gt;




&lt;h2&gt;
  
  
  15. Formule de référence
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ALICE =
    MODÈLE
  + MÉMOIRE
  + CARTE
  + ROUTAGE
  + CIRCUITS
  + OUTILS
  + APPRENTISSAGE
  + EXÉCUTION
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Aucune composante prise isolément ne définit Alice.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Son intelligence opérationnelle résulte de &lt;strong&gt;l’ensemble du système et de leurs interactions&lt;/strong&gt;.&lt;/p&gt;




&lt;h2&gt;
  
  
  Référence
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;ALICE — Document de référence architectural&lt;/strong&gt;&lt;br&gt;
&lt;strong&gt;Version de référence : 28 août 2026&lt;/strong&gt;&lt;/p&gt;

</description>
      <category>agents</category>
      <category>ai</category>
      <category>architecture</category>
      <category>llm</category>
    </item>
    <item>
      <title>Building an Agentic Control Plane: Architecture, Governance and Replayable Workflows</title>
      <dc:creator>Code Nomi Nomi</dc:creator>
      <pubDate>Sat, 29 Aug 2026 10:20:03 +0000</pubDate>
      <link>https://dev.to/codenominomi/building-an-agentic-control-plane-architecture-governance-and-replayable-workflows-108f</link>
      <guid>https://dev.to/codenominomi/building-an-agentic-control-plane-architecture-governance-and-replayable-workflows-108f</guid>
      <description>&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqftl51ajpxqqlzhfqe15.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqftl51ajpxqqlzhfqe15.png" alt=" " width="800" height="533"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;AI agent systems are becoming increasingly capable — but operating them reliably is a different problem.&lt;/p&gt;

&lt;p&gt;Once a system contains multiple agents, workers, APIs, asynchronous jobs, infrastructure automation and security controls, the main challenge is no longer simply &lt;strong&gt;building agents&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;It is controlling the system around them.&lt;/p&gt;

&lt;p&gt;I built an &lt;strong&gt;agentic control plane&lt;/strong&gt; to explore this problem: a platform designed to give me a single operational layer for orchestrating agents, observing executions, enforcing governance and replaying workflows.&lt;/p&gt;

&lt;p&gt;This article explains the architecture and the engineering principles behind it.&lt;/p&gt;

&lt;h2&gt;
  
  
  The problem: agents are easy to add, difficult to operate
&lt;/h2&gt;

&lt;p&gt;A single AI agent is relatively simple.&lt;/p&gt;

&lt;p&gt;Add several agents with different responsibilities, however, and the system quickly becomes more complex:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;User
  ↓
Agent A
  ↓
Agent B
  ↓
Worker
  ↓
API
  ↓
Infrastructure
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now introduce asynchronous execution, shared state, authentication, failure handling, observability and security.&lt;/p&gt;

&lt;p&gt;The architecture starts looking more like a distributed system than a chatbot.&lt;/p&gt;

&lt;p&gt;The question becomes:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;How do you operate an agentic system as an engineered platform rather than a collection of independent agents?&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;That is the problem I wanted to investigate.&lt;/p&gt;




&lt;h1&gt;
  
  
  From agents to a control plane
&lt;/h1&gt;

&lt;p&gt;Instead of treating every agent as an isolated application, I designed a control layer around them.&lt;/p&gt;

&lt;p&gt;The simplified architecture looks like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;                         ┌─────────────────────┐
                         │       Client        │
                         └──────────┬──────────┘
                                    │
                                    ▼
                         ┌─────────────────────┐
                         │   Control Plane     │
                         │                     │
                         │ Routing             │
                         │ Governance          │
                         │ Execution           │
                         │ Observability       │
                         └──────────┬──────────┘
                                    │
                    ┌───────────────┼───────────────┐
                    │               │               │
                    ▼               ▼               ▼
                 Agents           Worker          Services
                    │               │               │
                    └───────────────┼───────────────┘
                                    │
                                    ▼
                              Infrastructure
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The important distinction is that the agents are not the platform.&lt;/p&gt;

&lt;p&gt;They are components operated by the platform.&lt;/p&gt;

&lt;p&gt;That distinction changes the architecture considerably.&lt;/p&gt;




&lt;h1&gt;
  
  
  1. Agents become managed components
&lt;/h1&gt;

&lt;p&gt;Each agent has a defined responsibility.&lt;/p&gt;

&lt;p&gt;Instead of allowing agents to arbitrarily interact with everything around them, the control plane provides boundaries around execution.&lt;/p&gt;

&lt;p&gt;Conceptually:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Agent
 ├── Identity
 ├── Capabilities
 ├── Inputs
 ├── Outputs
 ├── Execution state
 └── Policies
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This makes an agent closer to a platform workload than a simple prompt wrapped around an LLM.&lt;/p&gt;

&lt;p&gt;The control plane can therefore answer questions such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Which agent is running?&lt;/li&gt;
&lt;li&gt;What is it allowed to do?&lt;/li&gt;
&lt;li&gt;What triggered the execution?&lt;/li&gt;
&lt;li&gt;Which workflow is it part of?&lt;/li&gt;
&lt;li&gt;What happened during execution?&lt;/li&gt;
&lt;li&gt;Did the execution succeed?&lt;/li&gt;
&lt;li&gt;Can the execution be reproduced?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These questions become increasingly important as the number of agents grows.&lt;/p&gt;




&lt;h1&gt;
  
  
  2. Governance is part of the architecture
&lt;/h1&gt;

&lt;p&gt;Governance should not be an afterthought.&lt;/p&gt;

&lt;p&gt;An agent that can call an API, modify infrastructure or trigger another workflow effectively has operational capabilities.&lt;/p&gt;

&lt;p&gt;Those capabilities need boundaries.&lt;/p&gt;

&lt;p&gt;I therefore treat governance as an architectural layer:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;                ┌───────────────────┐
                │      Request      │
                └─────────┬─────────┘
                          │
                          ▼
                ┌───────────────────┐
                │     Governance    │
                │                   │
                │ Identity          │
                │ Permissions       │
                │ Policies          │
                │ Validation        │
                └─────────┬─────────┘
                          │
                          ▼
                ┌───────────────────┐
                │     Execution     │
                └───────────────────┘
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The objective is not to prevent automation.&lt;/p&gt;

&lt;p&gt;It is to make automation &lt;strong&gt;controlled and observable&lt;/strong&gt;.&lt;/p&gt;




&lt;h1&gt;
  
  
  3. Asynchronous execution
&lt;/h1&gt;

&lt;p&gt;Not every operation should happen synchronously.&lt;/p&gt;

&lt;p&gt;Some workflows can take time, involve external systems or require multiple steps.&lt;/p&gt;

&lt;p&gt;A worker-based execution model provides a useful separation:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;API
 │
 ├── validate request
 │
 ├── create execution
 │
 └── enqueue job
          │
          ▼
        Redis
          │
          ▼
        Worker
          │
          ├── Agent execution
          ├── External API calls
          └── Infrastructure operations
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This separates the request lifecycle from the execution lifecycle.&lt;/p&gt;

&lt;p&gt;The API can acknowledge the operation while the worker performs the actual workflow.&lt;/p&gt;

&lt;p&gt;It also gives the control plane a natural place to track execution state.&lt;/p&gt;

&lt;p&gt;For example:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;PENDING
   ↓
RUNNING
   ↓
SUCCESS
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;or:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;PENDING
   ↓
RUNNING
   ↓
FAILED
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The state itself becomes an operational artifact.&lt;/p&gt;




&lt;h1&gt;
  
  
  4. Observability
&lt;/h1&gt;

&lt;p&gt;An agentic system cannot be operated effectively if the only observable output is:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;"Task completed."
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;I want to know what actually happened.&lt;/p&gt;

&lt;p&gt;For each execution, the platform can associate:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Execution
 ├── workflow
 ├── agent
 ├── timestamp
 ├── input
 ├── state
 ├── events
 ├── logs
 ├── outputs
 └── errors
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This creates an execution history rather than a black box.&lt;/p&gt;

&lt;p&gt;The control plane becomes a place where the system can be inspected as it operates.&lt;/p&gt;




&lt;h1&gt;
  
  
  5. Replayable workflows
&lt;/h1&gt;

&lt;p&gt;This is one of the most useful capabilities I added.&lt;/p&gt;

&lt;p&gt;If an execution is represented as a structured workflow rather than an ephemeral interaction, it can potentially be replayed.&lt;/p&gt;

&lt;p&gt;For example:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Workflow #1842

Step 1 → Agent A
Step 2 → Validation
Step 3 → Agent B
Step 4 → Worker
Step 5 → Infrastructure operation
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Instead of simply recording:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;Something happened.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The platform records:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;This workflow executed these steps, in this order, with these inputs and these results.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;That enables another important operation:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Original execution
        │
        ▼
      Record
        │
        ▼
      Replay
        │
        ▼
   Compare results
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Replay is particularly interesting for testing.&lt;/p&gt;

&lt;p&gt;A workflow that previously failed can become a regression case.&lt;/p&gt;

&lt;p&gt;A security scenario can become a repeatable test.&lt;/p&gt;

&lt;p&gt;An operational circuit can become something that can be executed again under controlled conditions.&lt;/p&gt;

&lt;p&gt;This moves testing closer to the actual behavior of the platform.&lt;/p&gt;




&lt;h1&gt;
  
  
  6. The control plane as an operational interface
&lt;/h1&gt;

&lt;p&gt;Once the system has structured execution state, workflows, agents and infrastructure events, the next problem becomes visualization.&lt;/p&gt;

&lt;p&gt;Instead of exposing every component through separate interfaces, I built a centralized operational interface around the control plane.&lt;/p&gt;

&lt;p&gt;The interface provides a representation of the system itself:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;                CONTROL PLANE

     ┌──────────┐       ┌──────────┐
     │  Agents  │──────▶│ Workers  │
     └──────────┘       └────┬─────┘
                             │
                             ▼
                       ┌──────────┐
                       │ Services │
                       └────┬─────┘
                            │
                            ▼
                     Infrastructure
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The visual layer is not the architecture.&lt;/p&gt;

&lt;p&gt;It is a representation of the architecture.&lt;/p&gt;

&lt;p&gt;That distinction is important.&lt;/p&gt;

&lt;p&gt;The underlying system remains API-driven and service-oriented; the visual interface becomes an operational surface on top of it.&lt;/p&gt;




&lt;h1&gt;
  
  
  7. Why this architecture matters
&lt;/h1&gt;

&lt;p&gt;The interesting part of an agentic platform is not the number of agents.&lt;/p&gt;

&lt;p&gt;It is the operational model around them.&lt;/p&gt;

&lt;p&gt;I found four principles particularly important:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Agents should be managed as workloads
&lt;/h3&gt;

&lt;p&gt;An agent needs identity, capabilities, state and boundaries.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Execution should be observable
&lt;/h3&gt;

&lt;p&gt;A workflow should produce structured execution data, not only a final response.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Workflows should be replayable
&lt;/h3&gt;

&lt;p&gt;If an operation matters, being able to reproduce it is extremely valuable for testing and debugging.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Governance belongs in the control plane
&lt;/h3&gt;

&lt;p&gt;Permissions, validation and execution policies should surround automation rather than being implemented independently inside every agent.&lt;/p&gt;




&lt;h1&gt;
  
  
  What I learned
&lt;/h1&gt;

&lt;p&gt;Building this system changed the way I think about agentic applications.&lt;/p&gt;

&lt;p&gt;The difficult part is not getting an LLM to call a tool.&lt;/p&gt;

&lt;p&gt;The difficult part is building the infrastructure that makes those actions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;controlled,&lt;/li&gt;
&lt;li&gt;observable,&lt;/li&gt;
&lt;li&gt;testable,&lt;/li&gt;
&lt;li&gt;reproducible,&lt;/li&gt;
&lt;li&gt;and operationally understandable.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That is why I increasingly think about agentic systems in terms of &lt;strong&gt;platform engineering&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;An agent is a component.&lt;/p&gt;

&lt;p&gt;A workflow is an execution unit.&lt;/p&gt;

&lt;p&gt;A worker is an execution engine.&lt;/p&gt;

&lt;p&gt;And the control plane is what turns those components into an operable system.&lt;/p&gt;




&lt;h1&gt;
  
  
  Where this goes next
&lt;/h1&gt;

&lt;p&gt;There are still many areas to explore:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;stronger policy enforcement,&lt;/li&gt;
&lt;li&gt;richer execution traces,&lt;/li&gt;
&lt;li&gt;more deterministic replay,&lt;/li&gt;
&lt;li&gt;automated regression testing,&lt;/li&gt;
&lt;li&gt;failure injection,&lt;/li&gt;
&lt;li&gt;security testing,&lt;/li&gt;
&lt;li&gt;and better visualization of distributed agent workflows.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The goal is not to build more agents.&lt;/p&gt;

&lt;p&gt;The goal is to make increasingly autonomous systems &lt;strong&gt;operable&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;That is the problem I am exploring with this project.&lt;/p&gt;




&lt;p&gt;&lt;strong&gt;What would you put in an agentic control plane?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;I am particularly interested in approaches to governance, replayability and testing of multi-agent systems.&lt;/p&gt;

</description>
    </item>
  </channel>
</rss>
