ai-delivery-workflow 0.2.2

package/skills/ai-delivery-design-experience/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: ai-delivery-design-experience
+description: Select prototype and UI tools, produce executable low-fidelity interactions, define a confirmed visual system, transform them into formal framework-based UI, record every adjustment and requirement impact, reconcile the final prototype with product requirements, and create a development-ready handoff. Use after initial architecture or whenever product, interaction, visual, framework, page, or component behavior changes.
+---
+
+# Design Experience
+
+Design complete user experiences for the terminals selected by product and implemented by architecture.
+
+## Artifact Location
+
+Write every workflow document, prototype management artifact, and review record produced by this skill under project `.workflow/`. Place version-scoped node outputs in `.workflow/iterations/<iteration-id>/<node-id>/` and approved reusable experience baselines in `.workflow/experience/`.
+
+## Task State
+
+1. Invoke `$ai-delivery-checkpoint-task` before preflight to recover or initialize the task snapshot.
+2. Checkpoint after every meaningful artifact, gate, validation, merge, deployment action, or other external milestone, and before compaction or interruption.
+3. Before returning, finish the snapshot as `completed`, `blocked`, `failed`, or `interrupted`, with actual outputs, evidence, blockers, and one idempotent next action. A Hook event alone never proves completion.
+
+## Preflight
+
+Read the approved product baseline, terminal and feature catalogs, initial architecture baseline, major-decision approval receipt or explicit not-required assessment, applicable design standards, and existing experience baseline. Verify all input versions and checksums. Return missing terminal scope or feature behavior to product definition; refuse to prototype from unapproved major architecture decisions.
+
+## Workflow
+
+1. Map each feature-terminal pair to user tasks and journeys.
+2. Reserve one stable prototype member ID per independent source/review lifecycle. Inspect actual tool and skill availability, recommend evidence-backed authoring tools and optional design assistants, and obtain the user's selection in a valid `prototype-tool-selection.yaml`. Do not start prototype authoring before this human tool-selection Gate passes.
+3. Define information architecture, navigation, task flows, and the stable page catalog. Use `P01` for a main page and `P01-01` for its child; keep identity separate from the display label and never renumber or reuse retired IDs.
+4. Plan prototype files and canvases explicitly. Keep one main-page family per canvas, split files at terminal/tool/freeze/review boundaries, and record normalized page-canvas-file-terminal relationships.
+5. Build a runnable low-fidelity interaction prototype using the architecture-selected frontend runtime or another selected executable authoring tool. Use neutral styling and mock, in-memory, or local persisted data. Every visible control must work; cover navigation, validation, loading, empty, success, error, permission, disabled, recovery, and responsive behavior in `interaction-contract.csv`.
+6. Run mandatory Gate `UX-LF`. The user must operate the prototype and approve the exact low-fidelity source revision in `low-fidelity-confirmation.yaml`. Record every comment and every resulting adjustment; re-review until no open adjustment remains. Interactive prototypes cannot use `contract-only`.
+7. Record every adjustment immediately in `prototype-adjustment-log.csv`, including its classification, before/after revision, reason, requirement/change references, and product, architecture, and test impacts. Never overwrite a prior revision. Create or update `experience-change-set.csv`, `experience-change-domains.csv`, and `requirement-change-set.csv` using stable IDs.
+8. After `UX-LF` passes, define `visual-direction.yaml`. Inspect compatible UI frameworks, skills, and MCP capabilities; record evidence in `ui-framework-candidates.csv`, recommend two or three viable options when available, and obtain the user's exact framework/version choice in `ui-framework-selection.yaml`. Architecture limits the runtime; experience selects the compatible UI system.
+9. Define machine-readable `design-tokens.json`, typography, semantic colors, spacing, size, border, radius, shadow, opacity, z-index, breakpoints, motion, icons, responsive rules, accessibility, and `component-state-matrix.csv`. Run mandatory Gate `UX-VS` and pin all visual-system checksums in `visual-system-confirmation.yaml`.
+10. Transform the confirmed low-fidelity prototype into a production-compatible formal UI baseline using the selected framework while preserving confirmed interactions. Keep mock data and do not bind production services. Map stable pages/elements to framework components and source entrypoints in `page-component-map.csv`.
+11. Run mandatory Gate `UX-UI`. The user must operate and approve the formal UI source revision. Record and re-review every adjustment until `formal-ui-confirmation.yaml` reaches candidate approval with no open comments. The candidate is not frozen yet.
+12. After all prototype members are candidate-approved, aggregate the full adjustment and requirement-change sets and invoke `$ai-delivery-define-product` in prototype-reconciliation mode. Produce complete bidirectional `prototype-product-coverage.csv`. Product owns `product-prototype-reconciliation.yaml`; never silently rewrite product requirements to match the prototype.
+13. When reconciliation finds a product change, create and approve a new product baseline, mark affected artifacts stale, revise only affected prototype members, rerun their required Gate, and repeat reconciliation. Reject or remove unapproved prototype behavior. Proceed only with `decision: aligned` and every requirement change terminal.
+14. Derive added, modified, retired, superseded, and unchanged experience rows by comparing stable IDs and checksums with the prior frozen experience baseline. Use phase states `proposed`, `interaction-confirmed`, `visual-confirmed`, `formal-ui-confirmed`, `architecture-accepted`, `ready-for-development`, `included-in-work-package`, `implemented`, and `verified`; use `changes-requested`, `stale`, `blocked`, `retired`, and `superseded` when applicable.
+15. Freeze every prototype source revision, Gate receipt, product-reconciliation receipt, review bundle, management catalog, design system, change set, coverage file, and manifest checksum; then freeze the ordered member list and `experience-baseline.yaml`.
+16. Run contract completeness checks and write one source confirmation per member plus `ui-handoff.yaml`. Set `development_readiness: ready-for-development` only when `UX-LF`, `UX-VS`, `UX-UI`, and product reconciliation all pass and no blocking or stale requirement/experience change remains.
+
+Tool selection, low-fidelity interaction approval, visual-system/framework approval, formal-UI approval, and final product reconciliation are required decisions for every visual or interactive prototype. Only genuinely non-visual terminals may use justified `not-applicable` results.
+
+## Outputs
+
+- user journeys and task flows;
+- information architecture and page inventory;
+- tool candidate catalog and human tool-selection receipt per prototype-set member;
+- stable page, canvas, file, and file-terminal catalogs;
+- wireframes and high-fidelity screens;
+- executable low-fidelity prototype, interaction contract, and `UX-LF` confirmation;
+- visual direction, UI framework candidates/selection, design tokens, component-state matrix, and `UX-VS` confirmation;
+- production-compatible formal UI baseline, page-component map, and `UX-UI` confirmation;
+- responsive, accessibility, content, and interaction rules;
+- state catalog;
+- mandatory staged-review decision, `UX-LF`/`UX-VS`/`UX-UI` receipts, review sessions, comments, adjustment log, and impact assessment;
+- experience change/domain sets and requirement change set;
+- product-prototype coverage and final reconciliation receipt;
+- versioned experience baseline and `ui-handoff.yaml` with explicit development readiness;
+- reviewable prototype source/export, one `prototype-manifest.yaml` per independently versioned bundle, and `prototype-set.yaml`;
+- `prototype-traceability.csv`;
+- one prototype source-confirmation YAML per prototype-set member;
+- `feature-screen-coverage.csv` mapping feature ID, terminal ID, flow ID, screen ID, and state ID;
+- versioned experience baseline and unresolved technical questions.
+
+Read [experience-contract.md](references/experience-contract.md) for handoff identity and [prototype-management-contract.md](references/prototype-management-contract.md) for tool, page, canvas, file, and review rules. Use `assets/experience-template/` for all controlled templates.
+
+## Handoff
+
+Send the experience baseline, `ui-handoff.yaml`, all four Gate receipts, change sets, interaction/visual/component contracts, frozen prototype set identity, every member manifest/checksum, source revision, review-bundle checksum, management checksums, traceability checksum, and source-confirmation checksum to `$ai-delivery-design-architecture` in reconcile mode. Architecture writes one separate validation receipt per set member and advances accepted experience changes to `ready-for-development`. Preserve the same frozen set for planning and test design; downstream nodes must never edit experience artifacts.

