eric/notarius
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add a staged implementation plan for MVP

Browse Source
This commit is contained in:
Eric Rakestraw
2026-07-03 19:33:53 -05:00
parent 0a4a29a2df
commit 07b3264b6b
10 changed files with 1052 additions and 1196 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
docs/roadmap/initial-architecture.md
View File

@@ -546,10 +546,10 @@ Reuse these architectural patterns:
- validator decision cardinality and deterministic validator ordering;
- CLI tests and fixture-driven integration tests.
The fixture-driven integration-test pattern should begin at checkpoint 3 with a
walking skeleton over fake modules and a fake LLM client. Later checkpoints
should replace fake pieces with real Seriatim, runtime, and D&D modules without
losing that end-to-end contract coverage.
The fixture-driven integration-test pattern should remain part of the codebase:
walking skeleton tests over fake modules and fake LLM clients should be
preserved as real Seriatim, runtime, and D&D modules are added, so the
end-to-end contract coverage is not lost.
Avoid copying these Audita concepts directly:
@@ -565,23 +565,13 @@ extraction-report concepts.
## Checkpoint Roadmap
The initial implementation should proceed through six coherent checkpoints.
Each checkpoint should leave the repository in a reviewable state, with the code
compiling and targeted tests covering the newly introduced contracts or behavior.
The initial six checkpoint roadmap has been implemented and retired. The
checkpoint files have been removed from `docs/roadmap/` so the active roadmap
does not compete with completed implementation history.
1. [Core Contracts And Skeleton](1-core-contracts-and-skeleton.md)
2. [Framework Composition](2-framework-composition.md)
3. [Pipeline Stages, Chunking, Merge, And Normalize](3-pipeline-stages-chunking-merge-normalize.md)
4. [Portable Audita Infrastructure](4-portable-audita-infrastructure.md)
5. [Seriatim Input Module](5-seriatim-input-module.md)
6. [D&D Spells Extractor](6-dnd-spells-extractor.md)
The first contract-level walking skeleton should arrive at checkpoint 3: fixture
input through fake input, chunk, extract, merge, normalize, and output modules
with a fake LLM client. The first useful vertical slice should arrive at
checkpoint 6: Seriatim transcript input to validated D&D spell artifact output.
Earlier checkpoints remain contract-first and may not produce useful user output
yet.
The remaining work needed to reach the first functional MVP is tracked in
[`mvp.md`](mvp.md). Future staged implementation plans should be written to
[`implementation.md`](implementation.md) from that active MVP roadmap.
## Architecture Decisions