skills/pbakaus_impeccable
1
0
Fork 0
mirror of https://github.com/pbakaus/impeccable.git synced 2026-09-21 18:47:02 +03:00
Code Issues Packages Projects Releases Wiki Activity

Require complete design artifacts at the finish handoff

Browse Source 
Name token-bearing DESIGN.md and its sidecar in the parent handoff while shortening the paragraph. Keep spec, token, sidecar and write-boundary gates; report wrapper coverage separately.

Validation: one Claude redesign retest wrote both artifacts; saved-output replay passed artifact checks (live assertion first failed on wrapper coverage). Default tests, source build and skill validator passed. Remaining token-accuracy limitations are documented.

AI assistance: Codex, under maintainer direction.
This commit is contained in:
Paul Bakaus
2026-09-07 19:01:34 -07:00
parent b1a071049e
commit 737a51f5ad
5 changed files with 58 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skill/reference/new-work.md
+1 -1
View File
@@ -146,4 +146,4 @@ A rebuild and a fix round share one asset rule: a raster either round creates or
Report the final verdict under the reviewer's own disposition word and at its actual scope. A verdict pass scores the listed fixes and nothing else: "the reviewer scored all three fixes resolved" is a claim it supports, "no material issues remain" is not. A table with open material findings is never announced as a pass, never softened, and never dressed as whole-surface approval when only a fix list was scored. When the user answers a ship with evidence against it, their own screenshot, a named mismatch with the comp, that evidence outranks every capture you made: put their material in the packet and spawn a fresh reviewer for a new full review. Patching inline and self-certifying is how a rejected page ships twice. <!-- rule:skill-user-evidence-reopens-review -->
After the last correction, spawn the shipped documenter, `impeccable-documenter` (`impeccable_documenter` in codex), with the project root, artifact path, direction contract, PRODUCT.md, [document.md](document.md), and write boundary. Without subagents, load and follow [degraded/documenter.md](degraded/documenter.md). An existing DESIGN.md does not skip this pass: compare the finished build with the recorded system; unchanged files are a valid result, reported with what was checked. Preserve the incumbent system on ordinary extensions and report pre-existing drift without repairing it unasked. If a later fix changes the surface, repeat the documentation check. Finish only after the review and documentation outcomes are both accounted for. <!-- rule:skill-documenter-records-the-world -->
After the last correction, spawn the shipped documenter, `impeccable-documenter` (`impeccable_documenter` in codex), with the project root, artifact path, direction contract, PRODUCT.md, [document.md](document.md), and write boundary. Without subagents, load [degraded/documenter.md](degraded/documenter.md) and [document.md](document.md) before writing. Verify the outcome: new worlds and approved system changes require token-bearing DESIGN.md **and** `.impeccable/design.json`, not prose alone. Ordinary extensions compare the finished build against the incumbent system, preserve its files, and report the evidence checked; report pre-existing drift without repairing it unasked. Recheck after later edits. Finish only when review and documentation are complete. <!-- rule:skill-documenter-records-the-world -->