onto-mcp 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.onto/authority/core-lens-registry.yaml +134 -0
- package/.onto/authority/core-lexicon.yaml +1562 -0
- package/.onto/authority/diagnostic-codes.yaml +94 -0
- package/.onto/domains/accounting/competency_qs.md +384 -0
- package/.onto/domains/accounting/concepts.md +186 -0
- package/.onto/domains/accounting/conciseness_rules.md +160 -0
- package/.onto/domains/accounting/dependency_rules.md +239 -0
- package/.onto/domains/accounting/domain_scope.md +213 -0
- package/.onto/domains/accounting/extension_cases.md +416 -0
- package/.onto/domains/accounting/logic_rules.md +226 -0
- package/.onto/domains/accounting/structure_spec.md +298 -0
- package/.onto/domains/accounting-kr/competency_qs.md +562 -0
- package/.onto/domains/accounting-kr/concepts.md +187 -0
- package/.onto/domains/accounting-kr/conciseness_rules.md +125 -0
- package/.onto/domains/accounting-kr/dependency_rules.md +93 -0
- package/.onto/domains/accounting-kr/domain_scope.md +140 -0
- package/.onto/domains/accounting-kr/extension_cases.md +343 -0
- package/.onto/domains/accounting-kr/logic_rules.md +160 -0
- package/.onto/domains/accounting-kr/structure_spec.md +85 -0
- package/.onto/domains/business/competency_qs.md +263 -0
- package/.onto/domains/business/concepts.md +200 -0
- package/.onto/domains/business/conciseness_rules.md +135 -0
- package/.onto/domains/business/dependency_rules.md +113 -0
- package/.onto/domains/business/domain_scope.md +240 -0
- package/.onto/domains/business/extension_cases.md +249 -0
- package/.onto/domains/business/logic_rules.md +134 -0
- package/.onto/domains/business/structure_spec.md +114 -0
- package/.onto/domains/finance/competency_qs.md +362 -0
- package/.onto/domains/finance/concepts.md +194 -0
- package/.onto/domains/finance/conciseness_rules.md +155 -0
- package/.onto/domains/finance/dependency_rules.md +171 -0
- package/.onto/domains/finance/domain_scope.md +215 -0
- package/.onto/domains/finance/extension_cases.md +350 -0
- package/.onto/domains/finance/logic_rules.md +191 -0
- package/.onto/domains/finance/structure_spec.md +182 -0
- package/.onto/domains/llm-native-development/competency_qs.md +430 -0
- package/.onto/domains/llm-native-development/concepts.md +242 -0
- package/.onto/domains/llm-native-development/conciseness_rules.md +163 -0
- package/.onto/domains/llm-native-development/dependency_rules.md +216 -0
- package/.onto/domains/llm-native-development/domain_scope.md +197 -0
- package/.onto/domains/llm-native-development/extension_cases.md +474 -0
- package/.onto/domains/llm-native-development/logic_rules.md +123 -0
- package/.onto/domains/llm-native-development/prompt_interface.md +49 -0
- package/.onto/domains/llm-native-development/structure_spec.md +245 -0
- package/.onto/domains/market-intelligence/competency_qs.md +274 -0
- package/.onto/domains/market-intelligence/concepts.md +233 -0
- package/.onto/domains/market-intelligence/conciseness_rules.md +165 -0
- package/.onto/domains/market-intelligence/dependency_rules.md +197 -0
- package/.onto/domains/market-intelligence/domain_scope.md +231 -0
- package/.onto/domains/market-intelligence/extension_cases.md +425 -0
- package/.onto/domains/market-intelligence/logic_rules.md +247 -0
- package/.onto/domains/market-intelligence/structure_spec.md +209 -0
- package/.onto/domains/ontology/competency_qs.md +394 -0
- package/.onto/domains/ontology/concepts.md +172 -0
- package/.onto/domains/ontology/conciseness_rules.md +134 -0
- package/.onto/domains/ontology/dependency_rules.md +125 -0
- package/.onto/domains/ontology/domain_scope.md +114 -0
- package/.onto/domains/ontology/extension_cases.md +501 -0
- package/.onto/domains/ontology/logic_rules.md +114 -0
- package/.onto/domains/ontology/problem_framing_profile.md +67 -0
- package/.onto/domains/ontology/structure_spec.md +115 -0
- package/.onto/domains/palantir-foundry/RESEARCH_NOTES.md +911 -0
- package/.onto/domains/palantir-foundry/competency_qs.md +191 -0
- package/.onto/domains/palantir-foundry/competitive_comparison.md +329 -0
- package/.onto/domains/palantir-foundry/concepts.md +197 -0
- package/.onto/domains/palantir-foundry/conciseness_rules.md +245 -0
- package/.onto/domains/palantir-foundry/dependency_rules.md +135 -0
- package/.onto/domains/palantir-foundry/domain_scope.md +395 -0
- package/.onto/domains/palantir-foundry/extension_cases.md +210 -0
- package/.onto/domains/palantir-foundry/logic_rules.md +172 -0
- package/.onto/domains/palantir-foundry/structure_spec.md +291 -0
- package/.onto/domains/software-engineering/competency_qs.md +538 -0
- package/.onto/domains/software-engineering/concepts.md +238 -0
- package/.onto/domains/software-engineering/conciseness_rules.md +167 -0
- package/.onto/domains/software-engineering/dependency_rules.md +216 -0
- package/.onto/domains/software-engineering/domain_scope.md +183 -0
- package/.onto/domains/software-engineering/extension_cases.md +551 -0
- package/.onto/domains/software-engineering/logic_rules.md +240 -0
- package/.onto/domains/software-engineering/problem_framing_profile.md +68 -0
- package/.onto/domains/software-engineering/structure_spec.md +185 -0
- package/.onto/domains/ui-design/competency_qs.md +567 -0
- package/.onto/domains/ui-design/concepts.md +194 -0
- package/.onto/domains/ui-design/conciseness_rules.md +190 -0
- package/.onto/domains/ui-design/dependency_rules.md +323 -0
- package/.onto/domains/ui-design/domain_scope.md +340 -0
- package/.onto/domains/ui-design/extension_cases.md +563 -0
- package/.onto/domains/ui-design/logic_rules.md +349 -0
- package/.onto/domains/ui-design/structure_spec.md +252 -0
- package/.onto/domains/visual-design/competency_qs.md +472 -0
- package/.onto/domains/visual-design/concepts.md +147 -0
- package/.onto/domains/visual-design/conciseness_rules.md +186 -0
- package/.onto/domains/visual-design/dependency_rules.md +282 -0
- package/.onto/domains/visual-design/domain_scope.md +290 -0
- package/.onto/domains/visual-design/extension_cases.md +480 -0
- package/.onto/domains/visual-design/logic_rules.md +232 -0
- package/.onto/domains/visual-design/structure_spec.md +213 -0
- package/.onto/principles/llm-native-development-guideline.md +401 -0
- package/.onto/principles/llm-runtime-interface-principles.md +665 -0
- package/.onto/principles/non-specialist-communication-guideline.md +74 -0
- package/.onto/principles/ontology-as-code-guideline.md +243 -0
- package/.onto/principles/ontology-as-code-naming-charter.md +130 -0
- package/.onto/principles/product-locality-principle.md +129 -0
- package/.onto/principles/productization-charter.md +569 -0
- package/.onto/processes/evolve/material-kind-adapter-contract.md +113 -0
- package/.onto/processes/reconstruct/reconstruct-boundary-contract.md +366 -0
- package/.onto/processes/reconstruct/source-profile-contract.md +107 -0
- package/.onto/processes/reconstruct/source-profiles/code.md +72 -0
- package/.onto/processes/reconstruct/source-profiles/database.md +74 -0
- package/.onto/processes/reconstruct/source-profiles/document.md +71 -0
- package/.onto/processes/reconstruct/source-profiles/spreadsheet.md +79 -0
- package/.onto/processes/review/binding-contract.md +270 -0
- package/.onto/processes/review/execution-preparation-artifacts.md +281 -0
- package/.onto/processes/review/interpretation-contract.md +245 -0
- package/.onto/processes/review/issue-stance-deliberation-contract.md +761 -0
- package/.onto/processes/review/lens-prompt-contract.md +402 -0
- package/.onto/processes/review/lens-registry.md +127 -0
- package/.onto/processes/review/pre-dispatch-contracts.md +428 -0
- package/.onto/processes/review/productized-live-path.md +398 -0
- package/.onto/processes/review/prompt-execution-runner-contract.md +187 -0
- package/.onto/processes/review/record-contract.md +427 -0
- package/.onto/processes/review/record-field-mapping.md +337 -0
- package/.onto/processes/review/review-context-manifest-contract.md +356 -0
- package/.onto/processes/review/review-execution-ux-contract.md +809 -0
- package/.onto/processes/review/review-target-profile-contract.md +259 -0
- package/.onto/processes/review/shared-phenomenon-contract.md +129 -0
- package/.onto/processes/review/synthesize-prompt-contract.md +343 -0
- package/.onto/processes/shared/target-material-kind-contract.md +198 -0
- package/.onto/roles/axiology.md +81 -0
- package/.onto/roles/conciseness.md +36 -0
- package/.onto/roles/coverage.md +34 -0
- package/.onto/roles/dependency.md +37 -0
- package/.onto/roles/evolution.md +35 -0
- package/.onto/roles/logic.md +104 -0
- package/.onto/roles/pragmatics.md +32 -0
- package/.onto/roles/semantics.md +36 -0
- package/.onto/roles/structure.md +33 -0
- package/.onto/roles/synthesize.md +92 -0
- package/AGENTS.md +240 -0
- package/CLAUDE.md +39 -0
- package/README.md +287 -0
- package/bin/onto +92 -0
- package/dist/cli.js +101 -0
- package/dist/core-api/reconstruct-api.js +222 -0
- package/dist/core-api/review-api.js +1271 -0
- package/dist/core-runtime/cli/assemble-review-record.js +431 -0
- package/dist/core-runtime/cli/bootstrap-review-binding.js +186 -0
- package/dist/core-runtime/cli/codex-nested-dispatch.js +226 -0
- package/dist/core-runtime/cli/codex-nested-dispatch.test.js +390 -0
- package/dist/core-runtime/cli/codex-nested-teamlead-executor.js +464 -0
- package/dist/core-runtime/cli/codex-nested-teamlead-executor.test.js +335 -0
- package/dist/core-runtime/cli/codex-review-unit-executor.js +228 -0
- package/dist/core-runtime/cli/complete-review-session.js +64 -0
- package/dist/core-runtime/cli/complexity-assessment.js +153 -0
- package/dist/core-runtime/cli/coordinator-helpers.js +583 -0
- package/dist/core-runtime/cli/coordinator-state-machine-deliberation.test.js +167 -0
- package/dist/core-runtime/cli/coordinator-state-machine.js +794 -0
- package/dist/core-runtime/cli/e2e-codex-multi-agent-fixes.test.js +615 -0
- package/dist/core-runtime/cli/e2e-start-review-session.test.js +312 -0
- package/dist/core-runtime/cli/health.js +44 -0
- package/dist/core-runtime/cli/inline-http-review-unit-executor.js +656 -0
- package/dist/core-runtime/cli/inline-http-review-unit-executor.test.js +567 -0
- package/dist/core-runtime/cli/materialize-review-execution-preparation.js +104 -0
- package/dist/core-runtime/cli/materialize-review-prompt-packets.js +952 -0
- package/dist/core-runtime/cli/migrate-session-roots.js +118 -0
- package/dist/core-runtime/cli/mock-review-unit-executor.js +285 -0
- package/dist/core-runtime/cli/onto-tools.js +369 -0
- package/dist/core-runtime/cli/prepare-review-session.js +272 -0
- package/dist/core-runtime/cli/render-review-final-output.js +350 -0
- package/dist/core-runtime/cli/repo-layout-migration-replace.smoke.test.js +106 -0
- package/dist/core-runtime/cli/review-invoke-auto-resolution.test.js +268 -0
- package/dist/core-runtime/cli/review-invoke-coordinator-topology.test.js +136 -0
- package/dist/core-runtime/cli/review-invoke-resolver-caching.test.js +201 -0
- package/dist/core-runtime/cli/review-invoke-topology-dispatch.test.js +192 -0
- package/dist/core-runtime/cli/review-invoke.js +2030 -0
- package/dist/core-runtime/cli/run-review-prompt-execution.js +2152 -0
- package/dist/core-runtime/cli/session-root-guard.js +168 -0
- package/dist/core-runtime/cli/spawn-watcher.js +173 -0
- package/dist/core-runtime/cli/spawn-watcher.test.js +457 -0
- package/dist/core-runtime/cli/start-review-session.js +68 -0
- package/dist/core-runtime/cli/strip-wrapping-code-fence.js +56 -0
- package/dist/core-runtime/cli/strip-wrapping-code-fence.test.js +79 -0
- package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.js +412 -0
- package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.test.js +351 -0
- package/dist/core-runtime/cli/topology-executor-mapping.js +139 -0
- package/dist/core-runtime/cli/topology-executor-mapping.test.js +173 -0
- package/dist/core-runtime/cli/write-review-interpretation.js +81 -0
- package/dist/core-runtime/config/onto-config-cli.js +278 -0
- package/dist/core-runtime/config/onto-config-key-path.js +288 -0
- package/dist/core-runtime/config/onto-config-key-path.test.js +195 -0
- package/dist/core-runtime/config/onto-config-preview.js +108 -0
- package/dist/core-runtime/config/onto-config-preview.test.js +132 -0
- package/dist/core-runtime/discovery/config-chain.js +118 -0
- package/dist/core-runtime/discovery/config-chain.test.js +103 -0
- package/dist/core-runtime/discovery/config-profile.js +199 -0
- package/dist/core-runtime/discovery/config-profile.test.js +233 -0
- package/dist/core-runtime/discovery/host-detection.js +33 -0
- package/dist/core-runtime/discovery/host-detection.test.js +186 -0
- package/dist/core-runtime/discovery/installation-paths.js +21 -0
- package/dist/core-runtime/discovery/installation-paths.test.js +65 -0
- package/dist/core-runtime/discovery/lens-registry.js +60 -0
- package/dist/core-runtime/discovery/lens-registry.test.js +81 -0
- package/dist/core-runtime/discovery/onto-home.js +71 -0
- package/dist/core-runtime/discovery/path-normalization.js +28 -0
- package/dist/core-runtime/discovery/path-normalization.test.js +22 -0
- package/dist/core-runtime/discovery/plugin-path.js +72 -0
- package/dist/core-runtime/discovery/plugin-path.test.js +95 -0
- package/dist/core-runtime/discovery/project-root.js +47 -0
- package/dist/core-runtime/discovery/settings-chain.js +353 -0
- package/dist/core-runtime/discovery/walk-up.js +17 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.js +344 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.test.js +915 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile.js +564 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile.test.js +708 -0
- package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.js +165 -0
- package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.test.js +227 -0
- package/dist/core-runtime/evolve/adapters/code-product/validators/validate.js +59 -0
- package/dist/core-runtime/evolve/adapters/code-product/validators/validate.test.js +205 -0
- package/dist/core-runtime/evolve/adapters/methodology/adapter.js +16 -0
- package/dist/core-runtime/evolve/adapters/methodology/adapter.test.js +9 -0
- package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.js +298 -0
- package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.test.js +70 -0
- package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.js +46 -0
- package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.test.js +73 -0
- package/dist/core-runtime/evolve/adapters/registry.js +47 -0
- package/dist/core-runtime/evolve/adapters/registry.test.js +67 -0
- package/dist/core-runtime/evolve/cli.js +256 -0
- package/dist/core-runtime/evolve/commands/align.js +194 -0
- package/dist/core-runtime/evolve/commands/align.test.js +82 -0
- package/dist/core-runtime/evolve/commands/apply.js +161 -0
- package/dist/core-runtime/evolve/commands/apply.test.js +138 -0
- package/dist/core-runtime/evolve/commands/close.js +39 -0
- package/dist/core-runtime/evolve/commands/close.test.js +99 -0
- package/dist/core-runtime/evolve/commands/defer.js +40 -0
- package/dist/core-runtime/evolve/commands/defer.test.js +134 -0
- package/dist/core-runtime/evolve/commands/draft.js +323 -0
- package/dist/core-runtime/evolve/commands/draft.test.js +178 -0
- package/dist/core-runtime/evolve/commands/e2e-evolve-full-cycle.test.js +208 -0
- package/dist/core-runtime/evolve/commands/error-messages.js +125 -0
- package/dist/core-runtime/evolve/commands/error-messages.test.js +167 -0
- package/dist/core-runtime/evolve/commands/propose-align.js +222 -0
- package/dist/core-runtime/evolve/commands/propose-align.test.js +136 -0
- package/dist/core-runtime/evolve/commands/reconstruct.js +330 -0
- package/dist/core-runtime/evolve/commands/reconstruct.test.js +278 -0
- package/dist/core-runtime/evolve/commands/shared.js +22 -0
- package/dist/core-runtime/evolve/commands/stale-check.js +103 -0
- package/dist/core-runtime/evolve/commands/stale-check.test.js +84 -0
- package/dist/core-runtime/evolve/commands/start.js +887 -0
- package/dist/core-runtime/evolve/commands/start.test.js +396 -0
- package/dist/core-runtime/evolve/config/project-config.js +99 -0
- package/dist/core-runtime/evolve/config/project-config.test.js +170 -0
- package/dist/core-runtime/evolve/renderers/align-packet.js +280 -0
- package/dist/core-runtime/evolve/renderers/align-packet.test.js +332 -0
- package/dist/core-runtime/evolve/renderers/draft-packet.js +303 -0
- package/dist/core-runtime/evolve/renderers/draft-packet.test.js +377 -0
- package/dist/core-runtime/evolve/renderers/format.js +5 -0
- package/dist/core-runtime/evolve/renderers/scope-md.js +237 -0
- package/dist/core-runtime/evolve/renderers/scope-md.test.js +306 -0
- package/dist/core-runtime/govern/cli.js +369 -0
- package/dist/core-runtime/govern/cli.test.js +314 -0
- package/dist/core-runtime/govern/drift-engine.js +103 -0
- package/dist/core-runtime/govern/drift-engine.test.js +319 -0
- package/dist/core-runtime/govern/promote-principle.js +206 -0
- package/dist/core-runtime/govern/promote-principle.test.js +368 -0
- package/dist/core-runtime/govern/queue.js +81 -0
- package/dist/core-runtime/govern/types.js +16 -0
- package/dist/core-runtime/install/cli.js +530 -0
- package/dist/core-runtime/install/detect.js +128 -0
- package/dist/core-runtime/install/detect.test.js +155 -0
- package/dist/core-runtime/install/gitignore-update.js +74 -0
- package/dist/core-runtime/install/gitignore-update.test.js +64 -0
- package/dist/core-runtime/install/install-integration.test.js +373 -0
- package/dist/core-runtime/install/prompts.js +389 -0
- package/dist/core-runtime/install/prompts.test.js +293 -0
- package/dist/core-runtime/install/types.js +26 -0
- package/dist/core-runtime/install/validation.js +295 -0
- package/dist/core-runtime/install/validation.test.js +313 -0
- package/dist/core-runtime/install/writer.js +254 -0
- package/dist/core-runtime/install/writer.test.js +218 -0
- package/dist/core-runtime/learning/extractor.js +461 -0
- package/dist/core-runtime/learning/feedback.js +179 -0
- package/dist/core-runtime/learning/health-report.js +165 -0
- package/dist/core-runtime/learning/health-report.test.js +169 -0
- package/dist/core-runtime/learning/loader.js +388 -0
- package/dist/core-runtime/learning/loader.test.js +102 -0
- package/dist/core-runtime/learning/promote/apply-state.js +240 -0
- package/dist/core-runtime/learning/promote/audit-obligation.js +195 -0
- package/dist/core-runtime/learning/promote/collector.js +432 -0
- package/dist/core-runtime/learning/promote/degraded-state.js +125 -0
- package/dist/core-runtime/learning/promote/domain-doc-proposer.js +166 -0
- package/dist/core-runtime/learning/promote/e2e-promote.test.js +6385 -0
- package/dist/core-runtime/learning/promote/health-snapshot.js +150 -0
- package/dist/core-runtime/learning/promote/insight-reclassifier.js +544 -0
- package/dist/core-runtime/learning/promote/judgment-auditor.js +517 -0
- package/dist/core-runtime/learning/promote/panel-reviewer.js +1158 -0
- package/dist/core-runtime/learning/promote/promote-executor.js +1675 -0
- package/dist/core-runtime/learning/promote/promoter.js +307 -0
- package/dist/core-runtime/learning/promote/retirement.js +122 -0
- package/dist/core-runtime/learning/promote/types.js +23 -0
- package/dist/core-runtime/learning/prompt-sections.js +51 -0
- package/dist/core-runtime/learning/shared/artifact-registry-init.js +45 -0
- package/dist/core-runtime/learning/shared/artifact-registry.js +254 -0
- package/dist/core-runtime/learning/shared/audit-obligation-kernel.js +73 -0
- package/dist/core-runtime/learning/shared/audit-state.js +99 -0
- package/dist/core-runtime/learning/shared/duplicate-check.js +28 -0
- package/dist/core-runtime/learning/shared/llm-caller.js +831 -0
- package/dist/core-runtime/learning/shared/llm-caller.test.js +601 -0
- package/dist/core-runtime/learning/shared/llm-tool-loop.js +393 -0
- package/dist/core-runtime/learning/shared/mode.js +25 -0
- package/dist/core-runtime/learning/shared/paths.js +84 -0
- package/dist/core-runtime/learning/shared/paths.test.js +79 -0
- package/dist/core-runtime/learning/shared/patterns.js +37 -0
- package/dist/core-runtime/learning/shared/recoverability.js +355 -0
- package/dist/core-runtime/learning/shared/recovery-context.js +374 -0
- package/dist/core-runtime/learning/shared/scope.js +1 -0
- package/dist/core-runtime/learning/shared/semantic-classifier.js +94 -0
- package/dist/core-runtime/learning/shared/specs/apply-execution-state-spec.js +42 -0
- package/dist/core-runtime/learning/shared/specs/audit-state-spec.js +37 -0
- package/dist/core-runtime/learning/shared/specs/backup-metadata-spec.js +39 -0
- package/dist/core-runtime/learning/shared/specs/emergency-log-spec.js +41 -0
- package/dist/core-runtime/learning/shared/specs/layout-version-spec.js +38 -0
- package/dist/core-runtime/learning/shared/specs/promote-decisions-spec.js +43 -0
- package/dist/core-runtime/learning/shared/specs/promote-report-spec.js +113 -0
- package/dist/core-runtime/learning/shared/specs/prune-log-spec.js +36 -0
- package/dist/core-runtime/learning/shared/specs/recovery-resolution-spec.js +48 -0
- package/dist/core-runtime/learning/shared/specs/restore-manifest-spec.js +43 -0
- package/dist/core-runtime/learning/shared/specs/spec-helpers.js +64 -0
- package/dist/core-runtime/learning/usage-tracker.js +190 -0
- package/dist/core-runtime/learning/usage-tracker.test.js +176 -0
- package/dist/core-runtime/llm/llm-caller.js +649 -0
- package/dist/core-runtime/llm/llm-tool-loop.js +401 -0
- package/dist/core-runtime/llm/model-switcher.js +62 -0
- package/dist/core-runtime/logger.js +22 -0
- package/dist/core-runtime/onboard/detect-review-axes.js +122 -0
- package/dist/core-runtime/onboard/detect-review-axes.test.js +127 -0
- package/dist/core-runtime/onboard/write-review-block.js +188 -0
- package/dist/core-runtime/onboard/write-review-block.test.js +240 -0
- package/dist/core-runtime/readers/brownfield-builder.js +150 -0
- package/dist/core-runtime/readers/brownfield-builder.test.js +136 -0
- package/dist/core-runtime/readers/code-chunk-collector.js +53 -0
- package/dist/core-runtime/readers/code-chunk-collector.test.js +136 -0
- package/dist/core-runtime/readers/file-utils.js +240 -0
- package/dist/core-runtime/readers/file-utils.test.js +146 -0
- package/dist/core-runtime/readers/lexicon-citation-check.js +93 -0
- package/dist/core-runtime/readers/lexicon-citation-check.test.js +77 -0
- package/dist/core-runtime/readers/mcp-figma.js +30 -0
- package/dist/core-runtime/readers/mcp-figma.test.js +82 -0
- package/dist/core-runtime/readers/mcp-generic.js +31 -0
- package/dist/core-runtime/readers/mcp-generic.test.js +76 -0
- package/dist/core-runtime/readers/ontology-index.js +148 -0
- package/dist/core-runtime/readers/ontology-index.test.js +245 -0
- package/dist/core-runtime/readers/ontology-query.js +168 -0
- package/dist/core-runtime/readers/ontology-query.test.js +311 -0
- package/dist/core-runtime/readers/ontology-resolve.js +48 -0
- package/dist/core-runtime/readers/ontology-resolve.test.js +48 -0
- package/dist/core-runtime/readers/patterns/index.js +7 -0
- package/dist/core-runtime/readers/review-log.js +213 -0
- package/dist/core-runtime/readers/review-log.test.js +313 -0
- package/dist/core-runtime/readers/scan-local.js +102 -0
- package/dist/core-runtime/readers/scan-local.test.js +102 -0
- package/dist/core-runtime/readers/scan-tarball.js +121 -0
- package/dist/core-runtime/readers/scan-tarball.test.js +283 -0
- package/dist/core-runtime/readers/scan-vault.js +34 -0
- package/dist/core-runtime/readers/scan-vault.test.js +81 -0
- package/dist/core-runtime/readers/types.js +42 -0
- package/dist/core-runtime/readers/types.test.js +94 -0
- package/dist/core-runtime/readers/viewpoint-collectors.js +229 -0
- package/dist/core-runtime/reconstruct/artifact-types.js +1 -0
- package/dist/core-runtime/reconstruct/directive-validation.js +123 -0
- package/dist/core-runtime/reconstruct/materialize-preparation.js +251 -0
- package/dist/core-runtime/reconstruct/record.js +198 -0
- package/dist/core-runtime/reconstruct/run.js +578 -0
- package/dist/core-runtime/reconstruct/seed-candidate-validation.js +356 -0
- package/dist/core-runtime/reconstruct/source-observations.js +62 -0
- package/dist/core-runtime/reconstruct/source-profiles.js +73 -0
- package/dist/core-runtime/release-channel/release-channel.js +90 -0
- package/dist/core-runtime/review/artifact-types.js +13 -0
- package/dist/core-runtime/review/citation-audit.js +204 -0
- package/dist/core-runtime/review/citation-audit.test.js +165 -0
- package/dist/core-runtime/review/controlled-lens-deliberation.js +125 -0
- package/dist/core-runtime/review/execution-plan-resolver.js +247 -0
- package/dist/core-runtime/review/execution-plan-resolver.test.js +243 -0
- package/dist/core-runtime/review/execution-topology-resolver-axis-first.test.js +246 -0
- package/dist/core-runtime/review/execution-topology-resolver.js +401 -0
- package/dist/core-runtime/review/execution-topology-resolver.test.js +315 -0
- package/dist/core-runtime/review/failure-records.js +57 -0
- package/dist/core-runtime/review/inline-context-embedder.js +141 -0
- package/dist/core-runtime/review/inline-context-embedder.test.js +154 -0
- package/dist/core-runtime/review/issue-artifact-runtime.js +859 -0
- package/dist/core-runtime/review/legacy-mode-policy.js +88 -0
- package/dist/core-runtime/review/lens-completion-policy.js +17 -0
- package/dist/core-runtime/review/materializers-effort-persist.test.js +79 -0
- package/dist/core-runtime/review/materializers.js +963 -0
- package/dist/core-runtime/review/ontology-path-classifier.js +179 -0
- package/dist/core-runtime/review/ontology-path-classifier.test.js +216 -0
- package/dist/core-runtime/review/packet-boundary-policy.js +215 -0
- package/dist/core-runtime/review/packet-boundary-policy.test.js +107 -0
- package/dist/core-runtime/review/participating-lens-paths.js +61 -0
- package/dist/core-runtime/review/participating-lens-paths.test.js +73 -0
- package/dist/core-runtime/review/review-artifact-utils.js +287 -0
- package/dist/core-runtime/review/review-config-legacy-translate.js +244 -0
- package/dist/core-runtime/review/review-config-legacy-translate.test.js +161 -0
- package/dist/core-runtime/review/review-config-validator.js +289 -0
- package/dist/core-runtime/review/review-config-validator.test.js +236 -0
- package/dist/core-runtime/review/review-execution-profile.js +193 -0
- package/dist/core-runtime/review/review-execution-route.js +52 -0
- package/dist/core-runtime/review/review-progress-contract.js +123 -0
- package/dist/core-runtime/review/review-record-validation.js +251 -0
- package/dist/core-runtime/review/review-result-classification.js +379 -0
- package/dist/core-runtime/review/review-state-machine.js +39 -0
- package/dist/core-runtime/review/route-visibility.js +125 -0
- package/dist/core-runtime/review/shape-pipeline-audit.test.js +311 -0
- package/dist/core-runtime/review/shape-to-topology-id.js +117 -0
- package/dist/core-runtime/review/shape-to-topology-id.test.js +132 -0
- package/dist/core-runtime/review/topology-shape-derivation.js +155 -0
- package/dist/core-runtime/review/topology-shape-derivation.test.js +195 -0
- package/dist/core-runtime/scope-runtime/constants.js +12 -0
- package/dist/core-runtime/scope-runtime/constraint-pool.js +166 -0
- package/dist/core-runtime/scope-runtime/constraint-pool.test.js +674 -0
- package/dist/core-runtime/scope-runtime/domain-validation-log.js +135 -0
- package/dist/core-runtime/scope-runtime/domain-validation-log.test.js +156 -0
- package/dist/core-runtime/scope-runtime/eval-persistence.js +65 -0
- package/dist/core-runtime/scope-runtime/eval-persistence.test.js +84 -0
- package/dist/core-runtime/scope-runtime/event-pipeline.js +64 -0
- package/dist/core-runtime/scope-runtime/event-pipeline.test.js +450 -0
- package/dist/core-runtime/scope-runtime/event-store.js +39 -0
- package/dist/core-runtime/scope-runtime/event-store.test.js +95 -0
- package/dist/core-runtime/scope-runtime/gate-guard.js +348 -0
- package/dist/core-runtime/scope-runtime/gate-guard.test.js +1047 -0
- package/dist/core-runtime/scope-runtime/hash.js +4 -0
- package/dist/core-runtime/scope-runtime/hash.test.js +33 -0
- package/dist/core-runtime/scope-runtime/id.js +4 -0
- package/dist/core-runtime/scope-runtime/id.test.js +17 -0
- package/dist/core-runtime/scope-runtime/reducer.js +297 -0
- package/dist/core-runtime/scope-runtime/reducer.test.js +759 -0
- package/dist/core-runtime/scope-runtime/scope-manager.js +161 -0
- package/dist/core-runtime/scope-runtime/state-machine.js +309 -0
- package/dist/core-runtime/scope-runtime/state-machine.test.js +704 -0
- package/dist/core-runtime/scope-runtime/types.js +116 -0
- package/dist/core-runtime/scope-runtime/types.test.js +69 -0
- package/dist/core-runtime/target-material-kind.js +256 -0
- package/dist/core-runtime/translate/render-for-user.js +169 -0
- package/dist/core-runtime/translate/render-for-user.test.js +122 -0
- package/dist/mcp/server.js +1011 -0
- package/dist/mcp/tool-schemas.js +93 -0
- package/dist/providers/capability-contract.js +1 -0
- package/package.json +68 -0
- package/settings.example.json +33 -0
|
@@ -0,0 +1,472 @@
|
|
|
1
|
+
---
|
|
2
|
+
version: 2
|
|
3
|
+
last_updated: "2026-04-16"
|
|
4
|
+
source: manual
|
|
5
|
+
status: established
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Visual Design Domain — Competency Questions
|
|
9
|
+
|
|
10
|
+
A list of core questions that this domain's system must be able to answer.
|
|
11
|
+
The pragmatics agent verifies the actual reasoning path for each question.
|
|
12
|
+
|
|
13
|
+
Classification axis: **Verification concern** — Classified by the concern that must be addressed during visual design system review. This axis aligns with domain_scope.md Key Sub-Areas + Cross-Cutting Concerns.
|
|
14
|
+
|
|
15
|
+
Question priority principles: **Visual system fundamentals (color system, typography, accessibility, token architecture) are the highest priority.** Consistency, brand governance, and motion refinement are secondary concerns applied on top of the visual foundation.
|
|
16
|
+
|
|
17
|
+
Priority levels:
|
|
18
|
+
- **P1** — Must be answerable in any visual design review. Failure indicates a fundamental visual system defect.
|
|
19
|
+
- **P2** — Should be answerable for production systems. Failure indicates a quality gap.
|
|
20
|
+
- **P3** — Recommended for mature systems. Failure indicates a refinement opportunity.
|
|
21
|
+
|
|
22
|
+
## CQ ID System
|
|
23
|
+
|
|
24
|
+
### Prefix Allocation
|
|
25
|
+
|
|
26
|
+
| Prefix | Concern Area | Aligned Sub-Area (domain_scope.md) |
|
|
27
|
+
|--------|-------------|-------------------------------------|
|
|
28
|
+
| CQ-VH | Visual Hierarchy and Composition | Cross-cutting: Typography + Color + Layout + Iconography |
|
|
29
|
+
| CQ-T | Typography | Typography |
|
|
30
|
+
| CQ-C | Color | Color |
|
|
31
|
+
| CQ-GL | Grid and Layout | Layout and Composition |
|
|
32
|
+
| CQ-II | Iconography and Imagery | Iconography and Imagery |
|
|
33
|
+
| CQ-DS | Design System | Design System |
|
|
34
|
+
| CQ-AC | Accessibility | Accessibility |
|
|
35
|
+
| CQ-BI | Brand Alignment | Brand Identity |
|
|
36
|
+
| CQ-MO | Motion and Animation | Motion and Animation |
|
|
37
|
+
| CQ-SOT | Source of Truth | Cross-cutting: Design System + Brand Identity |
|
|
38
|
+
| CQ-CO | Consistency | Cross-cutting: all sub-areas |
|
|
39
|
+
|
|
40
|
+
Prefix allocation protocol: New CQ sections use 1-3 character alphabetic prefix codes with mandatory `-` separator (e.g., CQ-XX-01). Prefixes must not be string prefixes of existing prefixes.
|
|
41
|
+
|
|
42
|
+
### ME Rationale
|
|
43
|
+
|
|
44
|
+
Each prefix covers a mutually exclusive concern area. CQ-VH = how information importance is conveyed visually (cross-cutting). CQ-T = how text is displayed. CQ-C = how colors are selected and combined. CQ-GL = how elements are spatially arranged. CQ-II = how icons and images communicate. CQ-DS = how tokens and components are governed. CQ-AC = how diverse abilities are served visually. CQ-BI = how brand identity is maintained. CQ-MO = how motion conveys information. CQ-SOT = which standards govern decisions. CQ-CO = whether visual patterns are uniformly applied.
|
|
45
|
+
|
|
46
|
+
When a concern touches multiple areas, attribution follows the **primary enforcement point** (domain_scope.md §Cross-cutting Concern Attribution). Contrast ratio → CQ-AC (WCAG is the enforcement driver), not CQ-C.
|
|
47
|
+
|
|
48
|
+
### CE Argument
|
|
49
|
+
|
|
50
|
+
The 11 prefixes cover all 8 sub-areas in domain_scope.md Key Sub-Areas plus 3 cross-cutting concerns (Visual Hierarchy, Source of Truth, Consistency). Visual Hierarchy is cross-cutting because it spans Typography, Color, Layout, and Iconography.
|
|
51
|
+
|
|
52
|
+
**Open-world note**: New sub-areas (e.g., 3D Design, Spatial UI) require new CQ prefixes.
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 1. Visual Hierarchy and Composition (CQ-VH)
|
|
57
|
+
|
|
58
|
+
Cross-cutting section — spans Typography, Color, Layout, and Iconography sub-areas. Verifies that information importance is clearly conveyed through visual means.
|
|
59
|
+
|
|
60
|
+
- **CQ-VH-01** [P1] Is the order of information importance clearly conveyed through visual means (size, color, contrast, position)?
|
|
61
|
+
- Inference path: logic_rules.md §Visual Hierarchy Logic → visual hierarchy through combination of means → concepts.md §Composition Principle Core Terms → Visual Hierarchy definition
|
|
62
|
+
- Verification criteria: PASS if a first-time viewer can identify the most important element within 3 seconds. FAIL if no clear visual priority — elements compete equally for attention
|
|
63
|
+
|
|
64
|
+
- **CQ-VH-02** [P1] Are at least 2 different visual means combined to establish each hierarchy level?
|
|
65
|
+
- Inference path: logic_rules.md §Visual Hierarchy Logic → single means = weak hierarchy → concepts.md §Visual Weight → size, saturation, contrast, complexity, isolation
|
|
66
|
+
- Verification criteria: PASS if each hierarchy level uses ≥2 combined means (e.g., larger + bolder, or brighter + positioned higher). FAIL if hierarchy relies on a single dimension (e.g., size alone)
|
|
67
|
+
|
|
68
|
+
- **CQ-VH-03** [P1] Are Gestalt principles (proximity, similarity, continuity, closure, figure-ground) consistently applied to group related elements?
|
|
69
|
+
- Inference path: concepts.md §Composition Principle Core Terms → Gestalt Principles → logic_rules.md §Grid and Spacing Logic → proximity principle enforcement
|
|
70
|
+
- Verification criteria: PASS if related elements are visually grouped and unrelated elements visually separated. FAIL if related elements have the same spacing as unrelated elements
|
|
71
|
+
|
|
72
|
+
- **CQ-VH-04** [P2] Is negative space intentionally designed, not incidentally left over?
|
|
73
|
+
- Inference path: concepts.md §Composition Principle Core Terms → Negative Space → active vs passive whitespace
|
|
74
|
+
- Verification criteria: PASS if whitespace serves clear purpose (breathing room, separation, emphasis). FAIL if whitespace distribution appears random or incidental
|
|
75
|
+
|
|
76
|
+
- **CQ-VH-05** [P2] Does the layout account for gaze movement patterns (F-pattern for text, Z-pattern for images)?
|
|
77
|
+
- Inference path: concepts.md §Composition Principle Core Terms → F-pattern/Z-pattern → logic_rules.md §Visual Hierarchy Logic → critical info along scan paths
|
|
78
|
+
- Verification criteria: PASS if most important content sits along natural scan path. FAIL if critical information is placed in areas users scan last
|
|
79
|
+
|
|
80
|
+
- **CQ-VH-06** [P2] Is the number of hierarchy levels within the perceivable range (3~5)?
|
|
81
|
+
- Inference path: logic_rules.md §Visual Hierarchy Logic → 3~5 levels perceivable → more levels make adjacent levels indistinguishable
|
|
82
|
+
- Verification criteria: PASS if hierarchy has 3~5 clearly distinguishable levels. FAIL if >5 levels that blur into each other or <3 levels (flat presentation)
|
|
83
|
+
|
|
84
|
+
- **CQ-VH-07** [P2] Do emphasized elements stay below ~30% of the viewport area?
|
|
85
|
+
- Inference path: logic_rules.md §Visual Hierarchy Logic → >30% emphasis = emphasis lost → emphasis works by contrast with non-emphasized
|
|
86
|
+
- Verification criteria: PASS if emphasis is selective and creates clear contrast. FAIL if most elements are visually "loud"
|
|
87
|
+
|
|
88
|
+
- **CQ-VH-08** [P3] Are CRAP principles (Contrast, Repetition, Alignment, Proximity) each explicitly applied?
|
|
89
|
+
- Inference path: concepts.md §Composition Principle Core Terms → CRAP Principles → Robin Williams (1994)
|
|
90
|
+
- Verification criteria: PASS if all 4 principles identifiable in the layout. FAIL if any principle is not addressed
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 2. Typography (CQ-T)
|
|
95
|
+
|
|
96
|
+
Verifies that the typography system supports readability, hierarchy, and visual rhythm.
|
|
97
|
+
|
|
98
|
+
- **CQ-T-01** [P1] Is the rationale for typeface selection documented (medium, content type, target users, licensing, language support)?
|
|
99
|
+
- Inference path: logic_rules.md §Typography Logic → typeface selection is functional, not sensory → concepts.md §Typography Core Terms → Typeface
|
|
100
|
+
- Verification criteria: PASS if selection rationale documented with constraints. FAIL if choice is undocumented or justified only by "it looks nice"
|
|
101
|
+
|
|
102
|
+
- **CQ-T-02** [P1] Is the type scale defined on a consistent ratio basis with named hierarchy levels?
|
|
103
|
+
- Inference path: logic_rules.md §Typography Logic → consistent ratio prevents arbitrary sizes → structure_spec.md §Token Layer Structure → type tokens → concepts.md §Typography Core Terms → Type Scale
|
|
104
|
+
- Verification criteria: PASS if ratio documented (e.g., 1.25), levels named (h1/h2/h3/body/caption), and all sizes derivable from ratio. FAIL if sizes are arbitrary
|
|
105
|
+
|
|
106
|
+
- **CQ-T-03** [P1] Do line-height values meet readability criteria (body 1.4~1.6×, heading 1.1~1.3×)?
|
|
107
|
+
- Inference path: logic_rules.md §Typography Logic → insufficient = collision, excessive = broken cohesion → concepts.md §Typography Core Terms → Line-height
|
|
108
|
+
- Verification criteria: PASS if body line-height 1.4~1.6× and heading 1.1~1.3×. FAIL if values outside range without documented justification
|
|
109
|
+
|
|
110
|
+
- **CQ-T-04** [P1] Is the measure within optimal readability range (45~75 chars English, 25~35 chars CJK)?
|
|
111
|
+
- Inference path: logic_rules.md §Typography Logic → long = hard to find next line, short = excessive breaks → dependency_rules.md §Typography–Layout Dependency → Measure → Grid Column Width
|
|
112
|
+
- Verification criteria: PASS if text blocks at each breakpoint fall within range. FAIL if any text block consistently exceeds/falls below range
|
|
113
|
+
|
|
114
|
+
- **CQ-T-05** [P2] Is the number of typefaces limited to 2~3?
|
|
115
|
+
- Inference path: logic_rules.md §Typography Logic → >3 causes visual clutter and consistency burden
|
|
116
|
+
- Verification criteria: PASS if 2~3 typefaces with clear role assignment. FAIL if >3 typefaces or roles overlap
|
|
117
|
+
|
|
118
|
+
- **CQ-T-06** [P2] Does typeface pairing follow the contrast principle (e.g., sans-serif + serif)?
|
|
119
|
+
- Inference path: logic_rules.md §Typography Logic → similar typefaces = awkward similarity → clear contrast needed
|
|
120
|
+
- Verification criteria: PASS if paired typefaces have clear visual contrast. FAIL if two similar typefaces (e.g., two geometric sans-serifs)
|
|
121
|
+
|
|
122
|
+
- **CQ-T-07** [P2] Are minimum text sizes enforced per context (body ≥16px, caption ≥12px)?
|
|
123
|
+
- Inference path: logic_rules.md §Typography Logic → below 12px, legibility degrades significantly
|
|
124
|
+
- Verification criteria: PASS if no text below 12px and body text ≥16px on screen. FAIL if text below minimum thresholds
|
|
125
|
+
|
|
126
|
+
- **CQ-T-08** [P2] Are letter-spacing adjustments defined per text role?
|
|
127
|
+
- Inference path: concepts.md §Typography Core Terms → Letter-spacing → logic_rules.md §Typography Logic → headings tighter, uppercase/small text wider
|
|
128
|
+
- Verification criteria: PASS if tracking varies appropriately by role. FAIL if uniform tracking everywhere including uppercase/small text
|
|
129
|
+
|
|
130
|
+
- **CQ-T-09** [P2] Is text alignment method chosen with rationale (left for body, center for short headings)?
|
|
131
|
+
- Inference path: logic_rules.md §Typography Logic → full justification on narrow columns causes river effect
|
|
132
|
+
- Verification criteria: PASS if alignment appropriate to context with documented rationale. FAIL if full justification on narrow columns
|
|
133
|
+
|
|
134
|
+
- **CQ-T-10** [P3] Is typeface fallback defined for multilingual environments? (when applicable)
|
|
135
|
+
- Inference path: concepts.md §Typography Core Terms → fallback stacks → dependency_rules.md §Typography–Layout Dependency → typeface change requires full re-verification
|
|
136
|
+
- Verification criteria: PASS if fallback chain defined with CJK/script-specific faces. FAIL if no fallback beyond generic family
|
|
137
|
+
|
|
138
|
+
- **CQ-T-11** [P3] Are variable font axes utilized when variable fonts are available? (when applicable)
|
|
139
|
+
- Inference path: concepts.md §Typography Core Terms → Variable Font → axes (wght, wdth, opsz) → optical sizing for small text
|
|
140
|
+
- Verification criteria: PASS if variable axes used for responsive type or optical sizing. FAIL if variable font loaded but only one static instance used
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 3. Color (CQ-C)
|
|
145
|
+
|
|
146
|
+
Verifies that the color system supports harmony, hierarchy, meaning, and accessibility.
|
|
147
|
+
|
|
148
|
+
- **CQ-C-01** [P1] Is a color palette defined with primary/secondary/accent/neutral roles distinguished?
|
|
149
|
+
- Inference path: structure_spec.md §Visual Design System Required Elements → Color System → logic_rules.md §Color Logic → basic composition
|
|
150
|
+
- Verification criteria: PASS if palette has named roles with clear usage rules. FAIL if colors selected ad-hoc without role system
|
|
151
|
+
|
|
152
|
+
- **CQ-C-02** [P1] Are semantic colors (success, error, warning, info) defined and separated from raw values?
|
|
153
|
+
- Inference path: concepts.md §Color Core Terms → Semantic Color → structure_spec.md §Token Layer Structure → semantic layer references primitive
|
|
154
|
+
- Verification criteria: PASS if semantic colors reference primitive tokens, not hardcoded values. FAIL if `error: #EF4444` instead of `error: red-500`
|
|
155
|
+
|
|
156
|
+
- **CQ-C-03** [P1] Do all text-background combinations meet WCAG AA contrast (4.5:1 normal, 3:1 large)?
|
|
157
|
+
- Inference path: logic_rules.md §Accessibility Logic → WCAG criteria → dependency_rules.md §Color–Accessibility Dependency → all combinations verified
|
|
158
|
+
- Verification criteria: PASS if all combinations documented with computed ratio. FAIL if any combination below threshold or unverified
|
|
159
|
+
<!-- derived-from: WCAG 2.2, SC 1.4.3 -->
|
|
160
|
+
|
|
161
|
+
- **CQ-C-04** [P1] Are supplementary means (icons, text, shape) provided alongside color for conveying meaning?
|
|
162
|
+
- Inference path: logic_rules.md §Accessibility Logic → color alone = WCAG 1.4.1 violation → dependency_rules.md §Color–Accessibility Dependency → Semantic Color → Supplementary Means
|
|
163
|
+
- Verification criteria: PASS if every color-based meaning has ≥1 non-color supplement. FAIL if any meaning conveyed by color alone
|
|
164
|
+
<!-- derived-from: WCAG 2.2, SC 1.4.1 -->
|
|
165
|
+
|
|
166
|
+
- **CQ-C-05** [P2] Does the color ratio approximate 60-30-10 (dominant/secondary/accent)?
|
|
167
|
+
- Inference path: logic_rules.md §Color Logic → accent 10% concentrated on action guidance → concepts.md §Color Core Terms → 60-30-10 Rule
|
|
168
|
+
- Verification criteria: PASS if dominant/secondary/accent proportions identifiable. FAIL if accent distributed widely or no clear proportion
|
|
169
|
+
|
|
170
|
+
- **CQ-C-06** [P2] Are high-saturation colors restricted to small areas (accents) with low saturation for large surfaces?
|
|
171
|
+
- Inference path: logic_rules.md §Color Logic → high saturation on large areas = eye fatigue
|
|
172
|
+
- Verification criteria: PASS if backgrounds use desaturated colors and only accents use high saturation. FAIL if large areas use high-saturation colors
|
|
173
|
+
|
|
174
|
+
- **CQ-C-07** [P2] Is color harmony based on identifiable color wheel relationships?
|
|
175
|
+
- Inference path: logic_rules.md §Color Logic → harmony from identifiable relationships → concepts.md §Color Core Terms → Color Wheel
|
|
176
|
+
- Verification criteria: PASS if palette colors have an identifiable relationship (complementary, analogous, triadic). FAIL if colors appear arbitrarily selected
|
|
177
|
+
|
|
178
|
+
- **CQ-C-08** [P2] Do UI components and graphical objects meet 3:1 contrast against adjacent colors?
|
|
179
|
+
- Inference path: logic_rules.md §Accessibility Logic → WCAG 1.4.11 → icons, borders, focus rings, form controls
|
|
180
|
+
- Verification criteria: PASS if all non-text UI elements meet 3:1. FAIL if icon/border on similar-tone background fails ratio
|
|
181
|
+
<!-- derived-from: WCAG 2.2, SC 1.4.11 -->
|
|
182
|
+
|
|
183
|
+
- **CQ-C-09** [P2] Is the palette tested against protanopia, deuteranopia, and tritanopia simulations?
|
|
184
|
+
- Inference path: logic_rules.md §Accessibility Logic → color blindness simulation required for semantic colors
|
|
185
|
+
- Verification criteria: PASS if simulations run and semantic colors remain distinguishable. FAIL if error/success indistinguishable under simulation
|
|
186
|
+
|
|
187
|
+
- **CQ-C-10** [P2] If dark mode exists, is it designed with separate semantic token mappings (not color inversion)?
|
|
188
|
+
- Inference path: dependency_rules.md §Color–Accessibility Dependency → Dark Mode Addition → logic_rules.md §Color Logic → dark mode ≠ inversion
|
|
189
|
+
- Verification criteria: PASS if dark mode has separate primitives, re-verified contrast, elevation model adapted. FAIL if colors are auto-inverted
|
|
190
|
+
|
|
191
|
+
- **CQ-C-11** [P3] Are colors specified in a defined color space (sRGB, Display P3)?
|
|
192
|
+
- Inference path: concepts.md §Color Core Terms → Color Space → cross-device consistency
|
|
193
|
+
- Verification criteria: PASS if color space documented and conversions defined. FAIL if hex-only with no space specification
|
|
194
|
+
|
|
195
|
+
- **CQ-C-12** [P3] Are tonal palettes perceptually even (using OKLCH or CIE LAB, not just sRGB math)?
|
|
196
|
+
- Inference path: logic_rules.md §Color Logic → perceptually even > mathematically even → concepts.md §Accessibility Core Terms → Perceptual Uniformity
|
|
197
|
+
- Verification criteria: PASS if lightness steps appear visually even. FAIL if palette has visible jumps or plateaus
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 4. Grid and Layout (CQ-GL)
|
|
202
|
+
|
|
203
|
+
Verifies that spatial organization supports alignment, rhythm, and responsive adaptation.
|
|
204
|
+
|
|
205
|
+
- **CQ-GL-01** [P1] Is a grid system (columns, gutters, margins) defined and consistently applied?
|
|
206
|
+
- Inference path: structure_spec.md §Visual Design System Required Elements → Layout System → concepts.md §Layout Core Terms → Grid System
|
|
207
|
+
- Verification criteria: PASS if grid documented with column count, gutter width, margin width per breakpoint. FAIL if no grid or elements placed arbitrarily
|
|
208
|
+
|
|
209
|
+
- **CQ-GL-02** [P1] Is a spacing system defined based on a consistent base unit (4px or 8px)?
|
|
210
|
+
- Inference path: logic_rules.md §Grid and Spacing Logic → consistent base unit required → structure_spec.md §Visual Design System Required Elements → Spacing System
|
|
211
|
+
- Verification criteria: PASS if base unit documented and all spacing values are multiples. FAIL if arbitrary spacing values used
|
|
212
|
+
|
|
213
|
+
- **CQ-GL-03** [P1] Are responsive breakpoints defined based on content (where layout breaks), not devices?
|
|
214
|
+
- Inference path: structure_spec.md §Responsive Structure → concepts.md §Layout Core Terms → Breakpoint → content-driven
|
|
215
|
+
- Verification criteria: PASS if breakpoints set where content needs to reflow. FAIL if breakpoints match only specific device widths
|
|
216
|
+
|
|
217
|
+
- **CQ-GL-04** [P2] Is gutter width less than margin width?
|
|
218
|
+
- Inference path: logic_rules.md §Grid and Spacing Logic → gutter > margin inverts visual structure
|
|
219
|
+
- Verification criteria: PASS if gutter < margin at every breakpoint. FAIL if gutter ≥ margin
|
|
220
|
+
|
|
221
|
+
- **CQ-GL-05** [P2] Are spacing values restricted to the defined spatial system (no off-scale values)?
|
|
222
|
+
- Inference path: logic_rules.md §Grid and Spacing Logic → arbitrary values destroy visual rhythm → structure_spec.md §Isolated Node Prohibition → off-scale spacing
|
|
223
|
+
- Verification criteria: PASS if all spacing values in the system. FAIL if values outside the scale (e.g., 15px, 23px)
|
|
224
|
+
|
|
225
|
+
- **CQ-GL-06** [P2] Is the Gestalt proximity principle applied — related elements closer than unrelated?
|
|
226
|
+
- Inference path: logic_rules.md §Grid and Spacing Logic → inter-group ≥ 2× intra-group recommended
|
|
227
|
+
- Verification criteria: PASS if spacing ratios clearly distinguish groups. FAIL if related and unrelated elements have similar spacing
|
|
228
|
+
|
|
229
|
+
- **CQ-GL-07** [P2] Does content reflow properly at 200% text enlargement without clipping?
|
|
230
|
+
- Inference path: structure_spec.md §Responsive Structure → WCAG 1.4.10 → no horizontal scrolling for vertical text
|
|
231
|
+
- Verification criteria: PASS if content reflows with no horizontal scroll at 200%. FAIL if content clipped or horizontal scrollbar appears
|
|
232
|
+
<!-- derived-from: WCAG 2.2, SC 1.4.10 -->
|
|
233
|
+
|
|
234
|
+
- **CQ-GL-08** [P2] Are max-width constraints defined to prevent content from stretching beyond readable measure?
|
|
235
|
+
- Inference path: logic_rules.md §Grid and Spacing Logic → max-width prevents 200+ char lines on wide screens
|
|
236
|
+
- Verification criteria: PASS if content area has max-width (1200~1440px) and text blocks have max-width (680~720px). FAIL if text stretches full-width on wide monitors
|
|
237
|
+
|
|
238
|
+
- **CQ-GL-09** [P3] Is a baseline grid defined to maintain vertical rhythm?
|
|
239
|
+
- Inference path: concepts.md §Layout Core Terms → Baseline Grid → all vertical spacing aligns to multiples of body line-height
|
|
240
|
+
- Verification criteria: PASS if vertical spacing aligns to baseline. FAIL if no baseline grid defined
|
|
241
|
+
|
|
242
|
+
---
|
|
243
|
+
|
|
244
|
+
## 5. Iconography and Imagery (CQ-II)
|
|
245
|
+
|
|
246
|
+
Verifies that icons and images communicate clearly, consistently, and accessibly.
|
|
247
|
+
|
|
248
|
+
- **CQ-II-01** [P1] Is the icon style (outline/filled/duotone) unified across the system?
|
|
249
|
+
- Inference path: logic_rules.md §Icon and Image Logic → mixing styles = visual noise → structure_spec.md §Visual Design System Required Elements → Icon System
|
|
250
|
+
- Verification criteria: PASS if one consistent style throughout. FAIL if styles mixed without documented semantic distinction
|
|
251
|
+
|
|
252
|
+
- **CQ-II-02** [P1] Are icon meanings used consistently (same icon = same meaning everywhere)?
|
|
253
|
+
- Inference path: logic_rules.md §Icon and Image Logic → meaning mapping is permanent → structure_spec.md §Isolated Node Prohibition → icon meaning collision
|
|
254
|
+
- Verification criteria: PASS if each icon maps to exactly one meaning. FAIL if same icon means different things on different screens
|
|
255
|
+
|
|
256
|
+
- **CQ-II-03** [P1] Are icons accompanied by text labels so meaning is not conveyed by icon alone?
|
|
257
|
+
- Inference path: logic_rules.md §Accessibility Logic → icons must not be sole information carrier → WCAG 1.4.1 principle extended
|
|
258
|
+
- Verification criteria: PASS if every icon has text label, tooltip, or aria-label. FAIL if icon-only navigation or action without any text
|
|
259
|
+
|
|
260
|
+
- **CQ-II-04** [P2] Is an icon size system defined (e.g., 16/20/24/32px) with usage context per size?
|
|
261
|
+
- Inference path: logic_rules.md §Icon and Image Logic → defined scale with usage context → structure_spec.md §Visual Design System Required Elements
|
|
262
|
+
- Verification criteria: PASS if sizes defined with context (16px=inline, 24px=button). FAIL if arbitrary icon sizes used
|
|
263
|
+
|
|
264
|
+
- **CQ-II-05** [P2] Do icons meet 3:1 contrast against their background (WCAG 1.4.11)?
|
|
265
|
+
- Inference path: logic_rules.md §Accessibility Logic → UI components 3:1 → applies to icons
|
|
266
|
+
- Verification criteria: PASS if all icons meet 3:1 contrast. FAIL if icons on similar-tone backgrounds fail
|
|
267
|
+
<!-- derived-from: WCAG 2.2, SC 1.4.11 -->
|
|
268
|
+
|
|
269
|
+
- **CQ-II-06** [P2] Are icons designed on a consistent grid (keyline grid with uniform stroke and padding)?
|
|
270
|
+
- Inference path: logic_rules.md §Icon and Image Logic → grid-based design → optical alignment may adjust 1~2px
|
|
271
|
+
- Verification criteria: PASS if grid documented and icons follow it. FAIL if icons appear visually inconsistent in size/weight
|
|
272
|
+
|
|
273
|
+
- **CQ-II-07** [P3] Are image aspect ratios consistent within the same context?
|
|
274
|
+
- Inference path: logic_rules.md §Icon and Image Logic → mixed ratios in same context = chaotic
|
|
275
|
+
- Verification criteria: PASS if one ratio per context (e.g., all product cards 4:3). FAIL if mixed ratios in a grid
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## 6. Design System (CQ-DS)
|
|
280
|
+
|
|
281
|
+
Verifies that tokens and components are structured, governed, and consistently applied.
|
|
282
|
+
|
|
283
|
+
- **CQ-DS-01** [P1] Are design tokens defined with primitive/semantic/component layers distinguished?
|
|
284
|
+
- Inference path: structure_spec.md §Token Layer Structure → 3 layers, unidirectional reference → concepts.md §Design System Core Terms → Design Token
|
|
285
|
+
- Verification criteria: PASS if 3 layers exist with clear naming convention. FAIL if flat token structure or missing semantic layer
|
|
286
|
+
|
|
287
|
+
- **CQ-DS-02** [P1] Do component tokens reference semantic tokens (not primitives directly)?
|
|
288
|
+
- Inference path: dependency_rules.md §Token–Component Dependency → primitive bypass = meaning layer violation → structure_spec.md §Isolated Node Prohibition → layer bypass
|
|
289
|
+
- Verification criteria: PASS if all component tokens trace to semantic tokens. FAIL if any component token references a primitive directly
|
|
290
|
+
|
|
291
|
+
- **CQ-DS-03** [P1] Are visual specifications defined per interactive state (default/hover/active/focus/disabled)?
|
|
292
|
+
- Inference path: structure_spec.md §State System → 5 minimum states → dependency_rules.md §Component–State Dependency → all states required
|
|
293
|
+
- Verification criteria: PASS if ≥5 states visually specified per interactive component. FAIL if any interactive component has <5 states
|
|
294
|
+
|
|
295
|
+
- **CQ-DS-04** [P2] Are component variants defined with usage criteria?
|
|
296
|
+
- Inference path: structure_spec.md §Visual Design System Required Elements → Variant Definitions → logic_rules.md §Component Logic → manageable range
|
|
297
|
+
- Verification criteria: PASS if variants documented with when-to-use criteria. FAIL if variants exist without selection guidance
|
|
298
|
+
|
|
299
|
+
- **CQ-DS-05** [P2] Is a Figma↔code synchronization method defined with frequency and tolerance?
|
|
300
|
+
- Inference path: dependency_rules.md §Design Tool–Code Dependency → bidirectional sync → frequency and acceptable discrepancy documented
|
|
301
|
+
- Verification criteria: PASS if sync frequency, token pipeline, and acceptable discrepancy defined. FAIL if no sync process
|
|
302
|
+
|
|
303
|
+
- **CQ-DS-06** [P2] Are token naming conventions consistent (e.g., `{category}-{property}-{variant}-{state}`)?
|
|
304
|
+
- Inference path: structure_spec.md §Token Layer Structure → naming convention per layer
|
|
305
|
+
- Verification criteria: PASS if naming follows documented pattern consistently. FAIL if naming is inconsistent or undocumented
|
|
306
|
+
|
|
307
|
+
- **CQ-DS-07** [P2] Is design system governance defined (add/change/deprecation)? (scale-dependent: 2+ teams)
|
|
308
|
+
- Inference path: domain_scope.md §Key Sub-Areas → Governance (scale-dependent) → concepts.md §Design System Core Terms → Governance
|
|
309
|
+
- Verification criteria: PASS if process documented and enforced. FAIL if no process or ad-hoc additions without review
|
|
310
|
+
|
|
311
|
+
- **CQ-DS-08** [P3] Are tokens managed in a tool-independent format (JSON/YAML)?
|
|
312
|
+
- Inference path: extension_cases.md §Case 7 → tool migration → tokens in tool-agnostic format
|
|
313
|
+
- Verification criteria: PASS if tokens in JSON/YAML with build pipeline. FAIL if tokens only in Figma with no export
|
|
314
|
+
|
|
315
|
+
- **CQ-DS-09** [P3] Is the design system maturity level identified and appropriate?
|
|
316
|
+
- Inference path: concepts.md §Design System Core Terms → Design System Maturity → L1 style guide → L4 infrastructure
|
|
317
|
+
- Verification criteria: PASS if maturity level identified and roadmap exists. FAIL if maturity not assessed
|
|
318
|
+
|
|
319
|
+
---
|
|
320
|
+
|
|
321
|
+
## 7. Accessibility (CQ-AC)
|
|
322
|
+
|
|
323
|
+
Verifies that the visual system serves users of diverse visual abilities.
|
|
324
|
+
|
|
325
|
+
- **CQ-AC-01** [P1] Is WCAG 2.2 AA explicitly stated as the applicable standard?
|
|
326
|
+
- Inference path: domain_scope.md §Reference Standards/Frameworks → WCAG version SSOT → domain_scope.md §Normative System Classification → Tier-1a
|
|
327
|
+
- Verification criteria: PASS if standard version explicitly stated. FAIL if "WCAG" without version or no standard stated
|
|
328
|
+
|
|
329
|
+
- **CQ-AC-02** [P1] Does the focus indicator provide sufficient visibility (≥2px, ≥3:1 contrast)?
|
|
330
|
+
- Inference path: logic_rules.md §Accessibility Logic → focus indicator requirements → structure_spec.md §State System → Focus state
|
|
331
|
+
- Verification criteria: PASS if focus indicator ≥2px solid with ≥3:1 contrast on all backgrounds. FAIL if outline:none without alternative or insufficient contrast
|
|
332
|
+
<!-- derived-from: WCAG 2.2, SC 2.4.7, 2.4.11 -->
|
|
333
|
+
|
|
334
|
+
- **CQ-AC-03** [P1] Is prefers-reduced-motion supported for all non-essential motion?
|
|
335
|
+
- Inference path: logic_rules.md §Motion Logic → replace with instant transition, not remove → concepts.md §Accessibility Core Terms → prefers-reduced-motion
|
|
336
|
+
- Verification criteria: PASS if all non-essential motion has reduced-motion alternative. FAIL if animations play regardless of system setting
|
|
337
|
+
|
|
338
|
+
- **CQ-AC-04** [P1] Is there no content that flashes more than 3 times per second?
|
|
339
|
+
- Inference path: logic_rules.md §Motion Logic → WCAG 2.3.1 absolute prohibition → seizure risk
|
|
340
|
+
- Verification criteria: PASS if no flashing content. FAIL if any element flashes >3/sec (GIFs, loaders, video)
|
|
341
|
+
<!-- derived-from: WCAG 2.2, SC 2.3.1 -->
|
|
342
|
+
|
|
343
|
+
- **CQ-AC-05** [P2] Is content readable and functional at 200% text enlargement?
|
|
344
|
+
- Inference path: structure_spec.md §Responsive Structure → WCAG 1.4.4 → no clipping, no horizontal scroll
|
|
345
|
+
- Verification criteria: PASS if content reflows and remains functional at 200%. FAIL if text clipped or functionality lost
|
|
346
|
+
<!-- derived-from: WCAG 2.2, SC 1.4.4 -->
|
|
347
|
+
|
|
348
|
+
- **CQ-AC-06** [P2] Do all non-text UI elements meet 3:1 contrast (WCAG 1.4.11)?
|
|
349
|
+
- Inference path: logic_rules.md §Accessibility Logic → icons, borders, focus rings, form controls → 3:1 minimum
|
|
350
|
+
- Verification criteria: PASS if all UI elements meet 3:1. FAIL if any element below threshold
|
|
351
|
+
|
|
352
|
+
- **CQ-AC-07** [P2] Is color blindness accommodation verified via simulation?
|
|
353
|
+
- Inference path: logic_rules.md §Accessibility Logic → protanopia, deuteranopia, tritanopia simulations
|
|
354
|
+
- Verification criteria: PASS if all semantic colors distinguishable under all 3 simulations. FAIL if any pair indistinguishable
|
|
355
|
+
|
|
356
|
+
- **CQ-AC-08** [P3] When reduced motion is active, are state changes still communicated (instant transition, not removal)?
|
|
357
|
+
- Inference path: logic_rules.md §Motion Logic → instant transition replaces animation → state change must still be visible
|
|
358
|
+
- Verification criteria: PASS if state changes visible without motion. FAIL if reduced-motion removes all visual feedback
|
|
359
|
+
|
|
360
|
+
---
|
|
361
|
+
|
|
362
|
+
## 8. Brand Alignment (CQ-BI)
|
|
363
|
+
|
|
364
|
+
Verifies that visual elements maintain brand identity consistently.
|
|
365
|
+
|
|
366
|
+
- **CQ-BI-01** [P1] Are visual elements (colors, typefaces, image style) consistent with the brand tone and manner?
|
|
367
|
+
- Inference path: logic_rules.md §Brand Alignment Logic → tone constrains visual choices → dependency_rules.md §Brand–Visual System Dependency
|
|
368
|
+
- Verification criteria: PASS if visual choices align with documented tone. FAIL if visual elements contradict the stated brand personality
|
|
369
|
+
|
|
370
|
+
- **CQ-BI-02** [P1] Are logo usage rules (minimum size, clear space, prohibited modifications) defined and followed?
|
|
371
|
+
- Inference path: concepts.md §Brand Identity Core Terms → Logo, Clear Space → logic_rules.md §Brand Alignment Logic → clear space never violated
|
|
372
|
+
- Verification criteria: PASS if logo rules documented and consistently followed. FAIL if logo encroached, distorted, or below minimum size
|
|
373
|
+
|
|
374
|
+
- **CQ-BI-03** [P2] Are brand colors applied through the design token system (not hardcoded)?
|
|
375
|
+
- Inference path: logic_rules.md §Brand Alignment Logic → brand through token system → dependency_rules.md §Brand–Visual System Dependency
|
|
376
|
+
- Verification criteria: PASS if brand colors are tokens that propagate through the system. FAIL if brand colors hardcoded in individual components
|
|
377
|
+
|
|
378
|
+
- **CQ-BI-04** [P2] When brand colors conflict with accessibility, is accessibility prioritized with adjustment documented?
|
|
379
|
+
- Inference path: logic_rules.md §Constraint Conflict Checks → Accessibility vs Brand Identity → accessibility prevails
|
|
380
|
+
- Verification criteria: PASS if accessibility met with documented brand adjustment. FAIL if contrast sacrificed for brand
|
|
381
|
+
|
|
382
|
+
- **CQ-BI-05** [P3] Are brand application rules defined per medium (digital/print/environmental)? (when applicable)
|
|
383
|
+
- Inference path: domain_scope.md §Key Sub-Areas → Brand Identity → Medium-Specific Application
|
|
384
|
+
- Verification criteria: PASS if per-medium rules exist. FAIL if single set of rules applied across all media
|
|
385
|
+
|
|
386
|
+
- **CQ-BI-06** [P3] Is co-branding visual hierarchy defined? (when applicable)
|
|
387
|
+
- Inference path: concepts.md §Brand Identity Core Terms → Co-branding → logic_rules.md §Brand Alignment Logic
|
|
388
|
+
- Verification criteria: PASS if relative size, placement, clear space rules defined. FAIL if co-branding ad-hoc
|
|
389
|
+
|
|
390
|
+
---
|
|
391
|
+
|
|
392
|
+
## 9. Motion and Animation (CQ-MO)
|
|
393
|
+
|
|
394
|
+
Verifies that motion conveys information, respects accessibility, and follows a consistent system.
|
|
395
|
+
|
|
396
|
+
- **CQ-MO-01** [P2] Is the purpose of each animation (feedback/transition/guidance) stated?
|
|
397
|
+
- Inference path: logic_rules.md §Motion Logic → motion is information, not decoration → concepts.md §Motion Core Terms
|
|
398
|
+
- Verification criteria: PASS if each animation has stated purpose. FAIL if any animation exists without information purpose
|
|
399
|
+
|
|
400
|
+
- **CQ-MO-02** [P2] Is an easing curve system defined (ease-out for entrance, ease-in for exit)?
|
|
401
|
+
- Inference path: logic_rules.md §Motion Logic → standard easing assignments → concepts.md §Motion Core Terms → Easing
|
|
402
|
+
- Verification criteria: PASS if easing assignments documented per motion type. FAIL if easing is arbitrary or uniform linear
|
|
403
|
+
|
|
404
|
+
- **CQ-MO-03** [P2] Is a duration system defined with ranges by complexity (100~200ms micro, 200~400ms transitions)?
|
|
405
|
+
- Inference path: logic_rules.md §Motion Logic → duration proportional to complexity → concepts.md §Motion Core Terms → Duration
|
|
406
|
+
- Verification criteria: PASS if duration ranges defined and applied. FAIL if durations are arbitrary or >700ms for UI
|
|
407
|
+
|
|
408
|
+
- **CQ-MO-04** [P2] Are simultaneous animations limited to 2?
|
|
409
|
+
- Inference path: logic_rules.md §Motion Logic → >2 simultaneous = cognitive overload → stagger 30~50ms
|
|
410
|
+
- Verification criteria: PASS if ≤2 simultaneous animations. FAIL if >2 simultaneous without stagger
|
|
411
|
+
|
|
412
|
+
- **CQ-MO-05** [P3] Are motion semantics consistent (expansion = reveal, slide-in = new context)?
|
|
413
|
+
- Inference path: concepts.md §Motion Core Terms → Motion Semantics → logic_rules.md §Motion Logic → consistent semantics
|
|
414
|
+
- Verification criteria: PASS if same motion type conveys same meaning throughout. FAIL if expansion means "reveal" on one screen and "error" on another
|
|
415
|
+
|
|
416
|
+
---
|
|
417
|
+
|
|
418
|
+
## 10. Source of Truth (CQ-SOT)
|
|
419
|
+
|
|
420
|
+
Cross-cutting section. Verifies that authoritative standards for visual decisions are designated and followed.
|
|
421
|
+
|
|
422
|
+
- **CQ-SOT-01** [P1] Is an authoritative standard for visual design decisions designated?
|
|
423
|
+
- Inference path: dependency_rules.md §Source of Truth Management → design system documentation = SoT → not Figma, not code
|
|
424
|
+
- Verification criteria: PASS if SoT explicitly designated. FAIL if no designated authority or ambiguous authority
|
|
425
|
+
|
|
426
|
+
- **CQ-SOT-02** [P1] Is the conflict resolution priority defined (Accessibility > Platform > Design System > Heuristics)?
|
|
427
|
+
- Inference path: dependency_rules.md §Source of Truth Management → Conflict Resolution Priority → domain_scope.md §Normative System Classification
|
|
428
|
+
- Verification criteria: PASS if priority documented and consistently applied. FAIL if conflicts resolved ad-hoc
|
|
429
|
+
|
|
430
|
+
- **CQ-SOT-03** [P2] Is design tool vs code precedence defined for discrepancy resolution?
|
|
431
|
+
- Inference path: dependency_rules.md §Design Tool–Code Dependency → Discrepancy Resolution → documentation is SoT
|
|
432
|
+
- Verification criteria: PASS if resolution process documented. FAIL if discrepancies left unresolved or resolved inconsistently
|
|
433
|
+
|
|
434
|
+
- **CQ-SOT-04** [P2] Are external standard versions explicitly specified (e.g., "WCAG 2.2" not "WCAG")?
|
|
435
|
+
- Inference path: domain_scope.md §Reference Standards/Frameworks → version SSOT table
|
|
436
|
+
- Verification criteria: PASS if all external standards include version. FAIL if version omitted
|
|
437
|
+
|
|
438
|
+
---
|
|
439
|
+
|
|
440
|
+
## 11. Consistency (CQ-CO)
|
|
441
|
+
|
|
442
|
+
Cross-cutting section — spans all sub-areas. Verifies that visual patterns are uniformly applied.
|
|
443
|
+
|
|
444
|
+
- **CQ-CO-01** [P1] Is the same visual expression applied for the same meaning across the product?
|
|
445
|
+
- Inference path: domain_scope.md §Cross-Cutting Concerns → Visual Consistency → logic_rules.md §Constraint Conflict Checks → same function = same expression
|
|
446
|
+
- Verification criteria: PASS if visual patterns are uniform for identical concepts. FAIL if same concept has different visual treatment on different screens
|
|
447
|
+
|
|
448
|
+
- **CQ-CO-02** [P1] Are all token values used consistently — no hardcoded values bypassing the token system?
|
|
449
|
+
- Inference path: structure_spec.md §Isolated Node Prohibition → hardcoded values bypass tokens → dependency_rules.md §Token–Component Dependency
|
|
450
|
+
- Verification criteria: PASS if all visual properties reference tokens. FAIL if hardcoded values found in component specs
|
|
451
|
+
|
|
452
|
+
- **CQ-CO-03** [P2] Are intentional visual deviations documented with rationale?
|
|
453
|
+
- Inference path: logic_rules.md §Constraint Conflict Checks → Consistency vs Contextual Appropriateness → deviation must be documented
|
|
454
|
+
- Verification criteria: PASS if every deviation has documented reason. FAIL if deviations exist without rationale
|
|
455
|
+
|
|
456
|
+
- **CQ-CO-04** [P2] Is the design system consistent with platform guidelines where applicable?
|
|
457
|
+
- Inference path: domain_scope.md §Normative System Classification → Tier-1b platform standards → dependency_rules.md §Source of Truth Management
|
|
458
|
+
- Verification criteria: PASS if platform conventions followed for system elements. FAIL if platform conventions violated without documentation
|
|
459
|
+
|
|
460
|
+
- **CQ-CO-05** [P3] Are visual specs consistent between design tool and code implementation?
|
|
461
|
+
- Inference path: dependency_rules.md §Design Tool–Code Dependency → Discrepancy Resolution → within defined tolerance
|
|
462
|
+
- Verification criteria: PASS if Figma and code values match within tolerance. FAIL if divergence detected
|
|
463
|
+
|
|
464
|
+
---
|
|
465
|
+
|
|
466
|
+
## Related Documents
|
|
467
|
+
- domain_scope.md — Sub-area to CQ section mapping, normative tier classification, cross-cutting concerns
|
|
468
|
+
- logic_rules.md — Rules providing inference paths for CQ answers
|
|
469
|
+
- structure_spec.md — Structural requirements providing inference paths
|
|
470
|
+
- dependency_rules.md — Dependency rules providing inference paths
|
|
471
|
+
- concepts.md — Term definitions referenced in questions
|
|
472
|
+
- extension_cases.md — Extension scenarios referenced in CQ-BI and CQ-DS
|