package/skills/ai-delivery-design-experience/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Design Managed Prototypes"
+  short_description: "Select tools and manage reviewable prototypes"
+  default_prompt: "Use $ai-delivery-design-experience to select a prototype tool, manage pages and canvases, and close review before handoff."

package/skills/ai-delivery-design-experience/assets/experience-template/canvas-catalog.csv

@@ -0,0 +1 @@
+canvas_id,prototype_artifact_id,prototype_file_id,canvas_name,main_page_id,terminal_id,lifecycle_status,split_rationale

package/skills/ai-delivery-design-experience/assets/experience-template/canvas-pages.csv

@@ -0,0 +1 @@
+canvas_id,page_id,placement_order,is_primary

package/skills/ai-delivery-design-experience/assets/experience-template/component-state-matrix.csv

@@ -0,0 +1 @@
+ui_component_id,state,visual_rule,interaction_rule,accessibility_rule,token_refs,status

package/skills/ai-delivery-design-experience/assets/experience-template/design-tokens.json

@@ -0,0 +1,19 @@
+{
+  "artifact_id": "DESIGN-TOKENS-0001",
+  "artifact_type": "design-tokens",
+  "version": 1,
+  "status": "draft",
+  "tokens": {
+    "color": {},
+    "typography": {},
+    "spacing": {},
+    "size": {},
+    "border": {},
+    "radius": {},
+    "shadow": {},
+    "opacity": {},
+    "z_index": {},
+    "breakpoint": {},
+    "motion": {}
+  }
+}

