.ux-audit-examples-index summary { cursor: pointer; font-weight: 600; } .ux-rule-example [data-ks-embed-main] { display: block; max-width: 100%; } .ux-rule-example .diagram-modal-backdrop { position: relative; inset: auto; }

Before/After gallery only. For purpose, passing/failing signals, how the rule is fixed, evidence, and remediation — open the rule catalog and use Open page (example: DET.NAV.DEDUP).

Scroll for rendered examples, or jump via the index below.

← Auditor & fixing ecosystem

DET rules (51) — jump to rule
RuleLinks
DET.AMBIENT.Z_INDEXExamples · Handbook
DET.APP.FOCUS_TRAPExamples · Handbook
DET.APP.PERSISTENT_CHROMEExamples · Handbook
DET.BUTTON.GROUP.MAXExamples · Handbook
DET.CARD.ACTION_LIMITExamples · Handbook
DET.CARD.TITLEExamples · Handbook
DET.CATALOG.CONTRACT_SPECIFICITYExamples · Handbook
DET.CHART.ALT_SUMMARYExamples · Handbook
DET.CHROME.BOUNDARYExamples · Handbook
DET.CONTEXT.BURDENExamples · Handbook
DET.CONTRACT.PATHExamples · Handbook
DET.CONTRACT.PLACEHOLDERSExamples · Handbook
DET.CTA.HIERARCHYExamples · Handbook
DET.CTA.LABEL_NONEMPTYExamples · Handbook
DET.DATA.COLOR_ONLYExamples · Handbook
DET.DATA.TABLE_HEADERSExamples · Handbook
DET.DIAGRAM.ALTExamples · Handbook
DET.DIAGRAM.ASSET_REGISTRYExamples · Handbook
DET.DIAGRAM.LABELSExamples · Handbook
DET.HASH.MARKERSExamples · Handbook
DET.HASH.REGISTRY_ROWExamples · Handbook
DET.HTML.EMPTY_INLINEExamples · Handbook
DET.INVENTORY.CROSSWALKExamples · Handbook
DET.JS.NO_CONSOLE_ERRORExamples · Handbook
DET.JS.PROGRESSIVEExamples · Handbook
DET.LANDMARKS.REQUIREDExamples · Handbook
DET.LAYOUT.GRID_CONSISTENCYExamples · Handbook
DET.MOTION.NO_AUTO_PLAY_FLASHExamples · Handbook
DET.MOTION.PREFERS_REDUCEDExamples · Handbook
DET.NAV.BREADCRUMBExamples · Handbook
DET.NAV.DEDUPExamples · Handbook
DET.NAV.DEPTHExamples · Handbook
DET.NAV.FOCUS_ORDERExamples · Handbook
DET.NAV.IN_PAGE_TOCExamples · Handbook
DET.PAGE.LANGExamples · Handbook
DET.PAGE.MODEExamples · Handbook
DET.PAGE.TITLEExamples · Handbook
DET.PAGE.VIEWPORTExamples · Handbook
DET.PROSE.LENGTHExamples · Handbook
DET.PY.KS_HASH_ATTRSExamples · Handbook
DET.PY.OPTIONAL_REGIONSExamples · Handbook
DET.REACT.A11Y_ROLEExamples · Handbook
DET.REACT.KS_ATTRSExamples · Handbook
DET.SCREENSHOT.STATUSExamples · Handbook
DET.SECTION.HEADINGExamples · Handbook
DET.SECTION.SINGLE_JOBExamples · Handbook
DET.SURFACE.ELEVATION_TOKENExamples · Handbook
DET.THEME.CONTRAST_MINExamples · Handbook
DET.THEME.FONT_STACKExamples · Handbook
DET.TOKEN.NO_DRIFTExamples · Handbook
DET.VISUAL.RHYTHMExamples · Handbook

DET.AMBIENT.Z_INDEX — Ambient layer z-index contract

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed agent delivery

Clicks may hit the canvas or SVG instead of the button below.

After (passing example)

Governed agent delivery

Ambient stays behind scrim and content; controls remain clickable.

DET.APP.FOCUS_TRAP — Modal and panel focus trap

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

After (passing example)

Handbook

DET.APP.PERSISTENT_CHROME — Persistent app chrome across routes

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness multi_page
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Settings

API tokens

Route-local nav replaced the global shell; aside rail from baseline is gone.

After (passing example)

Settings

API tokens

Create and rotate tokens for automation jobs.

DET.BUTTON.GROUP.MAX — Horizontal button group cap

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed human + agent delivery

One methodology spine from intent to evidence.

After (passing example)

Governed human + agent delivery

One methodology spine from intent to evidence.

DET.CARD.ACTION_LIMIT — One primary action per card

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Outcome

