Procedural Knowledge Libraries: Towards Executable (Research) Memory
Hamidah Oderinwale · 2025
Read Procedural Knowledge Libraries: Towards Executable (Research) Memory by Hamidah Oderinwale (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2506-14715.txt.
Introduction
Hamidah Oderinwale, writing alone, proposes procedural knowledge libraries for research in this 2025 paper. Normal libraries store finished papers, the static end of inquiry. The path to those results, with dead ends and choices, usually vanishes into notebooks and memory.
The proposed libraries keep that whole arc in executable, versioned form. Hypotheses, failures, decisions, and retries all sit beside the final output. Notebook users could share reasoning and dropped paths, not just polished charts. A lens-based transform model plus a storage schema frame the design. Oderinwale argues such records would make science easier to repeat, extend, and teach from real process rather than cleaned hindsight.
Catalog record
| CREATOR | Hamidah Oderinwale |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 47 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2506-14715
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
Procedural Knowledge Libraries: Towards Executable (Research) Memory Hamidah Oderinwale Abstract Procedural Knowledge Libraries (PKLs) are frameworks for capturing the full arc of scientific inquiry, not just its outcomes. Whereas traditional libraries store static end products, PKLs preserve the process that leads to those results, including hypotheses, failures, decisions, and iterations. By addressing the loss of tacit knowledge---typically buried in notebooks, emails, or memory---PKLs lay a foundation for reproducible, collaborative, and adaptive research. PKLs provide executable, version-controlled records that contextualize each step of a research process. For example, a researcher using Jupyter notebooks could share not just final outputs, but also the reasoning, discarded approaches, and intermediate analyses that informed them. This work proposes a framework for implementing PKLs within the Jupyter ecosystem, supported by a lens-based transformation model and procedural storage schema. 1 1 1 The author thanks David Spivak and Jinglin Li for their feedback on earlier drafts. Large language models (LLMs) were used to assist with writing, conceptual development, and figure development. “Talk is cheap. Show me the code.” —Linus Torvalds 1 Introduction Many valuable research artifacts are absent from modern libraries—not because they lack importance, but because current systems struggle to accommodate them. Designing a library is a forward-looking endeavor: it requires anticipating how information will be interpreted, reused, and built upon in the future. This work is part of a broader agenda: identifying knowledge worth preserving—especially that which supports reuse and transparency—and rethinking how libraries must evolve to capture it. It builds on prior efforts advocating for the preservation of reasoning and experimentation, not just final outcomes [ 31 ] . Procedural Knowledge Libraries (PKLs) represent a concrete step toward this vision. PKLs are structured, versioned representations of procedural knowledge. They capture not only what was done but also how and why—organized into modular units that can be queried and reused across domain-specific workflows. Capturing a process —a sequence of intentional actions as they unfold—requires real-time documentation that remains aligned with execution. Because steps evolve, goals shift, and edits are made, the most faithful archives treat the process as a dynamic artifact. Effective documentation, then, must go beyond recording outcomes to include the rationale behind them. To illustrate the distinction between process and procedure , and between information and knowledge [ 1 ] , consider the contrast between a lab protocol and a researcher’s notebook. A protocol describes fixed, validated steps; the notebook captures informal observations, failed attempts, and evolving reasoning—the researcher’s working understanding of how to adapt those steps. Put simply: a process is to a protocol as a procedure is to a notebook . Similarly, a recipe lists ingredients and instructions, but a chef draws on procedural knowledge to adjust for taste, freshness, and timing under uncertain conditions [ 34 ] . Or compare a software tutorial with learning an experienced developer’s workflow through pair programming: the tutorial offers a static path, while the workflow reveals how to navigate uncertainty, debug creatively, and optimize using tacit heuristics [ 24 ] . These omissions—of intent, trial-and-error, and tacit judgment—stymie collaboration, reproduce redundant effort, and obscure provenance. PKLs address these gaps by enabling earlier-stage collaboration, structured reuse, and clearer methodological accountability. The goal is to construct documentation that captures procedural knowledge: how next steps were inferred, why paths were abandoned, and what informed decisions beyond the trace—where traces refer to recorded actions. 2 Defining Procedural Knowledge Libraries In considering the impact of PKLs, a question arises: what is documentation? Especially within the context of Procedural Knowledge Libraries, it’s essential to recognize that documentation serves multiple purposes. It can describe the features of an object, provide instructions for its use, or detail its functions. However, in the realm of procedural knowledge, documentation should aim to capture not only the steps involved in a process but also the underlying reasoning, decision points, and adaptations made during its execution. Procedural knowledge refers to an agent’s understanding of how to accomplish specific tasks through structured actions. Unlike conceptual knowledge, which concerns abstract principles and generalizable ideas [ 30 ] , procedural knowledge consists of executable steps tied to concrete outcomes [ 10 ] . I distinguish between procedural information—raw sequences of actions—and true procedural knowledge, which integrates both the steps themselves and their contextual purpose in a domain. Procedural knowledge is inherently goal-oriented—directions gain meaning only in relation to a specific end goal. This contextual grounding supports domain-specific problem solving but limits transferability, as procedures are often internalized through experience rather than explicitly documented. Capturing this knowledge can help preserve tacit expertise that would otherwise be lost. A complete understanding of procedural knowledge requires examining both successful and failed processes. While metrics can evaluate a procedure’s effectiveness, even unsuccessful attempts contain valuable insights for those who can interpret them. This perspective informs our approach to procedural knowledge libraries, where documenting the relationship between methods and outcomes–including dead ends—building more than just repositories, but libraries that can be used to construct maps of problem-solving instances. Procedural knowledge forms the backbone of all goal-directed systems, yet capturing and reusing it remains both challenging and often overlooked. The core difficulty lies in developing encodings that preserve not only the steps executed but also their contextual rationale—transforming raw execution traces into reproducible, interpretable workflows with their underlying reasoning intact [ 17 ] . While some processes follow clearly articulated hypotheses, others may emerge from intuition or ad-hoc judgment. PKLs cannot directly capture tacit knowledge, but the data they contain and the clarity they bring to a process can make it easier to discern between intentional, iterative decisions and outcomes shaped by intuition, serendipity, or accident. This challenge is particularly important because, as psychological research demonstrates, procedural learning is inherently more difficult than conceptual learning [ 9 ] . The implications are universal: whether in scientific research, technical workflows, or organizational operations, the ability to encode, retrieve, and compare procedural knowledge could unlock new paradigms in how one documents, teaches, and builds upon processes. To address this, I propose infrastructure that captures procedural knowledge in its full context—the how and why behind methodological choices—transforming isolated expertise into reusable, composable units. 3 Contributions PKLs serve as containers for domain-specific expertise, designed for transfer and reuse—not just as version trees, but as semantically enriched structures with context-aware annotations on each commit. This paper makes three contributions: (1) it defines Procedural Knowledge Libraries (PKLs) as a framework for capturing and reusing process-level knowledge in computational workflows; (2) it introduces a lens-based abstraction for selective encoding and transformation of procedural units; and (3) it proposes an architecture for PKLs that includes storage for procedural data, a format for procedural “diffs” (patch templates), and a sketch of how procedural data may be queried. PKLs are presented as a conceptual schema, a working prototype, and a candidate standard for representing procedural knowledge—each contribution reflecting a different level of maturity in the framework’s development. This paper targets practitioners, tool builders, and infrastructure designers seeking to expand procedural documentation capabilities. 3.1 Completeness & Reconstruction Completeness in PKLs is relational, not absolute. A PKL artifact is considered complete if a domain-qualified interpreter can reconstruct the procedure in a way that aligns with its original intent. Reconstruction failures may be due to the artifact itself