package/skills/ai-delivery-design-experience/assets/experience-template/experience-baseline.yaml

@@ -0,0 +1,17 @@
+artifact_id: EXPERIENCE-BASELINE-0001
+artifact_type: experience-baseline
+version: 1.0.0
+based_on_version: null
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+product_baseline_ref: PRODUCT-BASELINE-0001@1
+architecture_initial_ref: ARCH-INITIAL-0001@1
+prototype_set_ref: PROTOTYPE-SET-0001@1
+low_fidelity_gate_status: pending
+visual_system_gate_status: pending
+formal_ui_gate_status: pending
+product_reconciliation_status: pending
+experience_change_set_ref: experience-change-set.csv
+requirement_change_set_ref: requirement-change-set.csv
+development_readiness: blocked

package/skills/ai-delivery-design-experience/assets/experience-template/experience-change-domains.csv

@@ -0,0 +1 @@
+experience_change_id,change_domain

package/skills/ai-delivery-design-experience/assets/experience-template/experience-change-set.csv

@@ -0,0 +1 @@
+experience_change_id,change_type,artifact_type,stable_id,parent_id,terminal_id,feature_id,acceptance_id,from_version,to_version,phase,phase_status,summary,implementation_impact,test_impact,breaking_change,before_checksum,after_checksum

package/skills/ai-delivery-design-experience/assets/experience-template/feature-screen-coverage.csv

@@ -0,0 +1 @@
+feature_id,terminal_id,flow_id,screen_id,state_id,coverage_status,notes

package/skills/ai-delivery-design-experience/assets/experience-template/formal-ui-confirmation.yaml

@@ -0,0 +1,33 @@
+artifact_id: FORMAL-UI-CONFIRMATION-0001
+artifact_type: formal-ui-human-confirmation
+version: 1
+iteration_id: ITER-0001
+status: pending
+producer_skill: ai-delivery-design-experience
+prototype_artifact_id: PROTOTYPE-0001
+low_fidelity_confirmation_ref: LOW-FIDELITY-CONFIRMATION-0001@1
+visual_system_confirmation_ref: VISUAL-SYSTEM-CONFIRMATION-0001@1
+formal_ui_source_revision: UI-REVISION-0001
+formal_ui_review_entrypoint: prototype/formal-ui/index.html
+page_component_map_ref: page-component-map.csv
+page_component_map_checksum: REPLACE_WITH_SHA256
+interaction_contract_checksum: REPLACE_WITH_SHA256
+experience_change_set_checksum: REPLACE_WITH_SHA256
+candidate_status: candidate-approved-pending
+checks:
+  confirmed_interactions_preserved: pending
+  framework_components_applied: pending
+  visual_system_applied: pending
+  component_states_complete: pending
+  responsive_behavior: pending
+  accessibility: pending
+  no_dead_controls: pending
+human_approval:
+  required: true
+  approver: null
+  decided_at: null
+  decision: pending
+  approved_source_revision: null
+decision: pending
+blocking_issues: []
+evidence: []

package/skills/ai-delivery-design-experience/assets/experience-template/interaction-contract.csv

