# Architecture

> Design and evolve the software architecture of theme-extractor with explicit boundaries, strategy interfaces, and backend abstractions. Use when defining module structure, introducing extraction strategies, or implementing Elasticsearch/OpenSearch interoperability. Use when this capability is needed.

- Skill: `tomevault-io/architecture-15` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/architecture-15`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/architecture-15/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/architecture-15

---


# Architecture Skill

## Purpose
Design a maintainable architecture with clear contracts and low coupling.

## Workflow
1. Run MBAD before deciding architecture changes.
2. Define or update typed contracts first (models, protocols, interfaces).
3. Apply strategy pattern for extraction methods.
4. Decouple ingestion, preprocessing, extraction, and output serialization.
5. 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](https://tomevault.io/claim/guillaume-lombardo) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->