- parse, merge and validate decisions (ids, status, elements, diagrams, supersedes); strip decisions keys from diagrams and check the ids - model:validate counts decisions; model:list lists them with status and the diagrams that reference them; examples carry decisions - formats.md and SKILL.md describe the format and when an agent writes one
21 lines
720 B
Plaintext
21 lines
720 B
Plaintext
schema_version: 1
|
|
decision:
|
|
id: opensearch-for-product-search
|
|
title: OpenSearch for product search
|
|
status: proposed
|
|
date: 2026-10-19
|
|
elements: [api, worker, db]
|
|
diagrams: [0200-containers/online-shop.archify]
|
|
context: >
|
|
Catalogue search runs as SQL LIKE queries on the
|
|
database. Typos find nothing and the catalogue page is
|
|
the slowest page in the shop.
|
|
decision: >
|
|
Add a dedicated search service on OpenSearch. The API
|
|
queries it; the worker rebuilds the index from the
|
|
database after every catalogue change.
|
|
consequences: >
|
|
The index is derived data under decision 0001 and may be
|
|
rebuilt at any time. One more service to run. Search
|
|
results can lag the database by the rebuild interval.
|