@@ -0,0 +1 @@
+interaction_id,prototype_artifact_id,page_id,prototype_element_id,trigger,precondition,state_before,state_after,observable_feedback,error_behavior,keyboard_behavior,acceptance_id,status

package/skills/ai-delivery-design-experience/assets/experience-template/low-fidelity-confirmation.yaml

@@ -0,0 +1,32 @@
+artifact_id: LOW-FIDELITY-CONFIRMATION-0001
+artifact_type: low-fidelity-interaction-confirmation
+version: 1
+iteration_id: ITER-0001
+status: pending
+producer_skill: ai-delivery-design-experience
+prototype_artifact_id: PROTOTYPE-0001
+prototype_fidelity: low-fidelity-interactive
+interaction_runtime: executable
+source_revision: LF-REVISION-0001
+review_entrypoint: prototype/low-fidelity/index.html
+interaction_contract_ref: interaction-contract.csv
+interaction_contract_checksum: REPLACE_WITH_SHA256
+experience_change_set_ref: experience-change-set.csv
+experience_change_set_checksum: REPLACE_WITH_SHA256
+checks:
+  executable_entrypoint: pending
+  layout_coverage: pending
+  interaction_coverage: pending
+  state_changes: pending
+  validation_and_errors: pending
+  responsive_behavior: pending
+  no_dead_controls: pending
+human_approval:
+  required: true
+  approver: null
+  decided_at: null
+  decision: pending
+  approved_source_revision: null
+decision: pending
+blocking_issues: []
+evidence: []

package/skills/ai-delivery-design-experience/assets/experience-template/page-catalog.csv

@@ -0,0 +1 @@
+page_id,page_name,display_label,parent_page_id,page_level,prototype_artifact_id,terminal_id,route_ref,lifecycle_status,notes

package/skills/ai-delivery-design-experience/assets/experience-template/page-component-map.csv

@@ -0,0 +1 @@
+page_id,prototype_element_id,ui_component_id,framework_component,source_ref,lifecycle_status

package/skills/ai-delivery-design-experience/assets/experience-template/product-prototype-reconciliation.yaml

@@ -0,0 +1,28 @@
+artifact_id: PRODUCT-PROTOTYPE-RECONCILIATION-0001
+artifact_type: product-prototype-reconciliation
+version: 1
+iteration_id: ITER-0001
+status: pending
+producer_skill: ai-delivery-define-product
+input_product_baseline: PRODUCT-BASELINE-0001@1
+input_prototype_set: PROTOTYPE-SET-0001@1
+formal_ui_confirmation_ref: FORMAL-UI-CONFIRMATION-0001@1
+requirement_change_set_ref: requirement-change-set.csv
+requirement_change_set_checksum: REPLACE_WITH_SHA256
+prototype_product_coverage_ref: prototype-product-coverage.csv
+prototype_product_coverage_checksum: REPLACE_WITH_SHA256
+result_product_baseline: null
+result_product_baseline_checksum: null
+checks:
+  prototype_behavior_has_approved_requirement: pending
+  product_behavior_has_prototype_coverage: pending
+  terminal_alignment: pending
+  terminology_alignment: pending
+  states_and_exceptions_alignment: pending
+  requirement_change_closure: pending
+all_requirement_changes_terminal: false
+stale_artifacts: []
+revalidation_required: []
+decision: pending
+blocking_issues: []
+evidence: []

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-adjustment-log.csv

@@ -0,0 +1 @@
+adjustment_id,review_comment_id,prototype_artifact_id,page_id,prototype_element_id,classification,from_source_revision,to_source_revision,change_summary,reason,requirement_change_ref,experience_change_ref,product_impact,architecture_impact,test_impact,evidence_ref,status

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-confirmation.yaml

