tomevault-io Architecture Skill
Purpose
Design a maintainable architecture with clear contracts and low coupling.
Workflow
- Run MBAD before deciding architecture changes.
- Define or update typed contracts first (models, protocols, interfaces).
- Apply strategy pattern for extraction methods.
- Decouple ingestion, preprocessing, extraction, and output serialization.
- Record architecture tradeoffs in
plan.md.
Mandatory Decisions
- Define one thin search backend protocol with:
search_documents(...)terms_aggregation(...)significant_terms_aggregation(...)significant_text_aggregation(...)
- Implement one Elasticsearch adapter.
- Implement one OpenSearch adapter.
- Keep one normalized result schema shared by all extractors.
Deliverables
- Update interfaces and protocols.
- Update module boundaries.
- Update plan entries for architecture decisions.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.