Skip to content

Research

Before specifying a feature, we research the design space: compare libraries, evaluate trade-offs, and prototype approaches. The resulting documents are presented here for readers who want to understand why a particular direction was chosen — or who face similar decisions in their own projects.

Topic Document
Substrate for Data-Driven Improvement of Agent Workflows Substrate for Data-Driven Improvement of Agent Workflows
Research Round 2: Async Store API vs Current Feature Surface (ID-013) Research Round 2: Async Store API vs Current Feature Surface (ID-013)
Async Store / Backend API (ID-013) Async Store / Backend API (ID-013)
Azure PyArrow Optimization Azure PyArrow Optimization
Backend Contract Completeness Backend Contract Completeness
Backend Setup & Configuration Guides Expansion Backend Setup & Configuration Guides Expansion
Benchmark Suite v2 — User-Decision Framing Benchmark Suite v2 — User-Decision Framing
HTTP cassette/replay layer — mechanism PoC (BK-181) HTTP cassette/replay layer — mechanism PoC (BK-181)
BK-181 PR 2 — S3 cassette/replay infeasibility BK-181 PR 2 — S3 cassette/replay infeasibility
paramiko ssh-rsa host-key compatibility — empirical findings (BK-198) paramiko ssh-rsa host-key compatibility — empirical findings (BK-198)
Bug Prevention Beyond Testing Bug Prevention Beyond Testing
Dagster Extension (ext.dagster, ID-075) Dagster Extension (ext.dagster, ID-075)
Depth-Limited Listing Depth-Limited Listing
Documentation Content Longevity Documentation Content Longevity
ID-090 — Docs Landing Page ID-090 — Docs Landing Page
Example Testing Across Language Ecosystems Example Testing Across Language Ecosystems
FastAPI Documentation & CI/CD Patterns FastAPI Documentation & CI/CD Patterns
Feature Discoverability for Agents and Humans Feature Discoverability for Agents and Humans
Google-Style Docstring Migration & Zensical Evaluation Google-Style Docstring Migration & Zensical Evaluation
Backend Health Check (store.ping() / backend.check_health()) Backend Health Check (store.ping() / backend.check_health())
OBS-003 Hand Decomposition (ID-147) OBS-003 Hand Decomposition (ID-147)
TLA+ Spec Augmentation (ID-147) TLA+ Spec Augmentation (ID-147)
TLA+ PoC — WriteResult Spec Consistency (ID-147b) TLA+ PoC — WriteResult Spec Consistency (ID-147b)
ID-211 — HEAD pre-check for flat-namespace backends ID-211 — HEAD pre-check for flat-namespace backends
Logging, Monitoring & Tracing for remote-store Logging, Monitoring & Tracing for remote-store
lx as Tooling for an llms-full.txt / Repo-Context Bundle lx as Tooling for an llms-full.txt / Repo-Context Bundle
Architecture: Medallion + Dagster Showcase Architecture: Medallion + Dagster Showcase
OpenRouter.ai Integration for Claude Code Workflow OpenRouter.ai Integration for Claude Code Workflow
Read-Only HTTP Backend Read-Only HTTP Backend
resolve() Specification Proposal resolve() Specification Proposal
Retry Policy Configuration (ID-010) Retry Policy Configuration (ID-010)
s3-boto3 backend lane — PoC and disposition s3-boto3 backend lane — PoC and disposition
ID-200 — s3fs error-mapping fidelity in _S3Base ID-200 — s3fs error-mapping fidelity in _S3Base
Seekable Read Seekable Read
SFTPGo — Comparison and Design Insights SFTPGo — Comparison and Design Insights
SQLAlchemy Backends & Composite Store SQLAlchemy Backends & Composite Store
Store API Refinement Store API Refinement
Configuration Loaders and Store Config Patterns Configuration Loaders and Store Config Patterns
Store Middleware Architecture Store Middleware Architecture
Testing Best Practices for Long-Term Package Quality Testing Best Practices for Long-Term Package Quality
v1.0 Communication & Announcement Plan v1.0 Communication & Announcement Plan