@@ -0,0 +1,99 @@
+artifact_id: PROTOTYPE-CONFIRMATION-0001
+artifact_type: prototype-source-confirmation
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+input_artifacts:
+  prototype_set: PROTOTYPE-SET-0001@1
+  prototype_manifest: PROTOTYPE-0001@1
+  prototype_tool_selection: PROTOTYPE-TOOL-SELECTION-0001@1
+  prototype_review_decision: PROTOTYPE-REVIEW-DECISION-0001@1
+  prototype_impact_assessment: PROTOTYPE-IMPACT-ASSESSMENT-0001@1
+standards: []
+prototype_set_ref: PROTOTYPE-SET-0001@1
+prototype_set_checksum: REPLACE_WITH_SHA256
+prototype_artifact_id: PROTOTYPE-0001
+prototype_version: 1
+prototype_manifest_ref: prototype-manifest-PROTOTYPE-0001.yaml
+prototype_manifest_checksum: REPLACE_WITH_SHA256
+source_revision: REVISION-0001
+review_bundle_algorithm: sha256
+review_bundle_checksum: REPLACE_WITH_SHA256
+tool_selection_checksum: REPLACE_WITH_SHA256
+page_catalog_checksum: REPLACE_WITH_SHA256
+canvas_catalog_checksum: REPLACE_WITH_SHA256
+canvas_pages_checksum: REPLACE_WITH_SHA256
+prototype_files_checksum: REPLACE_WITH_SHA256
+prototype_file_terminals_checksum: REPLACE_WITH_SHA256
+prototype_review_decision_checksum: REPLACE_WITH_SHA256
+prototype_review_sessions_checksum: REPLACE_WITH_SHA256
+prototype_review_comments_checksum: REPLACE_WITH_SHA256
+prototype_adjustment_log_checksum: REPLACE_WITH_SHA256
+prototype_impact_assessment_checksum: REPLACE_WITH_SHA256
+traceability_checksum: REPLACE_WITH_SHA256
+state_catalog_checksum: REPLACE_WITH_SHA256
+feature_screen_coverage_checksum: REPLACE_WITH_SHA256
+confirmation_mode: contract-validation
+human_approval:
+  required: false
+  approver: null
+  decided_at: null
+  decision: not-required
+  approved_source_revision: null
+  prototype_set_checksum: null
+  prototype_manifest_checksum: null
+checks:
+  tool_selection:
+    status: pending
+    evidence: []
+    rationale: null
+  prototype_management:
+    status: pending
+    evidence: []
+    rationale: null
+  human_review_closure:
+    status: pending
+    evidence: []
+    rationale: null
+  impact_propagation:
+    status: pending
+    evidence: []
+    rationale: null
+  product_behavior:
+    status: pending
+    evidence: []
+    rationale: null
+  acceptance_criteria:
+    status: pending
+    evidence: []
+    rationale: null
+  terminal_coverage:
+    status: pending
+    evidence: []
+    rationale: null
+  product_terminology:
+    status: pending
+    evidence: []
+    rationale: null
+  initial_architecture_constraints:
+    status: pending
+    evidence: []
+    rationale: null
+  state_and_interaction_coverage:
+    status: pending
+    evidence: []
+    rationale: null
+  responsive_behavior:
+    status: pending
+    evidence: []
+    rationale: null
+  accessibility:
+    status: pending
+    evidence: []
+    rationale: null
+decision: changes-required
+confirmed_at: null
+blocking_issues: []
+return_node: experience-design
+evidence: []

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-file-terminals.csv

@@ -0,0 +1 @@
+prototype_file_id,terminal_id

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-files.csv

@@ -0,0 +1 @@
+prototype_file_id,prototype_artifact_id,authoring_candidate_id,file_ref,source_revision,lifecycle_scope,review_scope,lifecycle_status

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-impact-assessment.yaml

@@ -0,0 +1,25 @@
+artifact_id: PROTOTYPE-IMPACT-ASSESSMENT-0001
+artifact_type: prototype-review-impact-assessment
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+input_artifacts:
+  prototype_review_decision: PROTOTYPE-REVIEW-DECISION-0001@1
+standards: []
+prototype_artifact_id: PROTOTYPE-0001
+prototype_version: 1
+review_sessions_ref: prototype-review-sessions-PROTOTYPE-0001.csv
+review_comments_ref: prototype-review-comments-PROTOTYPE-0001.csv
+adjustment_log_ref: prototype-adjustment-log-PROTOTYPE-0001.csv
+review_decision_checksum: REPLACE_WITH_SHA256
+review_sessions_checksum: REPLACE_WITH_SHA256
+review_comments_checksum: REPLACE_WITH_SHA256
+adjustment_log_checksum: REPLACE_WITH_SHA256
+assessments: []
+upstream_changes_required: false
+required_rebaselines: []
+stale_artifacts: []
+decision: changes-required
+blocking_issues: []
+evidence: []

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-manifest.yaml