Governed delegation

Shape intent, delegate safely, and keep human review on the critical path.

After (passing example)

Outcome

Governed delegation

Shape intent, delegate safely, and keep human review on the critical path.

Start tour Read docs

DET.CARD.TITLE — Card accessible title

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Govern intent, delegate safely, and ship with evidence—without a visible card title.

Learn more

After (passing example)

Outcome

Governed delivery

Shape intent, delegate safely, and release with reviewable evidence.

Learn more

DET.CATALOG.CONTRACT_SPECIFICITY — Catalog contract element specificity

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Kitchen Sink

Clean and modern enterprise-grade look with a great user experience.

Components

Browse the museum.

Open
Layouts

Browse the museum.

Open

After (passing example)

DET.CHART.ALT_SUMMARY — Chart accessible summary

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Activity

After (passing example)

Activity

Weekly commits · commit_weekly

Bar chart of weekly commit counts for 2025-W08 through W11; highest bar is W10 at seven commits.

DET.CHROME.BOUNDARY — Chrome boundary separation

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Body

Sidebar and header visually merge with main — no measurable boundary.

After (passing example)

Body

Chrome edges are visible; reading column stays clearly inside main.

DET.CONTEXT.BURDEN — First-screen context burden

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

After (passing example)

Governed human + agent delivery

Shape intent, delegate safely, and release with evidence—not ad hoc prompts.

Intent to evidence workflow diagram

Three outcomes teams need

Clear intent before agent work starts.

DET.CONTRACT.PATH — Registry contract path resolution

Lane
deterministic · page stale
Fixer
repo_overlay · verify expect_rule_clean · harness repo_overlay
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed delivery

Long-form reading column with sidebar rail.

Body

Markup matches Hbk anatomy, but registry contract path is broken.

After (passing example)

Governed delivery

Registry contract_path matches on-disk Hbk-layout-handbook.md.

Body

Implementers can trace anatomy to docs/design/catalog/layouts/Hbk-layout-handbook.md.

DET.CONTRACT.PLACEHOLDERS — Design contract placeholder language

Lane
deterministic · page stale
Fixer
repo_overlay · verify expect_rule_clean · harness repo_overlay
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

After (passing example)

DET.CTA.HIERARCHY — Primary CTA hierarchy

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed human + agent delivery

One methodology spine from intent to evidence.

After (passing example)

Governed human + agent delivery

One methodology spine from intent to evidence.

DET.CTA.LABEL_NONEMPTY — CTA accessible names are non-empty

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed human + agent delivery

One methodology spine from intent to evidence.

After (passing example)

Governed human + agent delivery

One methodology spine from intent to evidence.

DET.DATA.COLOR_ONLY — Data color redundancy

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Accent palette

Repository mix

CheckStatus
Unit tests
Lint

After (passing example)

Accent palette

amber
cyan

Repository mix

Donut of tracked files by top-level language; Python leads at 41.2%, Markdown 33.8%.

Python: 41.2% Markdown: 33.8%
Python 41.2%
Markdown 33.8%
CheckStatus
Unit tests Pass
Lint Fail

DET.DATA.TABLE_HEADERS — Data table header scope

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Tables

Wrap standard Bootstrap tables in .forge-table-wrap for themed styling.

Methodology Type Team size Iteration
ScrumAgile5–92-week sprint
KanbanLeanAnyContinuous
ForgeAI-native1–3Spark-driven

After (passing example)

Tables

Wrap standard Bootstrap tables in .forge-table-wrap for themed styling.

Methodology Type Team size Iteration
ScrumAgile5–92-week sprint
KanbanLeanAnyContinuous
ForgeAI-native1–3Spark-driven

DET.DIAGRAM.ALT — Diagram decorative vs informative alt

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

How governed delivery flows

Intent to release

After (passing example)

How governed delivery flows

Intent to release

Gate chain: intent, human review, agent execution, release with evidence

Linear gate chain: Intent → Human review → Agent execution → Release

DET.DIAGRAM.ASSET_REGISTRY — Diagram asset registry

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Delivery gate chain

Work moves through intent, human review, agent execution, and release checkpoints.

Delivery gate chain diagram

Custom flow for this landing page only.

After (passing example)

Delivery gate chain

Work moves through intent, human review, agent execution, and release checkpoints.

Gate chain: Stage 1, Gate 1, Stage 2, Gate 2, Stage 3

Registered template under Ksv / Zxd — catalog key gate matches gallery and visual registry.

DET.DIAGRAM.LABELS — Diagram legend labels on surface

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Diagram label coverage

Catalog keys without on-surface names

Linear flow with four placeholder steps

Modal legend lists Step A–D, but the SVG surface only shows [subtitle] placeholders.

