{ "assessor": { "command": [ "" ], "model": "claude-sonnet-5", "preamble": "Evaluate only publicly observable U.S. Web Design System capability supported by the supplied immutable evidence snapshot. Missing public evidence is unknown, not evidence of absence. Keep the USWDS 3.14.0 code release, current production documentation, and the official Figma beta 0.3 kit for USWDS 3.11.0 distinct. Never generalize sampled component evidence beyond its declared scope.", "profile_id": "claude-code/claude-sonnet-5/claude-json/contract-2", "provider": "claude-code", "response_parser": "claude-json", "timeout_seconds": 900 }, "diagnostics": { "evidence_packet_max_chars": 650000, "evidence_packet_max_chars_by_area": { "bindings": 1000000, "components": 1200000, "structure": 900000 }, "fail_fast": true, "heartbeat_seconds": 30, "jobs": 1, "passes": 3 }, "evaluation": { "account_id": "public", "cutoff_date": "2026-09-01", "description": "Three-pass public-evidence diagnostic of the U.S. Web Design System across Foundations, Bindings, Components, Structure, and Governance.", "id": "uswds-public-diagnostic", "name": "USWDS public diagnostic", "results_dir": "./results", "visibility": "public" }, "framework": { "id": "design-system-diagnostic", "minimum_coverage": 1.0, "profile": "cross-surface-comprehensive", "version": "1.1.0" }, "reporting": { "max_excerpt_chars": 280, "public_excerpts": false }, "sampling": [ { "catalog": { "source_ids": [ "uswds-design-kit", "uswds-home-docs", "uswds-component-lifecycle-docs" ] }, "compositions": [ { "component_ids": [ "layout-grid", "step-indicator", "form", "text-input", "checkbox", "button", "alert", "modal" ], "id": "complete-complex-form", "kind": "flow", "known_limitations": [ "USWDS publishes the complete-complex-form guidance as coordinated patterns rather than one downloadable end-to-end implementation.", "This study does not claim that the Figma kit contains a matching complete form flow." ], "name": "Complete, validate, review, and submit a complex form", "provenance": "system-authored", "required_surfaces": [ "code", "documentation" ], "source_ids": [ "uswds-complex-form-pattern", "uswds-progress-form-pattern", "uswds-record-form-pattern", "uswds-component-implementation", "uswds-component-quality", "uswds-form-docs", "uswds-text-input-docs", "uswds-checkbox-docs", "uswds-button-docs", "uswds-alert-docs", "uswds-modal-docs", "uswds-step-indicator-docs", "uswds-layout-grid-docs" ], "states": [ "introduction", "in-progress", "validation-error", "review", "submitted" ], "viewports": [ "mobile", "tablet", "desktop" ] }, { "component_ids": [ "form", "text-input", "checkbox", "alert", "button" ], "id": "form-error-recovery", "kind": "pattern", "name": "Form validation and error recovery", "provenance": "system-authored", "required_surfaces": [ "code", "documentation" ], "source_ids": [ "uswds-form-docs", "uswds-text-input-docs", "uswds-alert-docs", "uswds-button-docs", "uswds-component-implementation", "uswds-component-quality" ], "states": [ "default", "invalid", "corrected", "submitted" ], "viewports": [ "mobile", "desktop" ] }, { "component_ids": [ "header", "layout-grid", "button", "alert", "card" ], "id": "not-found-recovery", "kind": "pattern", "name": "Not-found page with recovery routes", "provenance": "system-authored", "required_surfaces": [ "code", "documentation" ], "source_ids": [ "uswds-404-template", "uswds-component-implementation", "uswds-component-quality", "uswds-header-docs", "uswds-layout-grid-docs", "uswds-button-docs", "uswds-alert-docs", "uswds-card-docs" ], "states": [ "not-found", "suggested-route", "search", "recovered" ], "viewports": [ "mobile", "desktop" ] } ], "deep_components": [ { "archetype": "action", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Button" ] }, "id": "button", "name": "Button", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-button-docs" ] }, { "archetype": "input", "design": { "disposition": "compound", "provenance": "system-authored", "rationale": "USWDS form guidance composes labels, hints, errors, fieldsets, legends, and controls into a supported form contract.", "targets": [ "Form", "Label", "Hint", "Error message" ] }, "id": "form", "name": "Form", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-form-docs" ] }, { "archetype": "input", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Text input" ] }, "id": "text-input", "name": "Text input", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-text-input-docs" ] }, { "archetype": "selection", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Checkbox" ] }, "id": "checkbox", "name": "Checkbox", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-checkbox-docs" ] }, { "archetype": "navigation", "design": { "disposition": "compound", "provenance": "system-authored", "rationale": "The USWDS header coordinates brand, navigation, menu, and search surfaces across basic and extended variants.", "targets": [ "Header", "Navigation", "Search" ] }, "id": "header", "name": "Header", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-header-docs" ] }, { "archetype": "overlay", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Modal" ] }, "id": "modal", "name": "Modal", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-modal-docs" ] }, { "archetype": "feedback", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Alert" ] }, "id": "alert", "name": "Alert", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-alert-docs" ] }, { "archetype": "content", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Card" ] }, "id": "card", "name": "Card", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-card-docs" ] }, { "archetype": "status", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Step indicator" ] }, "id": "step-indicator", "name": "Step indicator", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-step-indicator-docs" ] }, { "archetype": "layout", "design": { "disposition": "compound", "provenance": "mixed", "rationale": "USWDS publishes a responsive code grid and design-kit smart layouts, but the detailed Figma-to-utility mapping is not available as a public machine-readable contract.", "targets": [ "Layout grid", "Grid row", "Grid column" ] }, "id": "layout-grid", "name": "Layout grid", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-layout-grid-docs" ] }, { "archetype": "data-display", "design": { "disposition": "component", "provenance": "system-authored", "targets": [ "Table" ] }, "id": "table", "name": "Table", "source_ids": [ "uswds-design-kit", "uswds-component-implementation", "uswds-component-quality", "uswds-table-docs" ] } ], "foundations": { "known_limitations": [ "The official design-kit release states that all tokens are represented as Figma variables, but this study did not have a live Figma API export of the variable inventory.", "The official Figma beta 0.3 kit targets USWDS 3.11.0 and is older than the evaluated USWDS 3.14.0 code release." ], "source_ids": [ "uswds-design-kit", "uswds-foundation-code", "uswds-design-assets-docs", "uswds-token-docs", "uswds-color-token-docs", "uswds-settings-docs", "uswds-utility-docs", "uswds-accessibility-docs", "uswds-layout-grid-docs" ], "variable_coverage": "full-file" }, "governance": { "known_limitations": [ "Internal GSA staffing, adoption, review-time, exception, and quality trend data are outside this public evaluation.", "The public evidence does not establish every internal decision and approval used for design-kit and code changes.", "The official design-kit repository states that USWDS had one staff member in March 2026 and did not expect to prioritize design-file updates; the study evaluates the resulting public evidence boundary without inferring unobserved internal capability." ], "scope": "public", "source_ids": [ "uswds-design-kit", "uswds-home-docs", "uswds-accessibility-docs", "uswds-component-lifecycle-docs", "uswds-governance-code", "uswds-component-quality", "uswds-migration-docs", "uswds-release-docs", "uswds-maturity-model" ] }, "system": "uswds" } ], "sources": [ { "areas": [ "foundations", "bindings", "components", "structure", "governance" ], "evidence_authority": "historical", "evidence_roles": [ "foundation", "design", "catalog", "governance" ], "id": "uswds-design-kit", "max_bytes": 8000000, "paths": [ "README.md", "CONTRIBUTING.md", "LICENSE.md", ".github/CODEOWNERS", "figma/uswds-design-kit-beta.fig" ], "ref": "cf52f8084cfa2d2d10bde8c94bb00e92c97d2251", "repo": "uswds/uswds-for-designers", "required": true, "system": "uswds", "type": "github" }, { "areas": [ "foundations", "bindings" ], "evidence_authority": "observed", "evidence_roles": [ "foundation", "code", "quality" ], "id": "uswds-foundation-code", "max_bytes": 12000000, "paths": [ "package.json", "README.md", "packages/uswds-core/README.md", "packages/uswds-core/src/styles/_defaults.scss", "packages/uswds-core/src/styles/_properties.scss", "packages/uswds-core/src/styles/settings/_settings-color.scss", "packages/uswds-core/src/styles/settings/_settings-components.scss", "packages/uswds-core/src/styles/settings/_settings-general.scss", "packages/uswds-core/src/styles/settings/_settings-spacing.scss", "packages/uswds-core/src/styles/settings/_settings-typography.scss", "packages/uswds-core/src/styles/settings/_settings-utilities.scss", "packages/uswds-core/src/styles/tokens/_index.scss", "packages/uswds-core/src/styles/variables/color-palette-grayscale.scss", "packages/uswds-core/src/styles/variables/project-colors.scss", "packages/uswds-core/src/styles/variables/project-spacing.scss", "packages/uswds-core/src/styles/variables/theme-color-grades.scss", "packages/uswds-core/src/styles/variables/type-scale.scss", "packages/uswds-core/src/styles/variables/wcag-magic-numbers.scss", "packages/uswds-core/src/styles/functions/_index.scss", "packages/uswds-core/src/styles/mixins/_index.scss", "packages/uswds-core/src/styles/mixins/_utility-builder.scss", "packages/uswds-core/src/test/sass.spec.js", "packages/uswds-core/src/test/tests.scss" ], "ref": "92391c3b1bf536d15fe85846c16c2c0937049b16", "repo": "uswds/uswds", "required": true, "system": "uswds", "type": "github" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "observed", "evidence_roles": [ "code", "composition" ], "id": "uswds-component-implementation", "max_bytes": 16000000, "paths": [ "packages/usa-button/src/usa-button.twig", "packages/usa-button/src/usa-button.stories.js", "packages/usa-button/src/styles/_usa-button.scss", "packages/usa-form/src/usa-form.stories.js", "packages/usa-form/src/styles/_usa-form.scss", "packages/usa-input/src/usa-input.twig", "packages/usa-input/src/usa-input.stories.js", "packages/usa-input/src/styles/_usa-input.scss", "packages/usa-checkbox/src/usa-checkbox.twig", "packages/usa-checkbox/src/usa-checkbox--tile.twig", "packages/usa-checkbox/src/usa-checkbox.stories.js", "packages/usa-checkbox/src/styles/_usa-checkbox.scss", "packages/usa-header/src/index.js", "packages/usa-header/src/usa-header.twig", "packages/usa-header/src/usa-header--extended/usa-header--extended.twig", "packages/usa-header/src/usa-header.stories.js", "packages/usa-header/src/styles/_usa-header.scss", "packages/usa-modal/src/index.js", "packages/usa-modal/src/usa-modal.twig", "packages/usa-modal/src/usa-modal.stories.js", "packages/usa-modal/src/styles/_usa-modal.scss", "packages/usa-alert/src/usa-alert.twig", "packages/usa-alert/src/usa-alert.stories.js", "packages/usa-alert/src/styles/_usa-alert.scss", "packages/usa-card/src/usa-card.twig", "packages/usa-card/src/usa-card.stories.js", "packages/usa-card/src/styles/_usa-card.scss", "packages/usa-step-indicator/src/usa-step-indicator.twig", "packages/usa-step-indicator/src/usa-step-indicator.stories.js", "packages/usa-step-indicator/src/styles/_usa-step-indicator.scss", "packages/usa-layout-grid/src/styles/_usa-layout-grid.scss", "packages/usa-table/src/index.js", "packages/usa-table/src/usa-table.twig", "packages/usa-table/src/usa-table--sortable/usa-table--sortable.twig", "packages/usa-table/src/usa-table.stories.js", "packages/usa-table/src/styles/_usa-table.scss", "packages/templates/usa-create-account/usa-create-account.twig", "packages/templates/usa-error/usa-error.twig" ], "ref": "92391c3b1bf536d15fe85846c16c2c0937049b16", "repo": "uswds/uswds", "required": true, "system": "uswds", "type": "github" }, { "areas": [ "components", "structure", "governance" ], "evidence_authority": "observed", "evidence_roles": [ "code", "quality", "governance" ], "id": "uswds-component-quality", "max_bytes": 12000000, "paths": [ "package.json", ".storybook/test-runner.js", ".circleci/config.yml", ".github/workflows/codeql-analysis.yml", "packages/usa-modal/src/test/modal.spec.js", "packages/usa-modal/src/test/template.html", "packages/usa-table/src/test/table.spec.js", "packages/usa-table/src/test/template.html", "packages/usa-header/src/usa-header.stories.js", "packages/usa-button/src/usa-button.stories.js", "packages/usa-form/src/usa-form.stories.js", "packages/usa-input/src/usa-input.stories.js", "packages/usa-checkbox/src/usa-checkbox.stories.js", "packages/usa-modal/src/usa-modal.stories.js", "packages/usa-alert/src/usa-alert.stories.js", "packages/usa-card/src/usa-card.stories.js", "packages/usa-step-indicator/src/usa-step-indicator.stories.js", "packages/usa-table/src/usa-table.stories.js", "src/test/build.spec.js", "src/test/include.spec.js", "tasks/test.js" ], "ref": "92391c3b1bf536d15fe85846c16c2c0937049b16", "repo": "uswds/uswds", "required": true, "system": "uswds", "type": "github" }, { "areas": [ "bindings", "governance" ], "evidence_authority": "release", "evidence_roles": [ "documentation", "governance", "quality", "code" ], "id": "uswds-governance-code", "max_bytes": 12000000, "paths": [ "README.md", "CONTRIBUTING.md", "GOVERNANCE.md", "COMMUNITY.md", "SECURITY.md", "LICENSE.md", ".github/CODEOWNERS", ".github/PULL_REQUEST_TEMPLATE.md", ".github/DISCUSSION_TEMPLATE/component-proposals.yml", ".github/ISSUE_TEMPLATE/bug_report.yaml", ".github/ISSUE_TEMPLATE/feature_request.yaml", ".github/ISSUE_TEMPLATE/contributor_ladder.md", ".circleci/config.yml", ".github/workflows/release-prep.yml", ".github/workflows/release.yml", "packages/uswds-core/src/styles/_notifications.scss", "security/README.md", "security/uswds-3.14.0-zip-hash.txt", "package.json" ], "ref": "92391c3b1bf536d15fe85846c16c2c0937049b16", "repo": "uswds/uswds", "required": true, "system": "uswds", "type": "github" }, { "areas": [ "foundations", "components", "structure", "governance" ], "evidence_authority": "normative", "evidence_roles": [ "catalog", "documentation", "composition", "governance" ], "id": "uswds-home-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/" }, { "areas": [ "foundations", "bindings", "components", "governance" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "design", "documentation", "catalog", "governance" ], "id": "uswds-design-assets-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/documentation/getting-started-for-designers/" }, { "areas": [ "foundations", "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "documentation" ], "id": "uswds-token-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/design-tokens/" }, { "areas": [ "foundations", "bindings", "components" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "documentation" ], "id": "uswds-color-token-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/design-tokens/color/theme-tokens/" }, { "areas": [ "foundations", "bindings", "components" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "code", "documentation" ], "id": "uswds-settings-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/documentation/settings/" }, { "areas": [ "foundations", "bindings", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "code", "documentation", "composition" ], "id": "uswds-utility-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/utilities/" }, { "areas": [ "foundations", "components", "structure", "governance" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "documentation", "quality", "governance" ], "id": "uswds-accessibility-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/documentation/accessibility/" }, { "areas": [ "components", "governance" ], "evidence_authority": "normative", "evidence_roles": [ "catalog", "documentation", "governance", "quality" ], "id": "uswds-component-lifecycle-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/lifecycle/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-button-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/button/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-form-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/form/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-text-input-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/text-input/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-checkbox-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/checkbox/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-header-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/header/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-modal-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/modal/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-alert-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/alert/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition", "quality" ], "id": "uswds-card-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/card/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-step-indicator-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/step-indicator/" }, { "areas": [ "foundations", "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "foundation", "code", "documentation", "composition" ], "id": "uswds-layout-grid-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/utilities/layout-grid/" }, { "areas": [ "bindings", "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition", "quality" ], "id": "uswds-table-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/components/table/" }, { "areas": [ "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-complex-form-pattern", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/patterns/complete-a-complex-form/" }, { "areas": [ "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-progress-form-pattern", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/patterns/complete-a-complex-form/progress-easily/" }, { "areas": [ "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-record-form-pattern", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/patterns/complete-a-complex-form/keep-a-record/" }, { "areas": [ "components", "structure" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition" ], "id": "uswds-404-template", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/templates/404-page/" }, { "areas": [ "bindings", "governance" ], "evidence_authority": "release", "evidence_roles": [ "documentation", "governance" ], "id": "uswds-migration-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/documentation/migration/" }, { "areas": [ "bindings", "components", "governance" ], "evidence_authority": "release", "evidence_roles": [ "documentation", "governance", "quality" ], "id": "uswds-release-docs", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://github.com/uswds/uswds/releases/tag/v3.14.0" }, { "areas": [ "foundations", "components", "structure", "governance" ], "evidence_authority": "normative", "evidence_roles": [ "documentation", "composition", "governance" ], "id": "uswds-maturity-model", "max_bytes": 5000000, "required": true, "system": "uswds", "type": "web", "url": "https://designsystem.digital.gov/maturity-model/" } ], "systems": [ { "description": "The U.S. General Services Administration's public design system for accessible, mobile-friendly federal websites and digital services.", "id": "uswds", "license": "CC0-1.0 and third-party asset licenses", "name": "U.S. Web Design System", "platform": "web", "role": "breadth", "version": "USWDS 3.14.0 / Figma design kit beta 0.3 for USWDS 3.11.0" } ], "version": 2 }