Document project architecture and development methodology

- add AGENTS.md with development and prompt-engineering rules
- add PROJECT_KNOWLEDGE.md summarizing current architecture and findings
- add CHANGELOG.md
- add ROADMAP.md
- establish experiments.md as the project's experiment log
- document Canonical Meeting Knowledge architecture
- document Output Views and Knowledge Objects
- capture accepted experimental results and engineering methodology
This commit is contained in:
2026-07-31 08:25:16 +02:00
parent 5c03ed7efd
commit 09d125e54a
5 changed files with 1478 additions and 0 deletions
+47
View File
@@ -0,0 +1,47 @@
# Changelog
## Unreleased
### Added
- Initial Meeting Lab project structure with source, docs, prompts, samples and
tests directories.
- Deterministic transcript normalization module.
- Technical transcript chunking with block-aligned chunk generation.
- Whisper JSON cleanup support.
- Local Ollama-based chunk extraction flow.
- Interim Markdown meeting protocol builder for technical validation.
- Initial and windowed topic segmentation prototypes plus review tooling.
- Gold Standard extraction corpus and gold-test runner.
- Prompt loading support and common/decision prompt baseline.
- Output-view architecture documentation for Canonical Meeting Knowledge,
Working Protocol / Arbeitsprotokoll, Distribution Protocol /
Verteilerprotokoll and Knowledge Objects / Wissensdatenbankeintrag.
### Changed
- Refined the architecture from a single meeting protocol toward Canonical
Meeting Knowledge as the planned semantic source of truth.
- Clarified that Working Protocol, Distribution Protocol and Knowledge Objects
are parallel renderings, not derived from one another.
- Updated decision extraction semantics to include explicit process decisions
and deferrals.
- Simplified extraction prompt assembly around prompt files.
### Fixed
- Fixed Whisper JSON chunk extraction to prefer `segments[*].text` over the
aggregate top-level `text` field.
- Added chunking tests to ensure chunks do not duplicate later blocks when no
overlap is requested.
- Added parser handling for model responses that contain thinking text before
the final JSON object.
### Documentation
- Added architecture, pipeline and data-model documentation.
- Added output-view documentation.
- Added Gold Standard prompt-engineering methodology.
- Added formal decision-definition documentation.
- Added scenario README files for the Gold Standard corpus.