Stage 1 G Stage 2 G Stage 3

Catalog legend requires Gate 1 and Gate 2; diamonds only show G.

After (passing example)

Diagram label coverage

Legend keys visible on the tile

Linear flow: Step A through Step D

Step A, Step B, Step C, Step D (matches catalog nodes)

Gate chain: Stage 1, Gate 1, Stage 2, Gate 2, Stage 3

Surface text includes Stage 1, Gate 1, Stage 2, Gate 2, Stage 3 per catalog.

DET.HASH.MARKERS — Visual hash marker pairing

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed delivery

Layout root missing hash=; sidebar missing data-ks-hash.

Body

Inner card is not a catalog visual root.

After (passing example)

Handbook sample page

Markers pair on every governed root.

DET.HASH.REGISTRY_ROW — Visual hash registry crosswalk

Lane
deterministic · page stale
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Unregistered surface

Hash Zzz is not in visual-registry.generated.json.

Registry crosswalk failure

Ksr type does not match catalog; Zzz is unknown.

Body

Inner card has no hash — not evaluated by this rule.

After (passing example)

Governed delivery

Hbk and Ksr rows match visual-registry.generated.json.

DET.HTML.EMPTY_INLINE — Empty inline emphasis in main

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Methodology comparison

Rows marked indicate the recommended delivery focus for agent-assisted teams.

Methodology Focus Iteration
Scrum 2-week sprint
Forge Spark-driven
Kanban Continuous flow Ongoing

After (passing example)

Methodology comparison

Rows marked Recommended indicate the delivery focus for agent-assisted teams.

Methodology Focus Iteration
Scrum Recommended 2-week sprint
Forge Primary path Spark-driven
Kanban Continuous flow Ongoing

DET.INVENTORY.CROSSWALK — Showcase inventory crosswalk

Lane
deterministic · page current
Fixer
repo_overlay · verify expect_rule_clean · harness repo_overlay
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Inventory crosswalk failure

Zzz is not in visual-registry.generated.json; hash="ABCD" is not three ASCII letters.

Body

Inner card has no hash markers — only governed roots are crosswalked.

After (passing example)

Governed delivery

Hbk and Ksr are registered; showcase crosswalk is clean.

Body

Site footer region uses registered hash Ksf when emitted below main.

DET.JS.NO_CONSOLE_ERROR — No console errors on scripted golden paths

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Interaction scripts

Tab panels and theme controls must survive golden-path smoke without console errors.

Bootstrap tab wiring only—broken follow-up script below.

Inline script omitted in showcase embed (see handbook source).

After (passing example)

Interaction scripts

Tab panels and theme controls complete golden-path smoke without console or page errors.

Scripts enhance navigation; core copy stays in the DOM.

Inline script omitted in showcase embed (see handbook source).

DET.JS.PROGRESSIVE — Js Progressive

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Inline script omitted in showcase embed (see handbook source).

After (passing example)

Same substantive copy visible with or without script. Same substantive copy visible with or without script. Same substantive copy visible with or without script. Same substantive copy visible with or without script. Same substantive copy visible with or without script. Same substantive copy visible with or without script. Same substantive copy visible with or without script. Same substantive copy visible with or without script.

DET.LANDMARKS.REQUIRED — Required document landmarks

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Body

Primary column is a div — no main landmark; header and footer are not semantic landmarks.

After (passing example)

Body

One main landmark; sidebar nav and header/footer chrome are exposed to assistive tech.

© Forge

DET.LAYOUT.GRID_CONSISTENCY — Layout grid consistency

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Layout grid

Governed delivery prose should sit on the layout grid with consistent gutters and readable measure across handbook, marketing, and showcase pages. Repeat the sentence so auditors sample enough words for the prose river scan to fire on wide viewports. Repeat the sentence so auditors sample enough words for the prose river scan to fire on wide viewports.

Second paragraph in the same section uses an ad hoc left margin instead of the shared grid track, so readers see jitter between blocks even when copy length matches the first paragraph. Second paragraph in the same section uses an ad hoc left margin instead of the shared grid track, so readers see jitter between blocks even when copy length matches the first paragraph.

After (passing example)

Layout grid

Governed delivery prose sits inside doc-content so line length and left inset match the Kitchen Sink handbook column. Shared container padding keeps gutters consistent across paragraphs, lists, and callouts in the same section band.

A second paragraph without inline offset inherits the same grid track, so gutter drift checks stay within tolerance. When a left doc sidebar is present, use doc-content w-100 and constrain measure inside ks-doc-toc-prose within ks-doc-toc-flow rather than mx-auto on the main column.