@@ -0,0 +1,74 @@
+artifact_id: PROTOTYPE-0001
+artifact_type: experience-prototype
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+inputs:
+  product_baseline: PRODUCT-BASELINE-0001@1
+  architecture_initial: ARCH-INITIAL-0001@1
+  architecture_gate: ARCH-GATE-0001@1
+  prototype_tool_selection: PROTOTYPE-TOOL-SELECTION-0001@1
+  prototype_review_decision: PROTOTYPE-REVIEW-DECISION-0001@1
+  prototype_impact_assessment: PROTOTYPE-IMPACT-ASSESSMENT-0001@1
+input_checksums:
+  product_baseline: REPLACE_WITH_SHA256
+  architecture_initial: REPLACE_WITH_SHA256
+  architecture_gate: REPLACE_WITH_SHA256
+tool_selection_ref: prototype-tool-selection-PROTOTYPE-0001.yaml
+tool_selection_algorithm: sha256
+tool_selection_checksum: REPLACE_WITH_SHA256
+prototype:
+  prototype_type: interactive
+  fidelity: low
+  source_ref: prototype/source
+  source_revision: REVISION-0001
+  review_entrypoint_in_bundle: index.html
+  review_bundle: prototype/review/prototype-review.zip
+  review_bundle_algorithm: sha256
+  review_bundle_checksum: REPLACE_WITH_SHA256
+coverage:
+  terminal_ids: []
+  flow_ids: []
+  screen_ids: []
+  state_ids: []
+page_catalog_ref: page-catalog-PROTOTYPE-0001.csv
+page_catalog_algorithm: sha256
+page_catalog_checksum: REPLACE_WITH_SHA256
+canvas_catalog_ref: canvas-catalog-PROTOTYPE-0001.csv
+canvas_catalog_algorithm: sha256
+canvas_catalog_checksum: REPLACE_WITH_SHA256
+canvas_pages_ref: canvas-pages-PROTOTYPE-0001.csv
+canvas_pages_algorithm: sha256
+canvas_pages_checksum: REPLACE_WITH_SHA256
+prototype_files_ref: prototype-files-PROTOTYPE-0001.csv
+prototype_files_algorithm: sha256
+prototype_files_checksum: REPLACE_WITH_SHA256
+prototype_file_terminals_ref: prototype-file-terminals-PROTOTYPE-0001.csv
+prototype_file_terminals_algorithm: sha256
+prototype_file_terminals_checksum: REPLACE_WITH_SHA256
+prototype_review_decision_ref: prototype-review-decision-PROTOTYPE-0001.yaml
+prototype_review_decision_algorithm: sha256
+prototype_review_decision_checksum: REPLACE_WITH_SHA256
+prototype_review_sessions_ref: prototype-review-sessions-PROTOTYPE-0001.csv
+prototype_review_sessions_algorithm: sha256
+prototype_review_sessions_checksum: REPLACE_WITH_SHA256
+prototype_review_comments_ref: prototype-review-comments-PROTOTYPE-0001.csv
+prototype_review_comments_algorithm: sha256
+prototype_review_comments_checksum: REPLACE_WITH_SHA256
+prototype_adjustment_log_ref: prototype-adjustment-log-PROTOTYPE-0001.csv
+prototype_adjustment_log_algorithm: sha256
+prototype_adjustment_log_checksum: REPLACE_WITH_SHA256
+prototype_impact_assessment_ref: prototype-impact-assessment-PROTOTYPE-0001.yaml
+prototype_impact_assessment_algorithm: sha256
+prototype_impact_assessment_checksum: REPLACE_WITH_SHA256
+traceability_ref: prototype-traceability.csv
+traceability_algorithm: sha256
+traceability_checksum: REPLACE_WITH_SHA256
+state_catalog_ref: screen-states.csv
+state_catalog_algorithm: sha256
+state_catalog_checksum: REPLACE_WITH_SHA256
+feature_screen_coverage_ref: feature-screen-coverage.csv
+feature_screen_coverage_algorithm: sha256
+feature_screen_coverage_checksum: REPLACE_WITH_SHA256
+standards: []

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-product-coverage.csv

@@ -0,0 +1 @@
+feature_id,story_id,acceptance_id,terminal_id,prototype_artifact_id,page_id,prototype_element_id,coverage_status,rationale

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-review-comments.csv

