forked from diegoecab/oci-deal-accelerator
PPTX icon resolver: 50+ proactive aliases + menu-mode 'no code edits' rule
Diego flagged two patterns from the Codex session: 1. Aliases for natural-language slugs were missing — Codex authored ``type: refreshable_clone`` and ``type: oci_goldengate`` and the resolver returned None for both. Beyond fixing those two, expand the table proactively: 50+ slugs an SA / agent might naturally reach for (atp, alb, nlb, apigw, lambda, kms, secret, kafka, alarm, email, identity, iam, iac, terraform, oac, oic, language / speech / vision, rpc / lpg / cpe, health_check, tags, etc.) all mapped to canonical icon entries that exist in kb/diagram/oci-pptx-icons-index.json. 2. Codex was editing tools/oci_deck_gen.py and the deck-spec while fulfilling a menu-driven option-2 request — going off the procedure to "fix" perceived bugs in the renderer. New rule in SKILL.md § What You Do NOT Do: when the user is in menu mode (options 1–14), the agent USES the existing tools, never modifies them. Tool gaps (missing aliases, broken paths) get surfaced as end-of-reply follow-ups for a separate developer-mode session. Two narrow exceptions kept: kb/field-findings/tracker.yaml via option 11, and writing customer spec/output YAML under examples/. Codex copy auto-synced via the pre-commit hook. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
3
SKILL.md
3
SKILL.md
@@ -568,5 +568,4 @@ KB lives under `kb/`. See [kb/README.md](kb/README.md) for the directory map, fr
|
||||
- You do NOT claim features exist if you're unsure. Check the KB first.
|
||||
- You do NOT do detailed project management. DELIVER artifacts are lightweight handover aids.
|
||||
- You do NOT add services or components the user did not request.
|
||||
|
||||
<!-- test marker for sync hook -->
|
||||
- **You do NOT edit skill source code or tooling when the user is in "menu mode".** When the user invoked the skill via the welcome menu (options 1–14) or asked for one of the menu outputs (proposal, diagram, deck, BOM, WA review, etc.), your job is to USE the existing tools, not modify them. Do NOT touch `tools/`, `scripts/`, `kb/diagram/*.json`, or any other code/index file as part of fulfilling a menu request — even if you discover a bug or a missing alias mid-task. If you hit a tool gap (missing icon alias, broken renderer, type that doesn't resolve), surface it as a follow-up at the end of your reply (e.g. "I noticed `refreshable_clone` doesn't have a PPTX icon alias — flag this for the maintainer to add to `tools/oci_pptx_diagram_gen.py::TYPE_TO_ICON`") rather than silently patching it. Code edits happen in a separate "developer mode" engagement, not while the SA is generating customer artifacts. The two exceptions: (1) `kb/field-findings/tracker.yaml` via menu option 11 (the menu's purpose IS to write that file), and (2) writing the customer's spec/output YAML files under `examples/<customer>/` — those are the deliverable, not the skill itself.
|
||||
|
||||
Reference in New Issue
Block a user