DET.MOTION.NO_AUTO_PLAY_FLASH — No auto-play flash patterns

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Sync in progress — strobing faster than three flashes per second.

99
Checks passing

After (passing example)

Sync complete — static text; motion reserved for hover accents.

99
Checks passing

Slow 3s glow — below flash threshold.

12
Guides linked

DET.MOTION.PREFERS_REDUCED — Prefers-reduced-motion compliance

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Decorative float and pulse keep running when Reduce motion is on.

Path

Quickstart

24
Active rules
SMIL ignores CSS animation:none

After (passing example)

Static copy — motion reserved for essential status only.

Path

Quickstart

24
Syncing rules
Static SVG — no SMIL
Static poster frame replacing autoplay video under reduced motion

DET.NAV.BREADCRUMB — Doc hub breadcrumb orientation

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Doc hub without Kbc breadcrumb — auditor flags missing_breadcrumb.

After (passing example)

Kbc breadcrumb present — breadcrumbPresent and kbcMarkerPresent both true.

DET.NAV.DEDUP — Navigation deduplication

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Body

Same section links in header nav and doc sidebar — redundant IA.

After (passing example)

Body

Primary IA, breadcrumb trail, and sidebar each own distinct destinations.

DET.NAV.DEPTH — Global navigation depth

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Global nav list_depth=4 — auditor flags nested-flyout-depth on nav.landing-nav.

After (passing example)

Global nav list_depth=2; deep IA in Ksr — passes DET.NAV.DEPTH.

DET.NAV.FOCUS_ORDER — Keyboard focus order matches visual reading order

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed delivery

Keyboard tab order diverges from visual LTR nav and positive tabindex on the CTA.

Quickstart

After (passing example)

Governed delivery

Tab moves skip link → Kpn left-to-right → main content without tabindex overrides.

Quickstart

DET.NAV.IN_PAGE_TOC — In-page table of contents for long doc pages

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governance chapter

Design principles

Long-form handbook prose that exceeds the configured word threshold without an on-this-page navigation column.

Design contracts

Each visual hash maps to an element-specific contract in the design catalog.

Deterministic checks

Repeatable UX issues become automated rules in the website auditor.

Remediation loop

Findings feed handbook rule pages and generator fixes.

Evidence trail

Screenshots, DOM snapshots, and anchor maps prove pass or fail.

Next steps

Ship Ktx beside this column so readers can jump sections without scrolling.

After (passing example)

Governance chapter

Design principles

Long-form handbook prose with a companion on-this-page navigation rail.

Design contracts

Each visual hash maps to an element-specific contract in the design catalog.

Deterministic checks

Repeatable UX issues become automated rules in the website auditor.

Remediation loop

Findings feed handbook rule pages and generator fixes.

Evidence trail

Screenshots, DOM snapshots, and anchor maps prove pass or fail.

Next steps

Readers jump directly to the section they need.

DET.PAGE.LANG — Document language declaration

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge SDLC — Governed delivery handbook

Governed human + agent delivery

English prose with no root language declaration.

Outcome

Screen readers cannot infer document language from the html root.

After (passing example)

Forge SDLC — Governed delivery handbook

Governed human + agent delivery

Document language matches English body copy.

Outcome

Assistive tech and translation tools read lang from the html root.

DET.PAGE.MODE — Page primary mode

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge SDLC — Governed delivery

Governed human + agent delivery

Hero reads as marketing while sidebar reads as handbook.

After (passing example)

Forge SDLC — Governed delivery

Governed human + agent delivery

Single marketing mode: outcome-first hero without handbook chrome.

Outcome

Clear intent and reviewable execution.

DET.PAGE.TITLE — Document page title

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Home

Governed human + agent delivery

Body copy is specific, but the browser tab still says Home.

Outcome

Tabs, bookmarks, and search snippets cannot distinguish this page.

After (passing example)

Forge SDLC — Governed delivery handbook

Governed human + agent delivery

Tab title matches the handbook name and page topic.

Outcome

Browser chrome and assistive tech announce a specific document label.

DET.PAGE.VIEWPORT — Responsive viewport meta

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge SDLC — Governed delivery handbook

Governed human + agent delivery

Responsive CSS is present, but mobile browsers still assume desktop width.

Outcome

Handbook grids and typography do not reflow correctly on phones.

After (passing example)

Forge SDLC — Governed delivery handbook

Governed human + agent delivery

Mobile browsers scale the layout to device width.

Outcome

Bootstrap breakpoints and KS sidebar hiding work on narrow viewports.

DET.PROSE.LENGTH — Prose length and list caps

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed delivery

