Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.
Restore README video and simplify the example (#10)
Michael Ramos9982ad0c81ff
diff --git a/README.md b/README.mdindex b1b56a5..d06b847 100644--- a/README.md+++ b/README.md@@ -4,26 +4,35 @@ Five focused skills for creating useful, self-contained HTML artifacts, from lowThe collection is opinionated about clarity, accessibility, and verification. It is not tied to one palette, typography stack, component system, or diagram style. Each artifact follows the user's direction first, then the project's established language, then the subject itself.+https://github.com/user-attachments/assets/24306977-7f30-44c9-9bff-55f901d557b0++<p align="center">+ <a href="https://github.com/backnotprop/plannotator">+ <img src="./star-plannotator.svg" width="340" alt="Star Plannotator on GitHub">+ </a>+</p>+<p align="center">+Render and annotate local HTML with <a href="https://github.com/backnotprop/plannotator">Plannotator</a>.+</p>+## Choose a skill| Skill | Use it for || --- | --- || [`html`](skills/html/SKILL.md) | Broad HTML requests, mixed artifacts, reports, explainers, presentations, landing pages, tools, and routing to a specialist || [`html-wireframe`](skills/html-wireframe/SKILL.md) | Low-fidelity layout directions that test content, hierarchy, navigation, flows, and responsive structure |-| [`html-prototype`](skills/html-prototype/SKILL.md) | Styled mockups and working prototypes with realistic states, interaction, keyboard support, and responsive behavior |+| [`html-prototype`](skills/html-prototype/SKILL.md) | Working prototypes with realistic states, interaction, keyboard support, and responsive behavior || [`html-plan`](skills/html-plan/SKILL.md) | Plans, roadmaps, rollouts, and implementation sequences that preserve source commitments || [`html-diagram`](skills/html-diagram/SKILL.md) | Architecture, sequence, process, state, hierarchy, timeline, and system diagrams |-A mockup is a noninteractive fidelity mode inside `html-prototype`. There is no separate `html-mockup` skill.--## One brief, three stages+## One brief, two stages-The [release-readiness example](examples/release-readiness/README.md) carries the same product brief through structure, visual fidelity, and interaction. Every stage is preserved as a standalone HTML file that opens without build tooling.+The [release-readiness example](examples/release-readiness/README.md) carries the same product brief from structural exploration to working interaction. Both artifacts are standalone HTML files that open without build tooling.-| Wireframe | Mockup | Prototype |-| --- | --- | --- |-| [](examples/release-readiness/wireframe.html) | [](examples/release-readiness/mockup.html) | [](examples/release-readiness/prototype.html) |-| Decide what belongs on the screen and compare structural directions. | Judge hierarchy, visual language, and responsive composition. | Test the blocked-to-ready flow, feedback, recovery, and product boundary. |+| Wireframe | Prototype |+| --- | --- |+| [](examples/release-readiness/wireframe.html) | [](examples/release-readiness/prototype.html) |+| Decide what belongs on the screen and compare structural directions. | Test the blocked-to-ready flow, feedback, recovery, and product boundary. |Read the canonical Plannotator guide, [HTML wireframes and prototypes for coding agents](https://docs.plannotator.ai/learn/code-context/html-wireframes-and-prototypes-for-coding-agents), for the review questions that belong at each stage.@@ -48,8 +57,6 @@ Invoke a skill directly:```textUse $html-wireframe to explore three responsive layouts for this checkout brief.-Use $html-prototype in mockup mode to apply our existing design system to the approved wireframe.-Use $html-prototype to make the checkout flow work, including validation, loading, failure, success, keyboard, and mobile states.```@@ -75,7 +82,6 @@ The skills separate creative freedom from reliability:- Visual direction comes from the conversation, project, audience, and subject.- Wireframes stay intentionally unfinished so reviewers focus on structure.-- Mockups add a visual system without pretending to test behavior.- Prototypes implement one credible flow and its relevant states.- Plans preserve source commitments.- Diagrams choose a visual model and rendering method that fit the relationship being explained.@@ -101,22 +107,12 @@ examples/├── brief.md├── states.md├── wireframe.html- ├── mockup.html├── prototype.html└── screenshots/```This project was inspired by Thariq Shihipar's [The unreasonable effectiveness of HTML](https://thariqs.github.io/html-effectiveness).-<p align="center">- <a href="https://github.com/backnotprop/plannotator">- <img src="./star-plannotator.svg" width="340" alt="Star Plannotator on GitHub">- </a>-</p>-<p align="center">-Render and annotate local HTML with <a href="https://github.com/backnotprop/plannotator">Plannotator</a>.-</p>-<p align="center"><a href="https://github.com/plannotator/tot"><img src="./use-tot.svg" width="300" alt="Share HTML with tot">diff --git a/examples/release-readiness/README.md b/examples/release-readiness/README.mdindex ab028a6..55a5aa4 100644--- a/examples/release-readiness/README.md+++ b/examples/release-readiness/README.md@@ -1,6 +1,6 @@# Release readiness example-This example takes one product brief through three review stages. Each stage is a separate, self-contained HTML file so it can be opened directly, copied, and changed without build tooling.+This example takes one product brief from structural exploration to working interaction. Both artifacts are self-contained HTML files that can be opened directly, copied, and changed without build tooling.## 1. Wireframe@@ -18,17 +18,7 @@ Decisions at this stage include content, grouping, navigation, task order, and m| --- | --- | --- ||  |  |  |-## 2. Mockup--[Open the mockup](mockup.html)--The mockup develops the decision-first direction into a release-control workspace. It adds a product-specific visual hierarchy, responsive composition, readable state styling, and realistic evidence without adding product behavior.--Decisions at this stage include type, spacing, color, contrast, visual density, and how the desktop composition collapses on mobile. Data flow, permissions, persistence, and transitions remain open.----## 3. Prototype+## 2. Prototype[Open the prototype](prototype.html)@@ -47,11 +37,10 @@ See the [validation record](validation.md) for browser, interaction, accessibili## Clone and adapt-Copy the stage closest to the question you need to answer:+Copy the artifact closest to the question you need to answer:```bashcp examples/release-readiness/wireframe.html my-flow.html-cp examples/release-readiness/mockup.html my-mockup.htmlcp examples/release-readiness/prototype.html my-prototype.html```diff --git a/examples/release-readiness/mockup.html b/examples/release-readiness/mockup.htmldeleted file mode 100644index 1213945..0000000--- a/examples/release-readiness/mockup.html+++ /dev/null@@ -1,831 +0,0 @@-<!doctype html>-<html lang="en">- <head>- <meta charset="utf-8">- <meta name="viewport" content="width=device-width, initial-scale=1">- <title>Atlas Mobile 4.8 release-readiness mockup</title>- <style>- :root {- color-scheme: light;- --paper: #fbfaf6;- --canvas: #e9e7df;- --surface: #f2f0e8;- --ink: #17211f;- --muted: #656d68;- --line: #cbc8bd;- --night: #172724;- --night-soft: #243733;- --lime: #b9ea73;- --lime-dark: #315c33;- --red: #b8442e;- --red-soft: #fae5dc;- --blue: #3156cd;- --blue-soft: #e5eafe;- --shadow: rgba(29, 38, 35, 0.13);- }-- * {- box-sizing: border-box;- }-- html {- min-width: 320px;- background: var(--canvas);- }-- body {- min-height: 100vh;- margin: 0;- background:- linear-gradient(rgba(23, 33, 31, 0.035) 1px, transparent 1px),- linear-gradient(90deg, rgba(23, 33, 31, 0.035) 1px, transparent 1px),- var(--canvas);- background-size: 22px 22px;- color: var(--ink);- font-family: Arial, Helvetica, sans-serif;- font-size: 15px;- line-height: 1.5;- }-- a {- color: inherit;- }-- a:focus-visible {- outline: 3px solid var(--blue);- outline-offset: 4px;- }-- .skip-link {- position: fixed;- top: 12px;- left: 12px;- z-index: 10;- padding: 9px 12px;- background: var(--paper);- transform: translateY(-180%);- }-- .skip-link:focus {- transform: translateY(0);- }-- .review-banner {- display: flex;- align-items: center;- justify-content: center;- gap: 8px;- min-height: 34px;- padding: 7px 16px;- background: var(--blue);- color: #ffffff;- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 11px;- font-weight: 700;- letter-spacing: 0.08em;- text-align: center;- text-transform: uppercase;- }-- .review-banner::before {- width: 7px;- height: 7px;- border: 1px solid currentColor;- content: "";- transform: rotate(45deg);- }-- .app-shell {- width: min(1240px, calc(100% - 36px));- margin: 22px auto 48px;- overflow: hidden;- border: 1px solid rgba(23, 33, 31, 0.4);- border-radius: 18px;- background: var(--paper);- box-shadow: 0 28px 70px var(--shadow);- }-- .topbar {- display: grid;- grid-template-columns: 260px 1fr auto;- min-height: 64px;- align-items: center;- border-bottom: 1px solid var(--line);- }-- .brand {- display: flex;- height: 100%;- align-items: center;- gap: 12px;- padding: 0 20px;- border-right: 1px solid var(--line);- font-weight: 800;- letter-spacing: -0.02em;- }-- .brand-mark {- display: grid;- width: 29px;- height: 29px;- place-items: center;- background: var(--night);- color: var(--lime);- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 13px;- transform: rotate(-3deg);- }-- .breadcrumb {- min-width: 0;- padding: 0 22px;- color: var(--muted);- font-size: 13px;- overflow: hidden;- text-overflow: ellipsis;- white-space: nowrap;- }-- .breadcrumb strong {- color: var(--ink);- }-- .reviewer {- display: flex;- align-items: center;- gap: 10px;- padding-right: 20px;- color: var(--muted);- font-size: 13px;- }-- .avatar {- display: grid;- width: 31px;- height: 31px;- place-items: center;- border-radius: 50%;- background: var(--blue-soft);- color: #2948b5;- font-weight: 800;- }-- .release-header {- display: grid;- grid-template-columns: minmax(0, 1fr) auto;- gap: 36px;- align-items: end;- padding: clamp(30px, 5vw, 58px);- border-bottom: 1px solid var(--line);- }-- .kicker {- display: flex;- flex-wrap: wrap;- gap: 8px 16px;- align-items: center;- margin-bottom: 15px;- color: var(--muted);- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 12px;- font-weight: 700;- letter-spacing: 0.04em;- text-transform: uppercase;- }-- .kicker .rule {- width: 34px;- height: 3px;- background: var(--red);- }-- h1 {- max-width: 800px;- margin: 0;- font-family: Georgia, "Times New Roman", serif;- font-size: clamp(44px, 7.4vw, 92px);- font-weight: 500;- letter-spacing: -0.065em;- line-height: 0.9;- }-- .release-header p {- max-width: 650px;- margin: 20px 0 0;- color: var(--muted);- font-size: 17px;- }-- .blocked-stamp {- position: relative;- width: 156px;- padding: 20px 14px;- border: 4px double var(--red);- color: var(--red);- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 15px;- font-weight: 900;- letter-spacing: 0.16em;- text-align: center;- text-transform: uppercase;- transform: rotate(2deg);- }-- .blocked-stamp span {- display: block;- margin-top: 6px;- font-size: 10px;- letter-spacing: 0.08em;- }-- .manifest {- display: grid;- grid-template-columns: repeat(4, minmax(0, 1fr));- border-bottom: 1px solid var(--line);- }-- .manifest-item {- min-width: 0;- padding: 18px 22px;- border-right: 1px solid var(--line);- }-- .manifest-item:last-child {- border-right: 0;- }-- .manifest-item span,- .manifest-item strong {- display: block;- }-- .manifest-item span {- color: var(--muted);- font-size: 11px;- font-weight: 700;- letter-spacing: 0.07em;- text-transform: uppercase;- }-- .manifest-item strong {- margin-top: 5px;- overflow-wrap: anywhere;- font-size: 14px;- }-- .manifest-item code {- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- }-- .workspace {- display: grid;- grid-template-columns: minmax(0, 1.65fr) minmax(310px, 0.78fr);- gap: 0;- }-- .main-column {- min-width: 0;- padding: clamp(24px, 4vw, 44px);- border-right: 1px solid var(--line);- }-- .side-column {- min-width: 0;- background: var(--surface);- }-- .section-title {- display: flex;- align-items: flex-end;- justify-content: space-between;- gap: 20px;- margin-bottom: 18px;- }-- .section-title h2 {- margin: 0;- font-size: 22px;- letter-spacing: -0.025em;- }-- .section-title p {- margin: 0;- color: var(--muted);- font-size: 13px;- }-- .check-list {- margin: 0;- padding: 0;- border-top: 1px solid var(--ink);- list-style: none;- }-- .check {- display: grid;- grid-template-columns: 44px minmax(0, 1fr) minmax(180px, 0.72fr) auto;- gap: 16px;- align-items: start;- padding: 20px 0;- border-bottom: 1px solid var(--line);- }-- .check-number {- color: var(--muted);- font-family: Georgia, "Times New Roman", serif;- font-size: 30px;- line-height: 1;- }-- .check-name strong,- .check-name span,- .evidence strong,- .evidence span {- display: block;- }-- .check-name strong {- font-size: 16px;- }-- .check-name span,- .evidence span {- margin-top: 4px;- color: var(--muted);- font-size: 13px;- }-- .evidence {- padding-left: 14px;- border-left: 1px solid var(--line);- font-size: 13px;- }-- .evidence strong {- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 12px;- }-- .result {- display: inline-flex;- align-items: center;- gap: 7px;- min-width: 68px;- justify-content: center;- padding: 5px 9px;- border-radius: 999px;- font-size: 11px;- font-weight: 800;- letter-spacing: 0.06em;- text-transform: uppercase;- }-- .result::before {- width: 7px;- height: 7px;- border-radius: 50%;- background: currentColor;- content: "";- }-- .result.pass {- background: #e4f3d2;- color: var(--lime-dark);- }-- .result.fail {- background: var(--red-soft);- color: #a33c28;- }-- .risk-callout {- display: grid;- grid-template-columns: auto minmax(0, 1fr);- gap: 15px;- margin-top: 26px;- padding: 18px;- border: 1px solid #e6b7a7;- background: var(--red-soft);- }-- .risk-mark {- display: grid;- width: 32px;- height: 32px;- place-items: center;- border: 1px solid var(--red);- color: var(--red);- font-weight: 900;- }-- .risk-callout strong,- .risk-callout span {- display: block;- }-- .risk-callout span {- margin-top: 3px;- color: #6e493e;- font-size: 13px;- }-- .decision-panel {- padding: 32px 28px;- background: var(--night);- color: #f6f5ef;- }-- .decision-label {- color: var(--lime);- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 11px;- font-weight: 800;- letter-spacing: 0.1em;- text-transform: uppercase;- }-- .decision-panel h2 {- max-width: 330px;- margin: 14px 0 0;- font-family: Georgia, "Times New Roman", serif;- font-size: 38px;- font-weight: 500;- letter-spacing: -0.045em;- line-height: 0.98;- }-- .decision-panel p {- margin: 14px 0 0;- color: #b8c4c0;- }-- .decision-rule {- display: grid;- grid-template-columns: 1fr auto;- gap: 12px;- margin: 24px 0 0;- padding-top: 18px;- border-top: 1px solid #40524e;- font-size: 13px;- }-- .decision-rule strong {- color: var(--lime);- }-- .action-stack {- display: grid;- gap: 9px;- margin-top: 24px;- }-- .mock-button {- display: flex;- min-height: 46px;- align-items: center;- justify-content: center;- padding: 10px 14px;- border: 1px solid #50645f;- color: #d1dad7;- font-weight: 700;- text-align: center;- }-- .mock-button.primary {- border-color: var(--lime);- background: var(--lime);- color: var(--night);- }-- .mock-button.disabled {- border-color: #394a46;- color: #98a6a1;- }-- .static-note {- margin-top: 12px;- color: #8fa09b;- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 10px;- line-height: 1.5;- text-align: center;- text-transform: uppercase;- }-- .notes-panel {- padding: 28px;- }-- .notes-head {- display: flex;- align-items: baseline;- justify-content: space-between;- gap: 10px;- padding-bottom: 12px;- border-bottom: 1px solid var(--line);- }-- .notes-head h2 {- margin: 0;- font-size: 17px;- }-- .notes-head span {- color: var(--muted);- font-size: 12px;- }-- .note {- padding: 18px 0;- border-bottom: 1px solid var(--line);- }-- .note:last-child {- border-bottom: 0;- }-- .note p {- margin: 0;- font-size: 14px;- }-- .note footer {- display: flex;- align-items: center;- gap: 7px;- margin-top: 9px;- color: var(--muted);- font-size: 11px;- }-- .note footer::before {- width: 16px;- height: 1px;- background: var(--line);- content: "";- }-- .artifact-footer {- display: flex;- justify-content: space-between;- gap: 20px;- padding: 16px 22px;- border-top: 1px solid var(--line);- background: var(--surface);- color: var(--muted);- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;- font-size: 11px;- }-- @media (max-width: 900px) {- .topbar {- grid-template-columns: auto 1fr;- }-- .brand {- border-right: 0;- }-- .breadcrumb {- display: none;- }-- .manifest {- grid-template-columns: 1fr 1fr;- }-- .manifest-item:nth-child(2) {- border-right: 0;- }-- .manifest-item:nth-child(-n + 2) {- border-bottom: 1px solid var(--line);- }-- .workspace {- grid-template-columns: 1fr;- }-- .main-column {- border-right: 0;- border-bottom: 1px solid var(--line);- }-- .check {- grid-template-columns: 36px minmax(0, 1fr) auto;- }-- .evidence {- grid-column: 2 / -1;- }- }-- @media (max-width: 600px) {- .app-shell {- width: calc(100% - 16px);- margin-top: 8px;- border-radius: 10px;- }-- .topbar {- min-height: 58px;- }-- .brand {- padding: 0 14px;- }-- .reviewer {- padding-right: 14px;- }-- .reviewer > span {- display: none;- }-- .release-header {- grid-template-columns: 1fr;- padding: 28px 20px;- }-- h1 {- font-size: clamp(46px, 16vw, 72px);- }-- .blocked-stamp {- width: 140px;- }-- .manifest {- grid-template-columns: 1fr;- }-- .manifest-item {- border-right: 0;- border-bottom: 1px solid var(--line);- }-- .manifest-item:last-child {- border-bottom: 0;- }-- .main-column {- padding: 28px 20px;- }-- .section-title {- display: block;- }-- .section-title p {- margin-top: 4px;- }-- .check {- grid-template-columns: 32px minmax(0, 1fr);- }-- .result {- grid-column: 2;- width: max-content;- }-- .evidence {- grid-column: 2;- }-- .decision-panel,- .notes-panel {- padding: 28px 20px;- }-- .artifact-footer {- display: block;- }-- .artifact-footer span:last-child {- display: block;- margin-top: 4px;- }- }-- @media (prefers-reduced-motion: reduce) {- *,- *::before,- *::after {- scroll-behavior: auto !important;- transition-duration: 0.01ms !important;- }- }- </style>- </head>- <body>- <a class="skip-link" href="#checks">Skip to release checks</a>- <div class="review-banner">Styled mockup · static visual review</div>-- <main class="app-shell">- <header class="topbar">- <div class="brand">- <span class="brand-mark" aria-hidden="true">A</span>- <span>Atlas release desk</span>- </div>- <div class="breadcrumb">Mobile releases / <strong>Atlas Mobile 4.8</strong></div>- <div class="reviewer">- <span>Reviewing as Maya Chen</span>- <span class="avatar" aria-hidden="true">MC</span>- </div>- </header>-- <section class="release-header" aria-labelledby="release-title">- <div>- <div class="kicker"><span class="rule"></span><span>Release candidate 03</span><span>July 29, 2026</span></div>- <h1 id="release-title">Atlas Mobile 4.8</h1>- <p>One required check is blocking production. Review the failed iOS checkout case and its evidence before changing the release decision.</p>- </div>- <div class="blocked-stamp" aria-label="Release blocked">Blocked<span>1 failed check</span></div>- </section>-- <section class="manifest" aria-label="Release manifest">- <div class="manifest-item"><span>Candidate</span><strong>4.8.0-rc.3</strong></div>- <div class="manifest-item"><span>Commit</span><strong><code>8f31d2a</code></strong></div>- <div class="manifest-item"><span>Owner</span><strong>Maya Chen</strong></div>- <div class="manifest-item"><span>Evidence current</span><strong>18 minutes ago</strong></div>- </section>-- <div class="workspace">- <section class="main-column" id="checks" aria-labelledby="checks-title">- <div class="section-title">- <h2 id="checks-title">Required checks</h2>- <p>3 of 4 passed · all evidence shown</p>- </div>-- <ol class="check-list">- <li class="check">- <span class="check-number" aria-hidden="true">01</span>- <div class="check-name"><strong>Android smoke test</strong><span>Pixel 9 · Android 16</span></div>- <div class="evidence"><strong>android-smoke-7412</strong><span>42 cases passed in 6m 14s</span></div>- <span class="result pass">Pass</span>- </li>- <li class="check">- <span class="check-number" aria-hidden="true">02</span>- <div class="check-name"><strong>iOS smoke test</strong><span>iPhone 16 · iOS 19</span></div>- <div class="evidence"><strong>ios-smoke-9831</strong><span>Checkout froze after Apple Pay</span></div>- <span class="result fail">Fail</span>- </li>- <li class="check">- <span class="check-number" aria-hidden="true">03</span>- <div class="check-name"><strong>API compatibility</strong><span>Mobile contract suite</span></div>- <div class="evidence"><strong>contract-186</strong><span>186 checks passed in 2m 08s</span></div>- <span class="result pass">Pass</span>- </li>- <li class="check">- <span class="check-number" aria-hidden="true">04</span>- <div class="check-name"><strong>Privacy review</strong><span>No new data collection</span></div>- <div class="evidence"><strong>PRV-219</strong><span>Approved by Nia Wallace</span></div>- <span class="result pass">Pass</span>- </li>- </ol>-- <div class="risk-callout">- <span class="risk-mark" aria-hidden="true">!</span>- <div>- <strong>Open risk: iOS checkout completion</strong>- <span>The payment sheet closed successfully, but the app did not advance to the confirmation screen. Reproduce and pass the same device flow before release.</span>- </div>- </div>- </section>-- <aside class="side-column" aria-label="Release decision and reviewer notes">- <section class="decision-panel">- <span class="decision-label">Current decision · blocked</span>- <h2>Passing iOS evidence is required.</h2>- <p>The production action stays unavailable until all four required checks pass.</p>- <div class="decision-rule"><span>Release gate</span><strong>3 / 4</strong></div>- <div class="action-stack" aria-label="Static action preview">- <span class="mock-button primary">Record iOS rerun</span>- <span class="mock-button disabled">Release to production</span>- </div>- <div class="static-note">Actions are intentionally inactive in mockup mode</div>- </section>-- <section class="notes-panel">- <div class="notes-head"><h2>Reviewer notes</h2><span>2 open</span></div>- <article class="note">- <p>Apple Pay failure looks isolated to the transition after payment. Retest on the same device before changing the gate.</p>- <footer>Jon Bell · 10:42</footer>- </article>- <article class="note">- <p>Rollback package 4.7.2 is verified and remains available for the release window.</p>- <footer>Maya Chen · 10:31</footer>- </article>- </section>- </aside>- </div>-- <footer class="artifact-footer">- <span>Atlas release desk · review artifact</span>- <span>Visual fidelity only · no live release behavior</span>- </footer>- </main>- </body>-</html>diff --git a/examples/release-readiness/screenshots/mockup-desktop.png b/examples/release-readiness/screenshots/mockup-desktop.pngdeleted file mode 100644index 3e1392d..0000000Binary files a/examples/release-readiness/screenshots/mockup-desktop.png and /dev/null differdiff --git a/examples/release-readiness/screenshots/mockup-mobile.png b/examples/release-readiness/screenshots/mockup-mobile.pngdeleted file mode 100644index bd06706..0000000Binary files a/examples/release-readiness/screenshots/mockup-mobile.png and /dev/null differdiff --git a/examples/release-readiness/validation.md b/examples/release-readiness/validation.mdindex 1cdd428..820120c 100644--- a/examples/release-readiness/validation.md+++ b/examples/release-readiness/validation.md@@ -6,7 +6,7 @@ Validated July 29, 2026, on macOS with Google Chrome.| Check | Result || --- | --- |-| Desktop rendering | Passed at 1440 × 1000 for all three stages and all three wireframe directions |+| Desktop rendering | Passed at 1440 × 1000 for both artifacts and all three wireframe directions || Mobile rendering | Passed at 390 × 844 with reduced motion enabled || Horizontal overflow | None at the page level in any tested stage or direction || Console and page errors | None |@@ -41,13 +41,10 @@ Each skill was invoked in an isolated agent context with the product brief embed| --- | --- || `html` | Routed a structural review request to `html-wireframe` by reading the sibling skill, then completed the artifact without inspecting repository examples || `html-wireframe` | Produced three distinct structural directions and passed wide and narrow rendering checks |-| `html-prototype`, mockup mode | Produced a static release-control mockup with no dead controls and passed wide, narrow, reduced-motion, overflow, console, and contrast checks || `html-prototype`, prototype mode | Produced a working blocked-to-ready flow with passing and failing reruns, loading, validation, dialog focus containment, keyboard support, mobile layout, and a production boundary || `html-plan` | Preserved the four checks, owner, evidence, blocker, sequence, and readiness gate in a responsive HTML plan || `html-diagram` | Produced a responsive release-gate process diagram with failed and passing branches that stop at the production-request boundary |-The first clean mockup run exposed inherited dark text on a dark decision surface. The skill was updated to require computed foreground and background checks on every distinct surface. A fresh invocation then passed, with a lowest measured contrast ratio of 4.58:1.-## Packaging- All five skills pass the platform skill validator.