Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
fix: let quality-first lifecycle runs converge
tt-a1i7eef4db36a97
diff --git a/archify.zip b/archify.zipindex e6c4e8e4..3ffc53d9 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/SKILL.md b/archify/SKILL.mdindex c731987f..d3aff240 100644--- a/archify/SKILL.md+++ b/archify/SKILL.md@@ -18,9 +18,10 @@ For an ordinary renderer-backed request with shell access, use this bounded path1. Choose `architecture`, `workflow`, `sequence`, `dataflow`, or `lifecycle` from the user's question.2. Read only one matching schema in `schemas/` and one matching JSON example in `examples/`. Use their field shapes, but author fresh domain facts, IDs, and layout.-3. Artifact first: after those reads finish, the next tool action must write the candidate. Write the candidate before inspecting renderer internals. Do not plan exact coordinates in prose, compare several layouts, inspect another example, or run CLI help first. Start with one clear main path, short side branches, 180–220 px horizontal spacing, 140–180 px branch spacing, sparse relationship labels, and at most 12 primary nodes; omit optional cards, views, and tags until validation passes. Start with automatic routes and labels. Do not add `via`, `channelX`, `channelY`, or `labelAt` before a diagnostic explicitly calls for one; add at most one diagnosed geometry control per repair. Fresh authorship means new stable IDs, domain wording, and layout. When the requested roles naturally match an example, preserve the accurate topology instead of inventing a less accurate difference merely to look novel.-4. Run `node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json` (or `standard` when the user explicitly wants a dense engineering map). Run it again after the final candidate edit, even when an earlier iteration passed.-5. If validation fails, change only the diagnosed subject using its `supportedFixes`, then rerun. Stop after two focused correction rounds and report any unresolved diagnostic truthfully.+3. Artifact first: after those reads finish, the next tool action must write the candidate. Write the candidate before inspecting renderer internals. Do not plan exact coordinates in prose, compare several layouts, inspect another example, or run CLI help first. Start with one clear main path, short side branches, 180–220 px horizontal spacing, 140–180 px branch spacing, sparse relationship labels, and at most 12 primary nodes; omit optional cards, views, and tags until validation passes. Set `meta.quality_profile` to `"showcase"` unless the user explicitly asks for a dense `standard` engineering map. Start with automatic routes and labels. Do not add `via`, `channelX`, `channelY`, or `labelAt` before a diagnostic explicitly calls for one; add at most one diagnosed geometry control per repair. Fresh authorship means new stable IDs, domain wording, and layout. When the requested roles naturally match an example, preserve the accurate topology instead of inventing a less accurate difference merely to look novel.+ - Lifecycle only: phase columns `0..4` occupy the main rail; event and outcome columns `0..2` align under phase columns `2..4`. Put approval under execution at event column `0` and blocked-under-review at event column `1`. A recoverable state uses `type: "failure"` plus a real transition back to the active state; a card or view saying “retry” is not topology. Do not add reverse resume transitions for waiting states unless the requested lifecycle explicitly requires them.+4. Run `node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json` (or `standard` when the user explicitly wants a dense engineering map). Run it again after every candidate edit and immediately before handoff, even when an earlier iteration passed. A passing final validation freezes the candidate: never edit it afterward. When the requested output is a delivered HTML artifact, `deliver` is the final acceptance command because it revalidates those frozen bytes before committing the output. A non-zero exit can never be described as success.+5. If validation fails, change only the diagnosed subject using its `supportedFixes`, then rerun. Continue focused correction while the objective error count reaches a new minimum. If two consecutive rounds do not improve that best count, or only trade a cleared error for a new one, stop and report the unresolved diagnostics truthfully.Do not read `renderers/shared/geometry.mjs`, renderer source, validator source, tests, or benchmark files before the first candidate. Inspect implementation only when validation returns an unsupported internal diagnostic or two focused repairs fail. Read the feature-specific sections below only when the user requests those capabilities; ordinary generation does not require understanding the viewer runtime.diff --git a/archify/test/ordinary-model-floor.test.mjs b/archify/test/ordinary-model-floor.test.mjsindex bb6162fb..d5ae2760 100644--- a/archify/test/ordinary-model-floor.test.mjs+++ b/archify/test/ordinary-model-floor.test.mjs@@ -850,7 +850,14 @@ test('packaged skill puts a bounded ordinary-model authoring path before the fea'Write the candidate before inspecting renderer internals','Start with automatic routes and labels','Do not add `via`, `channelX`, `channelY`, or `labelAt` before a diagnostic',- 'after the final candidate edit',+ 'Set `meta.quality_profile` to `"showcase"`',+ 'A recoverable state uses `type: "failure"` plus a real transition back to the active state',+ 'after every candidate edit',+ 'A passing final validation freezes the candidate: never edit it afterward',+ '`deliver` is the final acceptance command',+ 'A non-zero exit can never be described as success',+ 'Continue focused correction while the objective error count reaches a new minimum',+ 'If two consecutive rounds do not improve that best count','Do not read `renderers/shared/geometry.mjs`','validate <type>','supportedFixes',