Teams delegate more work to agents but still need clear intent, review gates, and evidence on every release. Forge creates the structure for human-owned, agent-executed delivery across methodology, workspace visibility, governed reasoning, and controlled execution without turning the landing page into a handbook dump. Repeat the mechanism sentence so word count crosses the readable prose budget and auditors flag a single dense block instead of staged cards or linked docs pages that carry reference depth below the fold for first-time readers.

Outcomes

Scan faster

  • Shape intent before delegation
  • Keep review gates on critical paths
  • Capture evidence per release
  • Link schemas to child docs
  • Expose operator controls in Fleet
  1. Define product promise in the hero
  2. Stage trust boundaries in the next band
  3. Move API tables to reference docs
  4. Cap card bullets at three items
  5. Split paragraphs over eighty-five words
  6. Run analyze-website-ux on handbook URLs
  7. Confirm proseLengthReport is empty
  8. Trim generated link indexes
  9. Use forge-callout for warnings
  10. Link long procedural lists
  11. Re-audit marketing and showcase pages
  12. File defects in the ruleset harness
  13. Promote repeated issues to new DET rules
  14. Publish remediation in kitchensink first

After (passing example)

Governed delivery

Teams delegate more work to agents but still need clear intent, review gates, and evidence on every release.

Forge structures human-owned, agent-executed delivery. Reference schemas and operator detail live on linked docs pages.

Outcomes

Scan faster

  • Shape intent before delegation
  • Keep review gates on critical paths
  • Capture evidence per release
Read methodology

Full remediation checklist (14 steps) lives on the handbook page—this band links instead of inlining fourteen li rows.

DET.PY.KS_HASH_ATTRS — Python ks_hash_attrs emitters

Lane
deterministic · page current
Fixer
repo_overlay · verify expect_rule_clean · harness repo_overlay
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Markers pasted manually in Python — not from chrome_region_attrs().

After (passing example)

DET.PY.OPTIONAL_REGIONS — Py Optional Regions

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Announcement

After (passing example)

DET.REACT.A11Y_ROLE — React A11Y Role

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

After (passing example)

DET.REACT.KS_ATTRS — React Ks Attrs

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Chip

After (passing example)

Chip

DET.SCREENSHOT.STATUS — Screenshot Status

Lane
deterministic · page current
Fixer
repo_overlay · verify expect_rule_clean · harness repo_overlay
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Registry screenshot_status mismatch (repo overlay).

After (passing example)

Screenshot status aligned with catalog.

DET.SECTION.HEADING — Section Heading

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Page title

Skipped level

Heading hierarchy jumps from h1 to h3.

After (passing example)

Forge UX rule handbook for section headings

Section

Sequential heading levels.

DET.SECTION.SINGLE_JOB — Section Single Job

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Platform overview

Everything at once

Get started quickstart install setup try sign up now. Pricing plan tier subscription cost license fee. Trust security governance boundary privacy audit evidence compliance posture. Outcome benefit value impact result why forge why choose. Forgesdlc lenses lcdl fleet platform blueprints ecosystem partners. Workflow stages lifecycle pipeline process from intent to ship. Get started quickstart install setup try sign up now. Pricing plan tier subscription cost license fee. Trust security governance boundary privacy audit evidence compliance posture. Outcome benefit value impact result why forge why choose. Forgesdlc lenses lcdl fleet platform blueprints ecosystem partners. Workflow stages lifecycle pipeline process from intent to ship. Get started quickstart install setup try sign up now. Pricing plan tier subscription cost license fee. Trust security governance boundary privacy audit evidence compliance posture. Outcome benefit value impact result why forge why choose. Forgesdlc lenses lcdl fleet platform blueprints ecosystem partners. Workflow stages lifecycle pipeline process from intent to ship.

After (passing example)

Governed delivery

Methodology spine

One coherent topic: how Forge SDLC connects intent to evidence.

DET.SURFACE.ELEVATION_TOKEN — Surface Elevation Token

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Ad-hoc deep shadow.

After (passing example)

Uses design-system elevation tokens only.

DET.THEME.CONTRAST_MIN — Theme Contrast Min

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Low contrast body text on muted panel.

After (passing example)

Token-backed contrast.

DET.THEME.FONT_STACK — Theme Font Stack

Lane
deterministic · page current
Fixer
Not in pilot registry (stub or not yet wired)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Font stack drift

Wrong display stack

Body uses non-token font-family.

After (passing example)

Approved font stacks

Display uses Forge stack

Body and labels use theme token stacks only.

DET.TOKEN.NO_DRIFT — Token No Drift

Lane
deterministic · page current
Fixer
repo_overlay · verify expect_rule_clean · harness repo_overlay
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Raw hex in repo CSS overlay triggers drift scan.

After (passing example)

Token-only styling.

DET.VISUAL.RHYTHM — Visual Rhythm

