skills: document dense-map escape hatches (standard quality + larger viewBox) for Archify

- project-diagramming-archify (v1.1.0): new 'Dense maps' section — drop to --quality standard (4 checks vs 9), enlarge meta.viewBox (no schema max, examples up to 1080x780), or split maps, before simplifying node set; visual-check must fit 1440x900 without scrolling
- archify vendored SKILL.md: add dense-map off-ramp note near fast-authoring step 3
- fixes AI agents hitting showcase composition walls on rich maps + vertical-overflow confusion
This commit is contained in:
2026-09-06 18:15:22 +10:00
parent 8b12596cac
commit 840fc36116
2 changed files with 22 additions and 2 deletions

View File

@@ -19,6 +19,8 @@ Use this bounded path for ordinary generation. Do not read the optional Viewer R
1. Choose `architecture`, `workflow`, `sequence`, `dataflow`, or `lifecycle` from the question.
2. Read one matching schema in `schemas/`, `schemas/common.schema.json`, and one matching JSON example in `examples/`. Read only those files. Fresh authorship means new stable IDs, domain wording, and layout; use the example for field shape, not facts.
3. Artifact first: the next tool action must write the candidate. Write the candidate before inspecting renderer internals. Do not plan exact coordinates in prose. Start with one clear main path, short side branches, sparse labels, and at most 12 primary nodes. Set `meta.quality_profile` to `"showcase"` unless the user explicitly requests a dense `standard` map. Start with automatic routes and labels. Do not add `via`, `channelX`, `channelY`, or `labelAt` before a diagnostic calls for one; apply at most one diagnosed geometry control per repair.
**Dense maps (the designed off-ramp, not a failure):** if a legitimately rich topology keeps failing showcase composition or will not fit a ~900px-tall viewport, switch the whole run to `standard` quality (`--quality standard` on BOTH `validate` and `deliver` — 4 artifact checks instead of 9, far fewer composition constraints) and enlarge `meta.viewBox` (schema has no maximum; examples ship up to 1080×780). Do not fight showcase for many rounds; do not fake a visual-check pass for vertical overflow — report it truthfully. Only simplify the node set as a last resort, and say so.
4. Validate after every candidate edit and immediately before handoff:
```bash