Sprint 18
Table of Contents
This page documents a sprint (Sprint 18) of ORE Studio. It captures the sprint's mission, current status, and the stories that compose it. For the surrounding context — version goals, sprint order, and product identity — see Version 0.
Mission
Enable end-to-end ORE imports into workspaces, expand supported ORE types, and equip the LLM with a compass tool for orientation.
Goals
- ORE imports into workspaces — users can load ORE input files directly into a workspace and have them processed end-to-end.
- More ORE types — expand the set of ORE instrument/trade types that ORE Studio recognises and can round-trip.
- Compass tool — implement the basic compass skill so the LLM can orient itself in the doc graph and codebase without manual exploration.
- Backlog refinement tooling — build the
backlog-refinerandsprint-plannerskills and recipes to make future sprint planning repeatable.
Status
Stories
For the definitions of the themes see Themes.
Product
| Story | State | Start | End | Description |
|---|---|---|---|---|
| ORE sample data | BACKLOG | 2026-05-24 | Source or generate representative ORE input files for integration testing. | |
| Add support for running ORE samples | DONE | 2026-05-24 | 2026-05-29 | Enable end-to-end execution of ORE sample files from a workspace. |
| Work through all types for ORE Example 1 | BACKLOG | 2026-05-24 | Implement every ORE instrument and market-data type needed for Example 1. | |
| Fix instruments not visible in UI | BACKLOG | 2026-05-24 | Instruments not showing in UI — investigate import/display path and fix. | |
| Qt: instrument creation in TradeDetailDialog | BACKLOG | 2026-05-24 | Create/associate instruments directly from TradeDetailDialog. | |
| Detect and report NATS disconnection | BACKLOG | 2026-05-26 | Client should detect when NATS or backend services drop mid-session and show a connection-lost state with reconnect. | |
| Fix account registration NATS SSL error | BACKLOG | 2026-05-26 | Registration fails with "NATS connect failed: SSL Error"; fix the registration path's NATS/TLS config. |
Tooling
| Story | State | Start | End | Description |
|---|---|---|---|---|
| ores.compass repository compass tool | DONE | 2026-05-24 | 2026-05-24 | Python repository compass: temporal orientation, semantic doc search, agile scaffolding. |
| ores.compass Locate — temporal orientation | DONE | 2026-05-24 | 2026-05-24 | where=/=status: report current version, sprint, and in-flight stories and tasks from the graph. |
| ores.compass Scaffold — agile authoring | DONE | 2026-05-24 | 2026-05-24 | add story/task/sprint/recipe: create agile artefacts from the CLI by calling ores.codegen as a library. |
| Track PRs per task and surface in compass where | DONE | 2026-05-24 | 2026-05-24 | PRs table in task docs; compass where --prs fetches live PR status via gh. |
| Add org-roam index links to compass.org folder entries | DONE | 2026-05-24 | 2026-05-24 | Each folder in compass.org links to its index file; missing index files created. |
| ores.compass Product Backlog — next and deferred listing | BACKLOG | 2026-05-24 | compass backlog lists next/deferred captures with counts, mirroring where in-flight display. |
|
| compass cross-worktree status (global where) | DONE | 2026-05-25 | 2026-05-25 | Show what every git worktree is doing (branch/story/task/PR) so parallel agents don't collide. |
| compass goto: start a unit of work in one command | DONE | 2026-05-25 | 2026-05-25 | One command: fetch main, branch, scaffold linked story+task, print next steps. |
| Compass PR review management | BACKLOG | 2026-05-26 | Add compass review list/reply/resolve subcommands wrapping gh API. | |
| compass goto –kind flag | DONE | 2026-05-28 | 2026-05-28 | Add –kind hotfix to compass goto for hotfix/ branches; update runbook, recipe, docs. |
| Per-sprint capture workflow: individual files and compass integration | DONE | 2026-05-27 | 2026-05-28 | captures/ folder per sprint; compass capture command; wontdo backlog bucket. |
| Fix product-backlog bucket names in scripts and captures | DONE | 2026-05-29 | 2026-05-29 | Update regenerate_backlog_indexes.py, compass.py, captures to use next/deferred instead of near/far. |
Agile
| Story | State | Start | End | Description |
|---|---|---|---|---|
| Product backlog refinement | DONE | 2026-05-24 | 2026-05-24 | Build backlog-refiner and sprint-planner skills/recipes; set sprint 18 mission. |
| Sprint health review — System 2 analysis | DONE | 2026-05-25 | 2026-05-26 | sprint-reviewer skill writes a structured health-check section into sprint.org. |
| Sprint health charts | DONE | 2026-05-26 | 2026-05-26 | Generate daily charts of PRs, commits, story completions, and line churn using gnuplot. |
| Refactor story task lists to a status table | DONE | 2026-05-28 | 2026-05-28 | Replace bullet-list Tasks section in story docs with a Task/State/Start/End/Description table. |
| Sprint theme grouping | DONE | 2026-05-28 | 2026-05-29 | Introduce theme subheadings into sprint.org to group stories by area. |
| Hotfix handling | DONE | 2026-05-28 | 2026-05-28 | Hotfix runbook, branching recipe update, and Hotfixes section in sprint template. |
LLMs
| Story | State | Start | End | Description |
|---|---|---|---|---|
| Port Tufte visualisation skill into ORE Studio | DONE | 2026-05-25 | 2026-05-25 | Convert tufte-viz SKILL and two Tufte reference docs to org-mode; install and catalogue. |
| Runbook support | DONE | 2026-05-26 | 2026-05-26 | Add runbook document type: named composition of recipes for repeatable multi-step operations. |
| Improve LLM runbook and skill tooling | DONE | 2026-05-28 | 2026-05-28 | Add compass skill type, update skill-creation recipe, create run-runbook skill. |
| Document deduplication recipe | DONE | 2026-05-28 | 2026-05-28 | Generalised recipe for merging duplicate docs; applied to duplicate sprint health review runbooks. |
| PlantUML integration: recipe and codegen scaffold | DONE | 2026-05-28 | 2026-05-28 | PlantUML how-to recipe; compass add diagram scaffold; standard licence header convention. |
| Document ORE Studio as an LLM-first system | DONE | 2026-05-28 | 2026-05-28 | LLM-first philosophy page and Claude Code tool page; update llm.org index. |
Documentation
| Story | State | Start | End | Description |
|---|---|---|---|---|
| Build and publish user manual PDF via CMake | DONE | 2026-05-24 | 2026-05-28 | deploy_manual target builds user_manual.org to PDF; commit and link the result. |
| Port domain concept notes to knowledge documents | DONE | 2026-05-25 | 2026-05-25 | Tidy personal finance/ORE domain notes into v2 knowledge docs; align with ORE Studio terms. |
| Doc format cleanup: migrate v1 docs and remove v2 branding | DONE | 2026-05-28 | 2026-05-29 | Audit active docs lacking frontmatter; rename all v2-branded scripts, templates, and docs. |
| System model readability | DONE | 2026-05-26 | 2026-05-28 | Add layer blurbs and table-based component inventory to the system model. |
| Document NATS: technology overview, system integration, and recipes | DONE | 2026-05-26 | 2026-05-26 | NATS knowledge page, system model section, per-component subject tables, and NATS recipes. |
| Add Downloads and Agile nav entries to the site | BACKLOG | 2026-05-25 | doc/downloads.org with release table; Downloads and Agile links in site nav. |
|
| Improve cybernetics documentation | DONE | 2026-05-28 | 2026-05-29 | Add VSM overview page, expand Cybernetic Levels with context and limitations, link compass. |
| Tooling documentation | DONE | 2026-05-28 | 2026-05-29 | Add Tooling section to knowledge.org; developer scripts doc; overhaul compass, sql, lisp, codegen overviews. |
| Add Emacs and org-roam knowledge pages | DONE | 2026-05-28 | 2026-05-28 | Create Emacs, org-roam, and Zettelkasten knowledge pages; expand ores.lisp; update orientation. |
Infrastructure
| Story | State | Start | End | Description |
|---|---|---|---|---|
| Inline org-roam export into ores.lisp | DONE | 2026-05-22 | 2026-05-22 | Vendor org-roam-export.el into ores.lisp so the CI site build is self-contained. |
| Resolve RFL complexity issues | DONE | 2026-05-23 | 2026-05-24 | Permanently resolve MSVC C1202 and Clang expression nesting limits via structural isolation. |
| SQLite CLI quality-of-life setup | DONE | 2026-05-24 | 2026-05-24 | Committed, commented .sqliterc for readable, non-wrapping sqlite3 shell output. |
| Lock down uppercase UUID invariant | DONE | 2026-05-24 | 2026-05-24 | Close the remaining code paths that can emit lowercase UUIDs into the doc graph. |
| ORE Studio Emacs dashboard | DONE | 2026-05-24 | 2026-05-25 | Replace broken per-mode ores.lisp with an env-aware emacs-dashboard console for all dev commands. |
| Remove unused GitHub Actions workflows | DONE | 2026-05-24 | 2026-05-24 | Delete the four dormant Gemini workflows; PR review stays via the gemini-code-assist app. |
| Rebuild org-roam DB independently from CMake | BACKLOG | 2026-05-24 | Extract org-roam sync into .build-org-roam.el; add rebuild_org_roam_db cmake target. |
|
| Move .build-*.el scripts to ores.lisp | DONE | 2026-05-28 | 2026-05-28 | Relocate build scripts from repo root into ores.lisp/src/ with ores- naming. |
Health Review
| # | Date | Day | Overall | Task |
|---|---|---|---|---|
| 1 | 2026-05-25 | day 4 | AMBER | Health review 1 — sprint 18 mid-sprint analysis |
| 2 | 2026-05-26 | day 5 | AMBER | Health review 2 — sprint 18 backlog audit and shape check |
| 3 | 2026-05-29 | day 8 | RED | Health review 3 — sprint 18 close analysis |
Charts
Charts generated via sprint_charts cmake target.
PRs & Commits per Day
Dual-axis bar chart. PRs (left axis) and commits (right axis) per day. A high commits-to-PR ratio may indicate scope creep.
Daily Line Churn
Lines added (green) and deleted (red) per day. Building work produces mostly additions; refactoring produces a mix. Days with no churn may indicate blockers.
PR Cycle Time
Hours from PR open to merge, one bar per PR. Long bars indicate review bottlenecks. Generated only when PR data is available.
Cumulative Stories Done
Line chart tracking stories marked DONE during the sprint. Steady upward slope is healthy; plateauing signals a stall.
Retrospective
(Filled at sprint close.)
Release Notes
See release_notes.org for the full narrative.