Lane
deterministic · page current
Fixer
handbook_after · verify expect_rule_clean · harness standalone
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Block A
Block B
Block C
Block D

After (passing example)

Block A
Block B
Block C
Block D

AI rules

AI rules (20) — jump to rule
RuleLinks
AI.AMBIENT.READABILITY_CONFLICTExamples · Handbook
AI.APP.DENSITY_BALANCEExamples · Handbook
AI.APP.WORKFLOW_CONTINUITYExamples · Handbook
AI.CONTEXT.BURDEN_SUBJECTIVEExamples · Handbook
AI.CONTEXT.COGNITIVE_CLARITYExamples · Handbook
AI.CONTRACT.IMPLEMENTATION_USEFULNESSExamples · Handbook
AI.CREDIBILITY.NO_OVERCLAIMExamples · Handbook
AI.DATA.INSIGHT_LEGIBILITYExamples · Handbook
AI.DIAGRAM.SEMANTIC_ACCURACYExamples · Handbook
AI.JS.BEHAVIOR_DISCOVERABILITYExamples · Handbook
AI.MOTION.INTENTIONALITYExamples · Handbook
AI.NARRATIVE.COHERENCEExamples · Handbook
AI.PREMIUM.ENTERPRISE_FEELExamples · Handbook
AI.PY.HTML_AUTHORING_QUALITYExamples · Handbook
AI.REACT.PRIMITIVE_CONSISTENCYExamples · Handbook
AI.THEME.PERSONALITY_COHERENCEExamples · Handbook
AI.TRUST.BOUNDARY_CLARITYExamples · Handbook
AI.VISUAL.HIERARCHYExamples · Handbook
AI.VISUAL.PRODUCT_EXPLANATORY_VALUEExamples · Handbook
AI.VISUAL.RHYTHM_SUBJECTIVEExamples · Handbook

AI.AMBIENT.READABILITY_CONFLICT — Ambient readability conflict

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed agent delivery

Intent, delegation, review gates, and evidence—without losing readability under the mesh.

After (passing example)

Governed agent delivery

Intent, delegation, review gates, and evidence—with ambient tone behind a scrim and card surface.

AI.APP.DENSITY_BALANCE — App density balance

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Studio

Workspace

job=forge-lenses-docs-health status=RUNNING queue=3 worker=node-7
last_event=2026-05-19T18:01:02Z detail=container argv drift

Select an item.

After (passing example)

Workspace Lens Flow

Active job

forge-lenses-docs-health

Container argv job · queue 3 · worker node-7

Diagnostics

Last event 2026-05-19T18:01:02Z — argv drift detected

detail=container argv drift

AI.APP.WORKFLOW_CONTINUITY — App workflow continuity

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Console

Workspace

Content for the selected tab appears here with no trail or active marker.

After (passing example)

Workspace Lens Flow

Docs health job

Step 3 of 5

Review argv and queue placement before run.

AI.CONTEXT.BURDEN_SUBJECTIVE — Subjective context burden

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Platform

Governed delivery spine for human-owned agent execution

Intent, structure, delegation, review, and evidence in one workspace.

Not a docs tree—a product control plane you can inspect.

Lenses shows workspace state; LCDL governs LLM tasks; Fleet runs bounded jobs.

For platform engineers, operators, and methodology leads.

  • Local-first workspace visibility
  • Governed LLM task layer
  • Token-protected job plane
Platform architecture with twelve labeled nodes and crossing edges
Full platform topology—all subsystems visible

After (passing example)

Forge Platform

Governed delivery spine

Human-owned intent, agent execution, and reviewable evidence—without opening the full handbook first.

One governed-flow snapshot—not the full architecture map.

Platform topology

Full subsystem map for readers who already understand the promise.

Platform architecture diagram

AI.CONTEXT.COGNITIVE_CLARITY — Cognitive clarity

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Platform

LCDL, Fleet, and Lenses in one spine

POST /v1/jobs, SQLite job store, governed task operators, and workspace hash catalogs.

What you get on day one

Reference

Job plane endpoints

  • POST /v1/jobs — docker_argv payload
  • GET /v1/jobs/{id} — status and logs pointer

After (passing example)

Forge Platform

Governed delivery from intent to evidence

Teams delegate more work to agents but still need clear intent, review gates, and proof.

Lenses (workspace visibility), LCDL (governed LLM tasks in Python), and Fleet (bounded job execution)—linked below, not assumed.

AI.CONTRACT.IMPLEMENTATION_USEFULNESS — Contract implementation usefulness

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

After (passing example)

AI.CREDIBILITY.NO_OVERCLAIM — Credibility without overclaim

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Platform

The only SOC 2 Type II certified AI delivery platform