@@ -0,0 +1 @@
+review_comment_id,review_session_id,page_id,canvas_id,prototype_file_id,prototype_element_id,classification,severity,comment,evidence_ref,responsible_node,status,rationale

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-review-decision.yaml

@@ -0,0 +1,29 @@
+artifact_id: PROTOTYPE-REVIEW-DECISION-0001
+artifact_type: prototype-human-review-decision
+version: 1
+iteration_id: ITER-0001
+status: pending
+producer_skill: ai-delivery-design-experience
+input_artifacts:
+  prototype_tool_selection: PROTOTYPE-TOOL-SELECTION-0001@1
+standards: []
+prototype_artifact_id: PROTOTYPE-0001
+prototype_version: 1
+candidate_source_revision: REVISION-0001
+page_catalog_ref: page-catalog-PROTOTYPE-0001.csv
+canvas_catalog_ref: canvas-catalog-PROTOTYPE-0001.csv
+canvas_pages_ref: canvas-pages-PROTOTYPE-0001.csv
+prototype_files_ref: prototype-files-PROTOTYPE-0001.csv
+prototype_file_terminals_ref: prototype-file-terminals-PROTOTYPE-0001.csv
+tool_selection_checksum: REPLACE_WITH_SHA256
+page_catalog_checksum: REPLACE_WITH_SHA256
+canvas_catalog_checksum: REPLACE_WITH_SHA256
+canvas_pages_checksum: REPLACE_WITH_SHA256
+prototype_files_checksum: REPLACE_WITH_SHA256
+prototype_file_terminals_checksum: REPLACE_WITH_SHA256
+asked_at: null
+decision: pending
+human_review_required: true
+decided_by: null
+decided_at: null
+rationale: null

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-review-sessions.csv

@@ -0,0 +1 @@
+review_session_id,prototype_artifact_id,prototype_version,source_revision,review_round,reviewer,status,started_at,completed_at,decision,evidence_ref

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-set.yaml

@@ -0,0 +1,22 @@
+artifact_id: PROTOTYPE-SET-0001
+artifact_type: experience-prototype-set
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+input_artifacts:
+  product_baseline: PRODUCT-BASELINE-0001@1
+  architecture_initial: ARCH-INITIAL-0001@1
+  architecture_gate: ARCH-GATE-0001@1
+input_checksums:
+  product_baseline: REPLACE_WITH_SHA256
+  architecture_initial: REPLACE_WITH_SHA256
+  architecture_gate: REPLACE_WITH_SHA256
+standards: []
+members:
+  - prototype_artifact_id: PROTOTYPE-0001
+    prototype_version: 1
+    terminal_ids: []
+    manifest_ref: prototype-manifest-PROTOTYPE-0001.yaml
+    manifest_algorithm: sha256
+    manifest_checksum: REPLACE_WITH_SHA256

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-tool-candidates.csv

@@ -0,0 +1 @@
+candidate_id,prototype_artifact_id,tool_name,tool_kind,availability,availability_evidence,fit_level,fit_rationale,recommendation_rank

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-tool-selection.yaml

@@ -0,0 +1,22 @@
+artifact_id: PROTOTYPE-TOOL-SELECTION-0001
+artifact_type: prototype-tool-selection
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+input_artifacts:
+  product_baseline: PRODUCT-BASELINE-0001@1
+  architecture_initial: ARCH-INITIAL-0001@1
+standards: []
+prototype_artifact_id: PROTOTYPE-0001
+prototype_version: 1
+candidate_catalog_ref: prototype-tool-candidates-PROTOTYPE-0001.csv
+candidate_catalog_algorithm: sha256
+candidate_catalog_checksum: REPLACE_WITH_SHA256
+decision: pending
+selected_authoring_candidate_id: null
+selected_design_assistant_candidate_ids: []
+selected_by: null
+selected_at: null
+availability_verified_at: null
+rationale: null

package/skills/ai-delivery-design-experience/assets/experience-template/prototype-traceability.csv

@@ -0,0 +1 @@
+prototype_element_id,prototype_artifact_id,prototype_version,source_revision,prototype_file_id,canvas_id,page_id,feature_id,acceptance_id,terminal_id,flow_id,screen_id,state_id,interaction,coverage_status

package/skills/ai-delivery-design-experience/assets/experience-template/requirement-change-set.csv

