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.
Listed newest first; the date is the "as of" of the survey, not of the code it describes. Older entries can have been overtaken by later decisions.
| Topic | Document | Date (as of) |
|---|---|---|
| Decision Capture at Dialog Time | Decision Capture at Dialog Time | 2026-10-03 |
| is test selection worth adopting here? (pytest-testmon PoC) | is test selection worth adopting here? (pytest-testmon PoC) | 2026-10-03 |
| Code Abundance — Tao's ICM 2026 Argument Transposed to Coding Agents | Code Abundance — Tao's ICM 2026 Argument Transposed to Coding Agents | 2026-08-30 |
| arc42 as an architecture-level specification layer | arc42 as an architecture-level specification layer | 2026-08-28 |
| Is the level of detail appropriate? | Is the level of detail appropriate? | 2026-08-17 |
| GitHub spec-kit compared against our SDD process (ID-238, BK-343) | GitHub spec-kit compared against our SDD process (ID-238, BK-343) | 2026-08-07 |
| Documentation Content Longevity | Documentation Content Longevity | 2026-07-28 |
| Detecting inconsistency among multiple descriptions of the same thing | Detecting inconsistency among multiple descriptions of the same thing | 2026-07-27 |
| Scope, abstraction, and the placement of detail in durable authoritative texts | Scope, abstraction, and the placement of detail in durable authoritative texts | 2026-07-18 |
| Benchmark Overhead Story — Reproducible Run of Record + User-Decides Framing (ID-230) | Benchmark Overhead Story — Reproducible Run of Record + User-Decides Framing (ID-230) | 2026-07-16 |
llms-full.txt / Markdown-twin tooling for ID-220 (2026 refresh) |
llms-full.txt / Markdown-twin tooling for ID-220 (2026 refresh) |
2026-07-06 |
| DuckLake on Azure for remote-store users | DuckLake on Azure for remote-store users | 2026-07-02 |
| Cross-Backend Concurrency Test Lane (BK-289) | Cross-Backend Concurrency Test Lane (BK-289) | 2026-06-14 |
| User-Expectation-Driven Discovery of Source & Doc Gaps | User-Expectation-Driven Discovery of Source & Doc Gaps | 2026-06-14 |
| Replay-backed example testing for live backends (BK-283) | Replay-backed example testing for live backends (BK-283) | 2026-06-12 |
s3-boto3 backend lane — PoC and disposition |
s3-boto3 backend lane — PoC and disposition |
2026-06-01 |
ID-200 — s3fs error-mapping fidelity in _S3Base |
ID-200 — s3fs error-mapping fidelity in _S3Base |
2026-05-31 |
lx as Tooling for an llms-full.txt / Repo-Context Bundle |
lx as Tooling for an llms-full.txt / Repo-Context Bundle |
2026-05-30 |
| ID-211 — HEAD pre-check for flat-namespace backends | ID-211 — HEAD pre-check for flat-namespace backends | 2026-05-26 |
| Backend Setup & Configuration Guides Expansion | Backend Setup & Configuration Guides Expansion | 2026-05-19 |
| BK-181 PR 2 — S3 cassette/replay infeasibility | BK-181 PR 2 — S3 cassette/replay infeasibility | 2026-05-15 |
| HTTP cassette/replay layer — mechanism PoC (BK-181) | HTTP cassette/replay layer — mechanism PoC (BK-181) | 2026-05-14 |
paramiko ssh-rsa host-key compatibility — empirical findings (BK-198) |
paramiko ssh-rsa host-key compatibility — empirical findings (BK-198) |
2026-05-12 |
| Substrate for Data-Driven Improvement of Agent Workflows | Substrate for Data-Driven Improvement of Agent Workflows | 2026-05-11 |
| SFTPGo — Comparison and Design Insights | SFTPGo — Comparison and Design Insights | 2026-04-24 |
| OBS-003 Hand Decomposition (ID-147) | OBS-003 Hand Decomposition (ID-147) | 2026-04-19 |
| TLA+ PoC — WriteResult Spec Consistency (ID-147b) | TLA+ PoC — WriteResult Spec Consistency (ID-147b) | 2026-04-18 |
| TLA+ Spec Augmentation (ID-147) | TLA+ Spec Augmentation (ID-147) | 2026-04-17 |
| v1.0 Communication & Announcement Plan | v1.0 Communication & Announcement Plan | 2026-04-13 |
| Backend Contract Completeness | Backend Contract Completeness | 2026-04-05 |
| Bug Prevention Beyond Testing | Bug Prevention Beyond Testing | 2026-04-03 |
| OpenRouter.ai Integration for Claude Code Workflow | OpenRouter.ai Integration for Claude Code Workflow | 2026-04-02 |
| Feature Discoverability for Agents and Humans | Feature Discoverability for Agents and Humans | 2026-03-30 |
| Research Round 2: Async Store API vs Current Feature Surface (ID-013) | Research Round 2: Async Store API vs Current Feature Surface (ID-013) | 2026-03-30 |
resolve() Specification Proposal |
resolve() Specification Proposal |
2026-03-29 |
| Testing Best Practices for Long-Term Package Quality | Testing Best Practices for Long-Term Package Quality | 2026-03-28 |
| Depth-Limited Listing | Depth-Limited Listing | 2026-03-26 |
| SQLAlchemy Backends & Composite Store | SQLAlchemy Backends & Composite Store | 2026-03-26 |
| Azure PyArrow Optimization | Azure PyArrow Optimization | 2026-03-24 |
| Benchmark Suite v2 — User-Decision Framing | Benchmark Suite v2 — User-Decision Framing | 2026-03-24 |
| Seekable Read | Seekable Read | 2026-03-24 |
| Store Middleware Architecture | Store Middleware Architecture | 2026-03-17 |
| ID-090 — Docs Landing Page | ID-090 — Docs Landing Page | 2026-03-16 |
| Architecture: Medallion + Dagster Showcase | Architecture: Medallion + Dagster Showcase | 2026-03-15 |
| Read-Only HTTP Backend | Read-Only HTTP Backend | 2026-03-15 |
Dagster Extension (ext.dagster, ID-075) |
Dagster Extension (ext.dagster, ID-075) |
2026-03-13 |
| Google-Style Docstring Migration & Zensical Evaluation | Google-Style Docstring Migration & Zensical Evaluation | 2026-03-13 |
| Store API Refinement | Store API Refinement | 2026-03-12 |
| FastAPI Documentation & CI/CD Patterns | FastAPI Documentation & CI/CD Patterns | 2026-03-10 |
Backend Health Check (store.ping() / backend.check_health()) |
Backend Health Check (store.ping() / backend.check_health()) |
2026-03-09 |
| Example Testing Across Language Ecosystems | Example Testing Across Language Ecosystems | 2026-03-06 |
| Retry Policy Configuration (ID-010) | Retry Policy Configuration (ID-010) | 2026-03-05 |
| Async Store / Backend API (ID-013) | Async Store / Backend API (ID-013) | 2026-03-03 |
| Configuration Loaders and Store Config Patterns | Configuration Loaders and Store Config Patterns | 2026-03-02 |
| Logging, Monitoring & Tracing for remote-store | Logging, Monitoring & Tracing for remote-store | 2026-03-02 |