Trusted by 2,000+ enterprises. 99.99% uptime. Deploy in under five minutes—fully automated, compliance-ready.

Proven at scale

Certified

SOC 2 · ISO 27001 · HIPAA

Badges shown for illustration—no audit artifacts linked.

Performance

10× faster releases

No benchmark, cohort, or doc citation.

After (passing example)

Forge Platform

Governed delivery you can inspect

Structure intent, delegate safely, and keep human review points—not marketing superlatives.

Security and compliance depend on your deployment, identity, and data boundaries. We document what the software does; we do not claim third-party certifications here.

AI.DATA.INSIGHT_LEGIBILITY — Data insight legibility

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Activity

Weekly commits · commit_weekly

After (passing example)

Delivery pulse

Commit volume spiked in 2025-W10, then eased

Weekly commits jumped from 4 to 7 (+75%) in W10—the highest bar in the window—before falling to 3 in W11.

Weekly commits · commit_weekly

Peak · W10 · 7 commits

Highlighted week = focal comparison; muted bars = baseline weeks.

AI.DIAGRAM.SEMANTIC_ACCURACY — Diagram semantic accuracy

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Human review before agent execution

Work moves in one direction: shape intent, pass a human review gate, then let the agent execute inside bounded scope, then release with evidence.

Cyclic loop: agent executes, then human review, then back to agent
Linear gate chain: Intent → Human review → Agent execution → Release

After (passing example)

Human review before agent execution

Work moves in one direction: shape intent, pass a human review gate, then let the agent execute inside bounded scope, then release with evidence.

Gate chain: Intent, Human review gate, Agent execution, Release checkpoint

Linear gate chain: Intent → Human review → Agent execution → Release (matches left-to-right arrows and diamond gates in the SVG).

AI.JS.BEHAVIOR_DISCOVERABILITY — JavaScript behavior discoverability

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Architecture overview

Delivery gate chain

Use the diagram to explain the flow.

Handbook content—no nav button on narrow viewports.

After (passing example)

Architecture overview

Select the diagram to open a larger view with step-by-step notes.

Delivery gate chain

Handbook

AI.MOTION.INTENTIONALITY — Motion intentionality

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed agent delivery

Intent, delegation, review gates, and evidence—for teams shipping with human-owned control.

42
Handbook pages
12
Methodologies

After (passing example)

Governed agent delivery

Intent, delegation, review gates, and evidence—for teams shipping with human-owned control.

Start the methodology tour
42
Handbook pages
12
Methodologies
99%
Coverage

Diagram motion activates on hover—see Breathe patterns.

AI.NARRATIVE.COHERENCE — Narrative coherence

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Lenses

SQLite catalogs, hash registries, and POST /v1/admin routes

Clone the repo, run the server, inspect workspace state—100% local, no cloud account.

Workspace API index

  • GET /v1/workspaces — list tenants
  • POST /v1/workspaces — provision hosted project

Your data stays in our cloud

Managed tenancy, automatic sync, and zero local setup—sign up to start in minutes.

After (passing example)

Forge Lenses

See workspace state before you delegate the next task

Teams using agents need a visible control plane—not another opaque automation black box.

Outcome first: inspect repos, docs, and job history locally, then choose the next safe action.

What changes on day one

Visibility

Workspace snapshot

Know which repos, docs, and jobs matter before you act.

Control

Human gates stay explicit

Delegation stays bounded; approval points stay visible.

Evidence

Inspectable history

Job and doc changes link back to intent—not mystery automation.

From intent to the next safe action

1 · Connect

Point Lenses at your local workspace root.

2 · Inspect

Review hashes, docs, and open jobs in one dashboard.

3 · Decide

Pick the next human or agent step with context attached.

4 · Record

Leave an evidence trail aligned to ForgeSDLC review gates.

Local-first by default

Data stays on infrastructure you run; optional Fleet jobs use token-scoped APIs—not a mandatory hosted tenancy.

Start local Quickstart

AI.PREMIUM.ENTERPRISE_FEEL — Premium enterprise feel

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

PLATFORM · AI · GOVERNANCE · DOCS

Everything you need!!!

Agents, automation, compliance, analytics, dashboards, and more in one place.

Fast

Ship instantly

Secure

Enterprise grade

Smart AI

Why teams choose us

Feature
Feature
Feature
Feature

After (passing example)

Forge Platform

Governed delivery you can inspect

Structure intent, delegate safely, and keep human review points—presented with calm, deliberate spacing.

Governance spine from intent through review to evidence

Operating model at a glance

Intent

Shape

Clear problem statement before delegation

Execution

Delegate

Bounded jobs and governed LLM tasks

Assurance

Review

Evidence you can trace—not decorative KPI noise

