git404hub

what is open-reasoning-format fr?

glaforge/open-reasoning-format — explained in plain English

Analysis updated 2026-05-18

9PythonAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A file-based memory system for AI agents that stores lessons learned as Markdown and YAML files, letting agents retrieve past experiences without needing a database or server.

vibe map

mindmap
  root((repo))
    What it does
      Gives agents file memory
      Stores lessons as files
      No database needed
    How it works
      Lightweight category index
      Metadata inspection
      Full playbook loading
    Tech stack
      Python helper script
      Markdown and YAML
      Agent skill spec
    Use cases
      Reduce agent trial and error
      Persist workarounds
      Benchmark agent performance
    Audience
      AI agent builders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Give an AI agent persistent memory so it avoids repeating past mistakes on similar tasks.

VIBE 2

Benchmark whether stored experience playbooks actually reduce steps and debugging cycles for agents.

VIBE 3

Build an agent that automatically records new learnings after solving a tricky problem.

VIBE 4

Query a lightweight index to find relevant past experiences without loading everything into context.

what's the stack?

PythonMarkdownYAML

how it stacks up fr

glaforge/open-reasoning-formatabhinavshrivastava950/montaraalirezarezvani/promptor
Stars999
LanguagePythonPythonPython
Last pushed2025-09-14
MaintenanceQuiet
Setup difficultymoderatemoderateeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a compatible agent framework to use the manage-experience skill and basic familiarity with Markdown, YAML, and Python CLI tools.

in plain english

The Open Reasoning Format (ORF) is a specification and reference toolkit that gives AI agents a file-based memory system. Instead of relying on vector databases or external servers, agents store and retrieve procedural knowledge, heuristics, and lessons learned from past tasks as plain Markdown and YAML files in a local workspace folder. The project is currently in draft status at version 0.1.0. The core idea is progressive disclosure. When an agent starts a complex task, it first queries a lightweight category index that costs roughly 200 tokens of context. If a category matches the task domain, the agent inspects metadata for relevant experience records, spending another 500 tokens. Only when a specific trigger condition matches does the agent load a full playbook, around 800 tokens, into its working context. This staged approach keeps context usage low while still making detailed operational knowledge available when needed. Each experience record follows a standardized five-section Markdown structure with YAML frontmatter for indexing and trigger conditions. The repository ships with a Python helper script called experiences.py that provides deterministic file operations: listing categories, inspecting metadata, reading a specific record by ID, and creating new records. Creating a new experience involves specifying a domain, title, description, keywords, complexity level, an objective, a trap the agent fell into, an insight gained, a validated solution path, and a checklist item for verification. ORF also includes a pre-built Agent Skill called manage-experience that conforms to the agentskills.io specification. Compatible agent frameworks can discover this skill automatically. The skill guides agents through a two-phase lifecycle: retrieval of past experiences before starting a task, and recording of new learnings after successfully resolving a problem. This means an agent that figures out a tricky workaround can persist that knowledge for future runs. The repository bundles an evaluation harness under the evals directory. This framework runs trajectory benchmarks to measure whether experience playbooks actually improve agent performance by reducing step counts and eliminating trial-and-error debugging cycles. The evals include a sandbox runner, spec validator, isolated scenarios, and exported reports. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
I want to give my AI agent a file-based memory system using the Open Reasoning Format. Show me how to use the experiences.py script to list categories, inspect metadata, and create a new experience record.
prompt 2
Help me integrate the manage-experience agent skill from the Open Reasoning Format into my agent framework so it can retrieve past playbooks before starting a task and record new learnings after solving a problem.
prompt 3
I have the Open Reasoning Format evals directory. Walk me through running the trajectory benchmarks to measure if experience playbooks improve my agent's performance by reducing step counts.
prompt 4
Create a new ORF experience record for my agent that learned a workaround for a tricky API authentication issue. Include domain, title, keywords, complexity, the trap it fell into, the insight gained, a validated solution path, and a verification checklist item.
prompt 5
Explain how the progressive disclosure system in the Open Reasoning Format works: how the 200-token category index, 500-token metadata, and 800-token playbook loading stages keep context usage low for my agent.

Frequently asked questions

what is open-reasoning-format fr?

A file-based memory system for AI agents that stores lessons learned as Markdown and YAML files, letting agents retrieve past experiences without needing a database or server.

What language is open-reasoning-format written in?

Mainly Python. The stack also includes Python, Markdown, YAML.

How hard is open-reasoning-format to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is open-reasoning-format for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.