Add BOM cookbook to shortcut SKU mapping for common patterns
All checks were successful
Deploy Skill to OCI / deploy (push) Successful in 24s
All checks were successful
Deploy Skill to OCI / deploy (push) Successful in 24s
Codex sessions burn 10+ tool calls grepping kb/field-knowledge and the SKU catalog to map standard requirements (ExaCS X11M BYOL, ADB-D, ADB-S + block + FastConnect) to the 4-5 SKUs the MCP BOM tools need. Bake the recipes into docs/bom-cookbook.md so the LLM can skip the exploration loop for well-known patterns, and link it from SKILL.md between Output Generation and Knowledge Base (same progressive-disclosure pattern the other docs use). Recipe 2 (ADB-Dedicated) explicitly calls out the infra-SKU overlap with ExaCS — one of the specific traps the exploration loop keeps hitting. Catalog-fallback note keeps the cookbook honest when a requirement does not match. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
8
SKILL.md
8
SKILL.md
@@ -432,6 +432,14 @@ See [docs/skill/output-formats.md](docs/skill/output-formats.md) for the per-cus
|
||||
|
||||
---
|
||||
|
||||
## Cookbook: Building Tool Payloads
|
||||
|
||||
Before mapping customer requirements to SKUs for `generate_bom`, `generate_bom_appca`, or `generate_cost_estimate`, check [docs/bom-cookbook.md](docs/bom-cookbook.md) — it has copy-paste recipes for common patterns (ExaCS X11M BYOL, ADB-Dedicated, ADB-S + Block + FastConnect) and explicitly names the gotchas that otherwise burn exploration turns (e.g. ADB-Dedicated shares infrastructure SKUs with ExaCS — there are no separate `adb_dedicated` SKUs in the catalog).
|
||||
|
||||
If a requirement does not match a recipe, `grep` [`kb/pricing/oci-sku-catalog.yaml`](kb/pricing/oci-sku-catalog.yaml) and consult `kb/services/` before inventing SKUs.
|
||||
|
||||
---
|
||||
|
||||
## Knowledge Base
|
||||
|
||||
KB lives under `kb/`. See [kb/README.md](kb/README.md) for the directory map, frontmatter requirements, refresh tooling, and contributor guide.
|
||||
|
||||
Reference in New Issue
Block a user