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.
DET rules (51) — jump to rule
| Rule | Links |
|---|---|
DET.AMBIENT.Z_INDEX | Examples · Handbook |
DET.APP.FOCUS_TRAP | Examples · Handbook |
DET.APP.PERSISTENT_CHROME | Examples · Handbook |
DET.BUTTON.GROUP.MAX | Examples · Handbook |
DET.CARD.ACTION_LIMIT | Examples · Handbook |
DET.CARD.TITLE | Examples · Handbook |
DET.CATALOG.CONTRACT_SPECIFICITY | Examples · Handbook |
DET.CHART.ALT_SUMMARY | Examples · Handbook |
DET.CHROME.BOUNDARY | Examples · Handbook |
DET.CONTEXT.BURDEN | Examples · Handbook |
DET.CONTRACT.PATH | Examples · Handbook |
DET.CONTRACT.PLACEHOLDERS | Examples · Handbook |
DET.CTA.HIERARCHY | Examples · Handbook |
DET.CTA.LABEL_NONEMPTY | Examples · Handbook |
DET.DATA.COLOR_ONLY | Examples · Handbook |
DET.DATA.TABLE_HEADERS | Examples · Handbook |
DET.DIAGRAM.ALT | Examples · Handbook |
DET.DIAGRAM.ASSET_REGISTRY | Examples · Handbook |
DET.DIAGRAM.LABELS | Examples · Handbook |
DET.HASH.MARKERS | Examples · Handbook |
DET.HASH.REGISTRY_ROW | Examples · Handbook |
DET.HTML.EMPTY_INLINE | Examples · Handbook |
DET.INVENTORY.CROSSWALK | Examples · Handbook |
DET.JS.NO_CONSOLE_ERROR | Examples · Handbook |
DET.JS.PROGRESSIVE | Examples · Handbook |
DET.LANDMARKS.REQUIRED | Examples · Handbook |
DET.LAYOUT.GRID_CONSISTENCY | Examples · Handbook |
DET.MOTION.NO_AUTO_PLAY_FLASH | Examples · Handbook |
DET.MOTION.PREFERS_REDUCED | Examples · Handbook |
DET.NAV.BREADCRUMB | Examples · Handbook |
DET.NAV.DEDUP | Examples · Handbook |
DET.NAV.DEPTH | Examples · Handbook |
DET.NAV.FOCUS_ORDER | Examples · Handbook |
DET.NAV.IN_PAGE_TOC | Examples · Handbook |
DET.PAGE.LANG | Examples · Handbook |
DET.PAGE.MODE | Examples · Handbook |
DET.PAGE.TITLE | Examples · Handbook |
DET.PAGE.VIEWPORT | Examples · Handbook |
DET.PROSE.LENGTH | Examples · Handbook |
DET.PY.KS_HASH_ATTRS | Examples · Handbook |
DET.PY.OPTIONAL_REGIONS | Examples · Handbook |
DET.REACT.A11Y_ROLE | Examples · Handbook |
DET.REACT.KS_ATTRS | Examples · Handbook |
DET.SCREENSHOT.STATUS | Examples · Handbook |
DET.SECTION.HEADING | Examples · Handbook |
DET.SECTION.SINGLE_JOB | Examples · Handbook |
DET.SURFACE.ELEVATION_TOKEN | Examples · Handbook |
DET.THEME.CONTRAST_MIN | Examples · Handbook |
DET.THEME.FONT_STACK | Examples · Handbook |
DET.TOKEN.NO_DRIFT | Examples · Handbook |
DET.VISUAL.RHYTHM | Examples · Handbook |
DET.AMBIENT.Z_INDEX — Ambient layer z-index contract
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
After (passing example)
DET.APP.PERSISTENT_CHROME — Persistent app chrome across routes
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessmulti_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· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- 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.
DET.CARD.TITLE — Card accessible title
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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 moreAfter (passing example)
Outcome
Governed delivery
Shape intent, delegate safely, and release with reviewable evidence.
Learn moreDET.CATALOG.CONTRACT_SPECIFICITY — Catalog contract element specificity
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
After (passing example)
Explore components
DET.CHART.ALT_SUMMARY — Chart accessible summary
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Forge
Chapter
Body
Sidebar and header visually merge with main — no measurable boundary.
After (passing example)
Forge
Handbook
Chapter
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· verifyexpect_rule_clean· harnessstandalone- 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
Shape intent, delegate safely, and release with evidence—not ad hoc prompts.
Three outcomes teams need
Clear intent before agent work starts.
DET.CONTRACT.PATH — Registry contract path resolution
- Lane
deterministic· page stale- Fixer
repo_overlay· verifyexpect_rule_clean· harnessrepo_overlay- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Handbook
Governed delivery
Long-form reading column with sidebar rail.
Body
Markup matches Hbk anatomy, but registry contract path is broken.
After (passing example)
Handbook
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· verifyexpect_rule_clean· harnessrepo_overlay- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Handbook chapter
Lorem ipsum dolor sit amet — orientation TBD.
After (passing example)
Handbook chapter
DET.CTA.HIERARCHY — Primary CTA hierarchy
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- 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)
DET.DATA.COLOR_ONLY — Data color redundancy
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Accent palette
Repository mix
| Check | Status |
|---|---|
| Unit tests | |
| Lint |
After (passing example)
Accent palette
Repository mix
Donut of tracked files by top-level language; Python leads at 41.2%, Markdown 33.8%.
| Check | Status |
|---|---|
| Unit tests | Pass |
| Lint | Fail |
DET.DATA.TABLE_HEADERS — Data table header scope
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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 |
|---|---|---|---|
| Scrum | Agile | 5–9 | 2-week sprint |
| Kanban | Lean | Any | Continuous |
| Forge | AI-native | 1–3 | Spark-driven |
After (passing example)
Tables
Wrap standard Bootstrap tables in .forge-table-wrap for themed styling.
| Methodology | Type | Team size | Iteration |
|---|---|---|---|
| Scrum | Agile | 5–9 | 2-week sprint |
| Kanban | Lean | Any | Continuous |
| Forge | AI-native | 1–3 | Spark-driven |
DET.DIAGRAM.ALT — Diagram decorative vs informative alt
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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
Linear gate chain: Intent → Human review → Agent execution → Release
DET.DIAGRAM.ASSET_REGISTRY — Diagram asset registry
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
How it works
Delivery gate chain
Work moves through intent, human review, agent execution, and release checkpoints.
Custom flow for this landing page only.
After (passing example)
How it works
Delivery gate chain
Work moves through intent, human review, agent execution, and release checkpoints.
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Diagram label coverage
Catalog keys without on-surface names
Modal legend lists Step A–D, but the SVG surface only shows [subtitle] placeholders.
Catalog legend requires Gate 1 and Gate 2; diamonds only show G.
After (passing example)
Diagram label coverage
Legend keys visible on the tile
Step A, Step B, Step C, Step D (matches catalog nodes)
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Handbook
Governed delivery
Layout root missing hash=; sidebar missing data-ks-hash.
Body
Inner card is not a catalog visual root.
After (passing example)
Handbook
Handbook sample page
Markers pair on every governed root.
DET.HASH.REGISTRY_ROW — Visual hash registry crosswalk
- Lane
deterministic· page stale- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
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)
Handbook
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· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessrepo_overlay- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Showcase
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)
Handbook
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· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
After (passing example)
Forge
Handbook
Chapter
Body
One main landmark; sidebar nav and header/footer chrome are exposed to assistive tech.
DET.LAYOUT.GRID_CONSISTENCY — Layout grid consistency
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Mechanism
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)
Mechanism
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Sync in progress — strobing faster than three flashes per second.
After (passing example)
Sync complete — static text; motion reserved for hover accents.
Slow 3s glow — below flash threshold.
DET.MOTION.PREFERS_REDUCED — Prefers-reduced-motion compliance
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Decorative float and pulse keep running when Reduce motion is on.
Quickstart
After (passing example)
Static copy — motion reserved for essential status only.
Quickstart
DET.PAGE.LANG — Document language declaration
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Methodology
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)
Methodology
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Methodology
Governed human + agent delivery
Hero reads as marketing while sidebar reads as handbook.
After (passing example)
Methodology
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Methodology
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)
Methodology
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Methodology
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)
Methodology
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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Mechanism
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
- Define product promise in the hero
- Stage trust boundaries in the next band
- Move API tables to reference docs
- Cap card bullets at three items
- Split paragraphs over eighty-five words
- Run analyze-website-ux on handbook URLs
- Confirm proseLengthReport is empty
- Trim generated link indexes
- Use forge-callout for warnings
- Link long procedural lists
- Re-audit marketing and showcase pages
- File defects in the ruleset harness
- Promote repeated issues to new DET rules
- Publish remediation in kitchensink first
After (passing example)
Mechanism
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
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· verifyexpect_rule_clean· harnessrepo_overlay- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Handbook
Governed delivery
Markers pasted manually in Python — not from chrome_region_attrs().
After (passing example)
Handbook
Handbook sample page
Emitters use ks_catalog_hashes helpers.
DET.PY.OPTIONAL_REGIONS — Py Optional Regions
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
Announcement
After (passing example)
Announcement
DET.REACT.A11Y_ROLE — React A11Y Role
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
After (passing example)
DET.SCREENSHOT.STATUS — Screenshot Status
- Lane
deterministic· page current- Fixer
repo_overlay· verifyexpect_rule_clean· harnessrepo_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· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- 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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
After (passing example)
DET.THEME.CONTRAST_MIN — Theme Contrast Min
- Lane
deterministic· page current- Fixer
handbook_after· verifyexpect_rule_clean· harnessstandalone- 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)
Wrong display stack
Body uses non-token font-family.
After (passing example)
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· verifyexpect_rule_clean· harnessrepo_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· verifyexpect_rule_clean· harnessstandalone- Full handbook
- Open handbook — purpose, fixer, remediation, examples
Before (failing example)
After (passing example)
AI rules
AI rules (20) — jump to rule
| Rule | Links |
|---|---|
AI.AMBIENT.READABILITY_CONFLICT | Examples · Handbook |
AI.APP.DENSITY_BALANCE | Examples · Handbook |
AI.APP.WORKFLOW_CONTINUITY | Examples · Handbook |
AI.CONTEXT.BURDEN_SUBJECTIVE | Examples · Handbook |
AI.CONTEXT.COGNITIVE_CLARITY | Examples · Handbook |
AI.CONTRACT.IMPLEMENTATION_USEFULNESS | Examples · Handbook |
AI.CREDIBILITY.NO_OVERCLAIM | Examples · Handbook |
AI.DATA.INSIGHT_LEGIBILITY | Examples · Handbook |
AI.DIAGRAM.SEMANTIC_ACCURACY | Examples · Handbook |
AI.JS.BEHAVIOR_DISCOVERABILITY | Examples · Handbook |
AI.MOTION.INTENTIONALITY | Examples · Handbook |
AI.NARRATIVE.COHERENCE | Examples · Handbook |
AI.PREMIUM.ENTERPRISE_FEEL | Examples · Handbook |
AI.PY.HTML_AUTHORING_QUALITY | Examples · Handbook |
AI.REACT.PRIMITIVE_CONSISTENCY | Examples · Handbook |
AI.THEME.PERSONALITY_COHERENCE | Examples · Handbook |
AI.TRUST.BOUNDARY_CLARITY | Examples · Handbook |
AI.VISUAL.HIERARCHY | Examples · Handbook |
AI.VISUAL.PRODUCT_EXPLANATORY_VALUE | Examples · Handbook |
AI.VISUAL.RHYTHM_SUBJECTIVE | Examples · 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)
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
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.
How it works
Platform topology
Full subsystem map for readers who already understand the promise.
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.
Outcomes
What you get on day one
Reference
Job plane endpoints
POST /v1/jobs— docker_argv payloadGET /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)
Handbook chapter
After (passing example)
Forge Kitchen Sink
Design system museum
Handbook chapter
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.
Trusted worldwide
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.
Trust model
What we can stand behind
Need a formal attestation? Use your own compliance program; this site explains product behavior only.
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
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)
How it works
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.
After (passing example)
How it works
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.
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
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.
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.
After (passing example)
Governed agent delivery
Intent, delegation, review gates, and evidence—for teams shipping with human-owned control.
Start the methodology tourDiagram 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.
Reference
Workspace API index
GET /v1/workspaces— list tenantsPOST /v1/workspaces— provision hosted project
Trust
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.
Outcomes
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.
How it works
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.
Trust
Local-first by default
Data stays on infrastructure you run; optional Fleet jobs use token-scoped APIs—not a mandatory hosted tenancy.
Start local QuickstartAI.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.
Outcomes
Traceable
Evidence on every change.
Reviewable
Gates before release.
Bounded
Clear execution limits.
After (passing example)
Outcomes
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
WAITINGStarted 2026-05-19 · workspace lenses-local
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)
GOVERNANCE · AI · CLOUD · ANALYTICS
Ship faster with AI!!!
Everything in one platform
Agents, automation, and compliance-ready workflows.
Features
Traceability
Logs everywhere
Security
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.
Outcomes
One temperament across the page
Depth
Neutral glass for supporting copy—cyan label, no third accent hue.
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.
Trust
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.
Trust model
Three boundaries, plain language
Deeper mechanism (argv shape, catalogs) lives in maintainer docs—linked after these boundaries are clear.
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
Control
Human gates everywhere.
Speed
Ship 10× faster with agents.
Compliance
Certified out of the box.
After (passing example)
Forge Platform
Governed delivery you can inspect
One headline carries the fold; tagline and CTAs stay visibly subordinate.
Outcomes
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.
How it works
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.
Why teams choose us
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.
Outcomes
What each layer gives you
How it works
Gate chain matches the hero visual
Follow left-to-right: intent is shaped, humans approve, agents execute inside scope, then release carries evidence.
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.
Outcomes
What changes
Control
Human gates
Review stays visible.
Logs linked inline.
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.
How it works
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