AI.PY.HTML_AUTHORING_QUALITY — Python HTML authoring quality

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Governed delivery

Human-owned intent with agent execution.

Traceable

Evidence on every change.

Reviewable

Gates before release.

Bounded

Clear execution limits.

After (passing example)


What teams gain

Traceable

Evidence on every change

Reviewers can follow intent to work to proof without opening source maps.

Reviewable

Gates before release

Human checkpoints stay visible in the delivery spine.

Bounded

Clear execution limits

Agents and automation run inside declared boundaries.

AI.REACT.PRIMITIVE_CONSISTENCY — React primitive consistency

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Docs health run #8842

WAITING

Started 2026-05-19 · workspace lenses-local

Plan Execute Verify

After (passing example)

Docs health run #8842

Started 2026-05-19 · workspace lenses-local

  • Awaiting review

AI.THEME.PERSONALITY_COHERENCE — Theme personality coherence

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Ship faster with AI!!!

Everything in one platform

Agents, automation, and compliance-ready workflows.

Traceability

Logs everywhere

Enterprise grade

Smart AI

Magic automation

After (passing example)

Forge Platform

Governed delivery you can inspect

Calm dark surfaces, amber primary actions, and cyan structure labels—accents that guide reading instead of decorating every line.

Governance spine from intent through review to evidence

AI.TRUST.BOUNDARY_CLARITY — Trust boundary clarity

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Job execution plane

AI-powered orchestration for modern teams

Our intelligent control plane handles delivery end to end—secure, scalable, and effortless.

Enterprise-grade by design

The platform uses AI agents and bearer-protected orchestration so jobs run safely in your environment. Data stays protected, execution is automated, and the service scales with your tenancy—no manual gates required. See the control plane docs for argv job semantics and SQLite catalogs.

After (passing example)

Job execution plane

Run container jobs on infrastructure you operate

Launch, track, and audit argv jobs through a token-protected API—not a black-box autopilot.

Data stays in your job store and logs on the host you configure. Execution is Docker argv work you trigger via the API. Control stays with operators who hold the bearer token and approve what runs.

AI.VISUAL.HIERARCHY — Visual hierarchy

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Platform

New: Agent orchestration

Governed delivery

Plus LCDL · Fleet · Lenses

Everything you need for AI-assisted SDLC—in one banner.

Live stats

99.9% uptime

Why teams choose Forge

After (passing example)

Forge Platform

Governed delivery you can inspect

One headline carries the fold; tagline and CTAs stay visibly subordinate.

Spine from intent through review to evidence

What changes for your team

Supporting

Evidence trail

Default elevation and body scale—readable, not competing.

Supporting

Bounded automation

Depth links appear after the eye learns the focal path.

Mechanism at lower weight

Mechanism and reference bands use section labels and body copy—not a second display headline in the fold.

AI.VISUAL.PRODUCT_EXPLANATORY_VALUE — Product explanatory value

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Platform

Governed human and agent delivery

See how intent, review gates, and evidence connect across your workspace.

Everything you need

Secure

Enterprise-grade protection

Fast

Move at AI speed

Smart

Powered by agents

After (passing example)

Forge Platform

Governed human and agent delivery

Structure intent, keep human review gates, and ship with evidence—not ambient decoration alone.

The diagram shows the same spine the product implements: intent → review → bounded agent work → release artifact.

Gate chain: Intent, Human review gate, Agent execution inside scope, Release with evidence

Gate chain matches the hero visual

Follow left-to-right: intent is shaped, humans approve, agents execute inside scope, then release carries evidence.

Gate chain: Intent, Human review gate, Agent execution, Release checkpoint

Same topology as the hero: captions name actors and order so the visual teaches structure, not mood.

AI.VISUAL.RHYTHM_SUBJECTIVE — Visual rhythm (subjective)

Lane
ai · page stale
Fixer
AI lane — Cursor agent (invoke-ai-ruleset-harness.sh / remediation plans)
Full handbook
Open handbook — purpose, fixer, remediation, examples

Before (failing example)

Forge Platform

Governed delivery spine

Structure intent and keep review points visible.

What changes

Control

Human gates

Review stays visible.

Evidence

Logs linked inline.

Depth

How it works

Step 1

Shape intent.

Step 2

Delegate with bounds.

12 modules

48 endpoints

∞ agents

After (passing example)

Forge Platform

Governed delivery you can inspect

Structure intent, delegate safely, and keep human review points—presented with deliberate vertical cadence.

Governance spine from intent through review to evidence

From intent to evidence

Step 1

Shape intent

Capture goals and boundaries before delegation.

Step 2

Delegate with bounds

Agents execute inside review gates you define.

4 layers

1 governance spine

0 mystery gaps