@@ -0,0 +1 @@
+requirement_change_id,source_adjustment_id,change_type,artifact_type,affected_id,proposed_id,phase,summary,before_ref,after_ref,reason,product_impact,architecture_impact,experience_impact,test_impact,status

package/skills/ai-delivery-design-experience/assets/experience-template/screen-states.csv

@@ -0,0 +1 @@
+state_id,screen_id,state_type,trigger,user_message,available_actions,recovery,accessibility_notes

package/skills/ai-delivery-design-experience/assets/experience-template/ui-framework-candidates.csv

@@ -0,0 +1 @@
+candidate_id,framework_name,framework_version,technology_compatibility,component_coverage,accessibility,customization,bundle_impact,license,maintenance_status,fit_rationale,recommendation_rank

package/skills/ai-delivery-design-experience/assets/experience-template/ui-framework-selection.yaml

@@ -0,0 +1,18 @@
+artifact_id: UI-FRAMEWORK-SELECTION-0001
+artifact_type: ui-framework-selection
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+architecture_stack_ref: ARCH-INITIAL-0001@1
+low_fidelity_confirmation_ref: LOW-FIDELITY-CONFIRMATION-0001@1
+candidate_catalog_ref: ui-framework-candidates.csv
+candidate_catalog_checksum: REPLACE_WITH_SHA256
+selected_candidate_id: null
+selected_framework: null
+selected_version: null
+selected_by: null
+selected_at: null
+decision: pending
+rationale: null
+constraints: []

package/skills/ai-delivery-design-experience/assets/experience-template/ui-handoff.yaml

@@ -0,0 +1,44 @@
+artifact_id: UI-HANDOFF-0001
+artifact_type: experience-ui-handoff
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+experience_baseline_ref: EXPERIENCE-BASELINE-0001@1.0.0
+experience_baseline_checksum: REPLACE_WITH_SHA256
+prototype_set_ref: PROTOTYPE-SET-0001@1
+prototype_set_checksum: REPLACE_WITH_SHA256
+required_gates:
+  low_fidelity_ref: LOW-FIDELITY-CONFIRMATION-0001@1
+  visual_system_ref: VISUAL-SYSTEM-CONFIRMATION-0001@1
+  formal_ui_ref: FORMAL-UI-CONFIRMATION-0001@1
+  product_reconciliation_ref: PRODUCT-PROTOTYPE-RECONCILIATION-0001@1
+required_gate_checksums:
+  low_fidelity: REPLACE_WITH_SHA256
+  visual_system: REPLACE_WITH_SHA256
+  formal_ui: REPLACE_WITH_SHA256
+  product_reconciliation: REPLACE_WITH_SHA256
+required_gate_statuses:
+  low_fidelity: pending
+  visual_system: pending
+  formal_ui: pending
+  product_reconciliation: pending
+artifacts:
+  interaction_contract_ref: interaction-contract.csv
+  interaction_contract_checksum: REPLACE_WITH_SHA256
+  design_tokens_ref: design-tokens.json
+  design_tokens_checksum: REPLACE_WITH_SHA256
+  ui_framework_selection_ref: ui-framework-selection.yaml
+  ui_framework_selection_checksum: REPLACE_WITH_SHA256
+  component_state_matrix_ref: component-state-matrix.csv
+  component_state_matrix_checksum: REPLACE_WITH_SHA256
+  page_component_map_ref: page-component-map.csv
+  page_component_map_checksum: REPLACE_WITH_SHA256
+  experience_change_set_ref: experience-change-set.csv
+  experience_change_set_checksum: REPLACE_WITH_SHA256
+  requirement_change_set_ref: requirement-change-set.csv
+  requirement_change_set_checksum: REPLACE_WITH_SHA256
+  prototype_product_coverage_ref: prototype-product-coverage.csv
+  prototype_product_coverage_checksum: REPLACE_WITH_SHA256
+development_readiness: blocked
+blocking_issues: []

package/skills/ai-delivery-design-experience/assets/experience-template/visual-direction.yaml

@@ -0,0 +1,16 @@
+artifact_id: VISUAL-DIRECTION-0001
+artifact_type: experience-visual-direction
+version: 1
+iteration_id: ITER-0001
+status: draft
+producer_skill: ai-delivery-design-experience
+product_character: null
+target_audience: []
+usage_context: []
+information_density: null
+theme_modes: []
+brand_constraints: []
+preferred_directions: []
+excluded_directions: []
+references: []
+rationale: null