From 8b8f4fd54196cc91a19dad15c7e82240ab123c33 Mon Sep 17 00:00:00 2001 From: Emmeline Hoops <108825895+chaosdinosaur@users.noreply.github.com> Date: Wed, 20 May 2026 13:26:06 -0700 Subject: [PATCH 1/6] feat(skills): add demo-setup skill to design-thinking collection Closes #1622 Add the demo-setup skill that creates demo-ready prototypes by guiding users through a simulated DT Coach session with a customer persona, then scaffolding a hi-fi prototype via the hifi-prototype skill. Changes: - Add .github/skills/design-thinking/demo-setup/SKILL.md - Add skill entry to collections/design-thinking.collection.yml - Add Skills table to collections/design-thinking.collection.md --- .../design-thinking/demo-setup/SKILL.md | 397 ++++++++++++++++++ collections/design-thinking.collection.md | 6 + collections/design-thinking.collection.yml | 5 + 3 files changed, 408 insertions(+) create mode 100644 .github/skills/design-thinking/demo-setup/SKILL.md diff --git a/.github/skills/design-thinking/demo-setup/SKILL.md b/.github/skills/design-thinking/demo-setup/SKILL.md new file mode 100644 index 000000000..6acca022f --- /dev/null +++ b/.github/skills/design-thinking/demo-setup/SKILL.md @@ -0,0 +1,397 @@ +--- +name: demo-setup +description: 'Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype - Brought to you by microsoft/hve-core' +user-invocable: true +metadata: + authors: "microsoft/hve-core" + spec_version: "1.0" + last_updated: "2026-05-11" +--- + +# Demo Setup + +## Overview + +Creates demo-ready prototypes by guiding you through a simulated Design Thinking Coach session with a customer persona, then scaffolding a hi-fi prototype. The skill generates a customer persona brief with realistic conversation seeds, accelerates through DT Methods 1 through 6 with simulated customer dialogue, and hands off to the hifi-prototype skill for Method 7 scaffolding. The result is a complete, runnable demo with a presenter's walkthrough guide and a video script for recording. + +Primary audience: new users learning HVE Core tools. + +Core design constraints: + +* Every demo starts with a customer persona brief that drives the simulated conversation. +* DT Coach interactions use accelerated pacing (2 to 3 exchanges per method) for demo efficiency. +* The hifi-prototype skill handles all scaffold generation and experiment framing. +* Presenter's guide included so demos are repeatable without memorizing the flow. +* Demo video script generated for recording a polished walkthrough video. +* Built-in example scenarios available for immediate use without custom input. + +## Prerequisites + +* DT Coach agent accessible (provided by the HVE Core extension) +* hifi-prototype skill accessible (workspace `.github/skills/hifi-prototype/`) +* `.copilot-tracking/` directory exists at the workspace root + +## Quick Start + +Run a demo with a built-in scenario: + +1. Invoke `/demo-setup` with `customer=IFS`, `industry=field service`, `scenario=ifs-smartparts`. +2. The DT Coach walks through Methods 1 through 6 with a pre-built persona and conversation seeds. +3. At Method 7 the hifi-prototype skill scaffolds a runnable prototype. +4. Open `index.html` in a browser and follow the presenter's guide in `README.md`. + +## When to Use + +- Setting up a demo for a customer, partner, or internal team to showcase HVE Core tooling +- Onboarding new users who need to see the DT Coach and prototype workflow end to end +- Preparing a conference talk, workshop, or training session that walks through the tools +- Creating a reference demo that others can replicate independently + +## When Not to Use + +- Running a real Design Thinking engagement with actual stakeholders (use the DT Coach directly) +- Building a production prototype without the demo scaffolding and walkthrough +- Creating a static slide deck or documentation (use the canonical deck or PowerPoint skill) +- The audience already knows the tools and needs advanced workflow guidance + +## Inputs + +| Input | Required | Description | +|---|---|---| +| `customer` | Yes | Customer name or organization for the demo scenario | +| `industry` | Yes | Industry vertical (field service, government, healthcare, manufacturing, energy) | +| `persona` | No | End-user persona name and role. Generated from customer and industry context when omitted | +| `problem` | No | Brief problem statement. Inferred from industry patterns when omitted | +| `scenario` | No | Built-in scenario key (`ifs-smartparts`, `nydoc-verify`) or `custom` for user-provided context. Defaults to `custom` | +| `accelerated` | No | Whether to use accelerated DT method pacing for demo purposes. Defaults to `true` | + +## Customer Persona Brief Template + +The skill generates a customer persona brief before starting the DT Coach session. This brief drives all simulated customer interactions through Methods 1 through 6. + +Save location: `.copilot-tracking/dt/{project-slug}/context/customer-persona-brief.md` + +### Organization Profile + +| Field | Description | +|---|---| +| Name | Organization name | +| Industry | Industry vertical and sub-sector | +| Size | Employee count and scale indicators | +| Context | Business context, market position, and relevant operational details | + +### Persona Profile + +| Field | Description | +|---|---| +| Name | Full name of the persona | +| Role | Job title and department | +| Daily work | Typical workday activities and responsibilities | +| Frustrations | Top 3 to 5 pain points in current workflow | +| Goals | What success looks like for this person | + +### Problem Scenario + +| Field | Description | +|---|---| +| Specific situation | Concrete instance of the problem occurring | +| Constraints | Budget, timeline, regulatory, or technical limitations | +| Stakeholders affected | Who else feels the impact of this problem | +| Existing workarounds | How the persona currently copes with the problem | + +### Conversation Seeds + +Conversation seeds provide realistic customer responses that the DT Coach uses during simulated interactions. Each seed matches the coaching focus of its method. + +| Method | Seed Focus | Example Response Pattern | +|---|---|---| +| M1 Scope | What the customer says about their problem initially | Describes the pain point in their own words, mentions what prompted the conversation | +| M2 Research | Daily workflow description and pain points | Walks through a typical day, highlights where things break down | +| M3 Synthesis | Reactions to synthesized themes | Confirms or challenges pattern accuracy, adds nuance from their experience | +| M4 Brainstorming | What excites and concerns them about ideas | Responds to feasibility, flags organizational constraints, identifies quick wins | +| M5 Concepts | Feedback on visual concepts | Reacts to desirability, viability, and feasibility of proposed solutions | +| M6 Lo-Fi | Reactions to paper prototypes | Points out usability friction, suggests workflow changes, identifies missing steps | + +### Domain Vocabulary + +Industry-specific terms the persona would naturally use in conversation. Include 10 to 15 terms with brief definitions for context. + +## Workflow + +Follow the six-step workflow to set up a complete HVE Core demo. Each step builds on the previous one. + +| Step | Name | Purpose | +|---|---|---| +| 1 | Define Customer Scenario | Accept or generate the customer context and persona brief | +| 2 | Initialize DT Coach Session | Create project structure and start the coaching session | +| 3 | Guided DT Methods 1-6 | Accelerated coaching with simulated customer conversations | +| 4 | Prototype Scaffold | Transition to Method 7 and generate the runnable prototype | +| 5 | Demo Walkthrough Guide | Generate the presenter's guide and finalize the demo | +| 6 | Demo Video Script | Generate a narrated video script for recording the demo | + +### Step 1: Define Customer Scenario + +Accept customer context from user inputs or let them select a built-in example scenario. + +1. If `scenario` matches a built-in example, generate the persona brief from the built-in example data in the Built-In Example Scenarios section. +2. If custom inputs are provided, generate a Customer Persona Brief from the `customer`, `industry`, `persona`, and `problem` inputs. +3. Fill all sections of the Customer Persona Brief Template, including conversation seeds tailored to the industry and problem. +4. Derive the project slug: for built-in scenarios, use the scenario key as the slug (for example, `ifs-smartparts` or `nydoc-verify`). For custom scenarios, strip all characters except letters, digits, and spaces from the customer name, collapse consecutive spaces, then lowercase and replace spaces with hyphens (for example, `Contoso Manufacturing` becomes `contoso-manufacturing`, `O'Brien & Co.` becomes `obrien-co`). If the resulting slug is empty, prompt the user for a valid customer name. +5. Save the brief to `.copilot-tracking/dt/{project-slug}/context/customer-persona-brief.md` using the project slug derived above. + +Checkpoint: persona brief exists with all sections populated. + +### Step 2: Initialize DT Coach Session + +Create the project structure and start the DT Coach session with demo context. + +1. Use the project slug derived in Step 1. +2. Initialize `coaching-state.md` with `initial_classification` set to `frozen` and add a `session_mode: demo` field under the `project` block to signal accelerated pacing. +3. Include at minimum these fields: `project.slug`, `project.name`, `project.initial_classification: frozen`, `project.session_mode: demo`, `current.method: 1`, `current.space: problem`, `current.phase: session-init`. +4. The DT Coach loads the customer persona brief as simulated customer context. +5. Begin Method 1 with the DT Coach greeting and session initialization. + +Checkpoint: coaching-state.md exists with demo `initial_classification` and Method 1 active. + +### Step 3: Guided DT Methods 1-6 (Accelerated Demo Mode) + +The DT Coach guides through each method with simulated customer conversations drawn from the persona brief. + +1. At each method, the persona brief's conversation seeds provide realistic customer responses. +2. In accelerated mode, each method completes in 2 to 3 exchanges (one user turn plus one coach response per exchange), compared to 10 or more in full coaching. +3. Key artifacts are generated at each method exit: + - M1: stakeholder map and scope summary + - M2: research notes and interview synthesis + - M3: theme clusters and problem statement + - M4: prioritized idea list + - M5: concept cards with desirability/feasibility/viability assessment + - M6: lo-fi prototype sketches and usability notes +4. At each method transition, highlight which HVE Core tool or feature is being demonstrated: + - M1 to M2: coaching state persistence and session recovery + - M2 to M3: artifact lineage across methods + - M3 to M4: problem-to-solution space transition + - M4 to M5: concept cards with D/F/V evaluation + - M5 to M6: canonical deck snapshot (optional) + - M6 to M7: hifi-prototype skill handoff + +Checkpoint: Methods 1 through 6 have generated artifacts in the coaching state. + +### Step 4: Prototype Scaffold (Method 7) + +Transition to Method 7 and invoke the hifi-prototype skill for scaffold generation. + +1. Invoke the hifi-prototype skill with the inputs from the Hifi-Prototype Input Mapping table below. +2. Populate the experiment card from DT session artifacts (hypothesis from M3 themes, success criteria from M5 concepts). +3. Generate the scaffold using demo template patterns from existing examples. +4. Fixture data derived from the persona brief and domain vocabulary. +5. Name the fixture file after the primary domain noun in plural form (for example, `machines.js`, `vehicles.js`, `patients.js`). +6. Include experiment banner on every page with hypothesis text. +7. Apply `[SIMULATED]` badges to all mock components. +8. Pre-wire telemetry for page views, clicks, and task timing. + +#### Hifi-Prototype Input Mapping + +| hifi-prototype Input | Source DT Artifact | Derivation | +|---|---|---| +| Hypothesis | M3 problem statement | Reframe as a testable prediction about user behavior | +| Success criteria | M5 concept D/F/V assessment | Convert desirability, feasibility, and viability ratings into measurable conditions | +| Stack preference | Always `html` | Default zero-install stack for demos | +| Simulation needs | M2 constraint catalog and M6 usability notes | List components that cannot be built live and require fixtures | +| Telemetry level | Always `basic` | Page views, clicks, and task timing for demo purposes | +| Storage | Always `files` | Zero-dependency demo default; avoids database setup | +| LLM provider | Always `none` | Demos use fixture data, not live LLM calls | + +Checkpoint: prototype runs locally by opening `index.html` in a browser. + +### Step 5: Demo Walkthrough Guide + +Generate a presenter's guide in the prototype README with everything needed to deliver the demo. + +1. Step-by-step demo narrative from DT Coach session through prototype walkthrough. +2. Key talking points at each stage of the demo. +3. Which HVE Core features are showcased at each step: + - DT Coach agent and coaching state management + - Customer persona brief and conversation simulation + - Experiment cards and hypothesis-driven development + - hifi-prototype skill and scaffold generation + - Telemetry instrumentation +4. Common audience questions and suggested responses. +5. Timing guidance (approximate duration per section). + +Checkpoint: README contains a complete presenter's walkthrough guide. + +### Step 6: Demo Video Script + +Generate a `demo-video-script.md` in the prototype directory with a complete narrated video script for recording the demo. + +1. Follow the Demo Video Script Template section structure for the script layout. +2. Populate the Cold Open with a vivid scene showing the prototype in action and stating the persona's core pain point. +3. Write Section 1 (The Problem) using the customer persona brief: organization profile, frustrations, and the specific problem scenario. +4. Write Section 2 (Design Thinking Coach) walking through the DT artifacts generated in Step 3, highlighting coaching state persistence and artifact lineage. +5. Write Section 3 (The Experiment Card) narrating the hypothesis, success criteria, and failure criteria from the experiment card. +6. Write prototype demo sections (Sections 4 and 5) with screen-by-screen narration of the prototype workflow. Include visual cues in brackets describing what appears on screen and what the presenter clicks. +7. Write Section 6 (What You Just Saw) recapping the HVE Core tools demonstrated and their value. +8. Write Section 7 (Where to Start) introducing the three entry points: Task Researcher, RPI Agent, and DT Coach. Include a brief live demo prompt for each. +9. Write a Closing section and Production Notes table with recording setup details. +10. Target duration is 14 to 16 minutes. Distribute time across sections proportionally, with prototype demo sections receiving the most time. + +Checkpoint: `demo-video-script.md` exists with all sections populated and timing annotations. + +## Built-In Example Scenarios + +Two pre-built scenarios are available for immediate use without custom inputs. Each includes a complete persona brief with conversation seeds. + +The scenario slug names the DT coaching state directory under `.copilot-tracking/dt/`, while the prototype directory names the runnable code location in the workspace root. These are separate concerns: coaching artifacts and prototype code live in different trees. + +### Field Service AI (IFS SmartParts) + +| Field | Value | +|---|---| +| Industry | Field service management | +| Customer | IFS (enterprise software, 7000+ employees) | +| Persona | Marcus Ohlsson, field service technician | +| Problem | Technicians arrive at job sites without the correct replacement parts, causing return visits and customer dissatisfaction | +| Concept | AI agent analyzes failure history and peer evidence to suggest parts for the morning truck load | +| Slug | `ifs-smartparts` | +| Prototype directory | `ifs-smartparts-predict/` | +| Prototype | Smart Load List with IFS Loops agent suggestion cards and flywheel close-out screen | + +Reference files: `ifs-smartparts-predict/experiment-card.md`, `ifs-smartparts-predict/sim/fixtures/jobs.js` + +### Government Process Optimization (NYDoc Verify) + +| Field | Value | +|---|---| +| Industry | Government / corrections | +| Customer | NY State Department of Corrections | +| Persona | Unit Team counselor at Reception/Diagnostic Unit | +| Problem | Manual custody classification is slow and error-prone, with counselors spending over 20 minutes per inmate on scoring and data lookup | +| Concept | System pre-scores inmates with confidence indicators, counselor verifies rather than calculates from scratch | +| Slug | `nydoc-verify` | +| Prototype directory | `nydoc-verify-prototype/` | +| Prototype | Classification review screen with confidence indicators and housing pipeline board | + +Reference files: `nydoc-verify-prototype/experiment-card.md`, `nydoc-verify-prototype/sim/fixtures/inmates.js` + +## Demo Scaffold Template + +Every demo scaffold follows a fixed structure. The hifi-prototype skill generates this layout with demo-specific content. + +```text +{project-slug}/ +├── experiment-card.md +├── README.md +├── demo-video-script.md +├── index.html +├── style.css +├── app.js +├── telemetry.js +└── sim/fixtures/{domain-data}.js +``` + +### Fixed Elements (same across all demos) + +| Element | Details | +|---|---| +| Experiment banner | Visible on every page with hypothesis text | +| CSS reset | System fonts, 2-color palette, dashed borders, 44px touch targets | +| Rough UI constraints | No shadows, gradients, or custom fonts | +| Telemetry skeleton | Page views, clicks, task timing, session UUID | +| `[SIMULATED]` badges | Applied to every mock component | +| Experiment card | Hypothesis, success criteria, failure criteria, simulation inventory | +| Demo video script | Narrated walkthrough with visual cues, timing, and production notes | + +### Variable Elements (customized per demo) + +| Element | Varies By | +|---|---| +| Accent color | Industry or customer brand association | +| Layout | Screen count and workflow shape (1 to 5 screens max) | +| Fixture schema | Domain-specific data structure in `sim/fixtures/` | +| Domain terms | Industry vocabulary in labels, headings, and fixture data | +| Hypothesis text | Derived from DT session Method 3 themes | +| Success criteria | Derived from DT session Method 5 concepts | + +## Integration with HVE Core Tools + +Each step of the demo workflow showcases specific HVE Core tools and features. + +| Tool / Feature | Where Showcased | Demo Talking Point | +|---|---|---| +| DT Coach agent | Methods 1-6 coaching | AI-guided Design Thinking with structured method progression | +| Customer persona brief | Step 1 scenario setup | Simulated customer conversations grounded in realistic personas | +| Coaching state management | Session persistence across methods | Session recovery, method tracking, and artifact lineage | +| hifi-prototype skill | Method 7 scaffold generation | Experiment-framed prototypes with hypothesis-driven development | +| Experiment cards | Prototype setup | Every prototype starts with a falsifiable hypothesis | +| Telemetry instrumentation | Prototype scaffold | Measurement built in from day one, not added later | +| Canonical deck (optional) | Method 1, 3, and 5 snapshots | Visual summaries at scope, synthesis, and concept milestones | + +## Validation + +- [ ] Customer persona brief exists and all sections are populated +- [ ] DT coaching state initialized with `initial_classification: frozen` and `session_mode: demo` +- [ ] Methods 1 through 6 have generated artifacts +- [ ] Experiment card has a falsifiable hypothesis and measurable success criteria +- [ ] Prototype scaffold runs locally by opening `index.html` +- [ ] Telemetry captures page views, clicks, and task timing +- [ ] README contains a complete presenter's walkthrough guide +- [ ] Demo video script exists with all sections, visual cues, and timing annotations +- [ ] All simulated components display `[SIMULATED]` badges +- [ ] Experiment banner visible on every prototype page +- [ ] Built-in example scenarios execute without errors when selected + +## Troubleshooting + +| Issue | Cause | Solution | +|---|---|---| +| Persona brief feels generic | Insufficient industry context provided | Add specific domain vocabulary and 3 to 5 concrete workflow details to the inputs | +| DT Coach exits accelerated mode | Coaching state missing `session_mode: demo` | Verify coaching-state.md has `session_mode: demo` under the project block in Step 2 | +| Prototype scaffold missing telemetry | hifi-prototype skill not invoked correctly | Ensure the experiment card is complete before triggering Method 7 transition | +| Audience confuses demo with real product | Missing simulation labels | Every mock component requires a visible `[SIMULATED]` badge; check the validation list | +| Demo takes too long to present | Full coaching mode active | Set `accelerated` input to `true` (default) for 2 to 3 exchanges per method | +| Fixture data does not match domain | Conversation seeds missing domain vocabulary | Update the Domain Vocabulary section of the persona brief before starting the session | +| Demo video script too long | Too many prototype screens narrated | Limit prototype demo to 2 to 3 key screens; reference additional screens briefly without full narration | +| Video script feels disconnected from prototype | Script written before scaffold finalized | Generate the video script after Step 5 completes so all prototype screens and the README are available as source material | + +## Demo Video Script Template + +The demo video script follows a fixed section structure. Each section includes narrator text (blockquoted) and visual stage directions (bracketed). The template reference is `demos/contoso/order-intake/demo-video-script.md`. + +### Script Structure + +| Section | Duration | Content | +|---|---|---| +| Video Details | — | Metadata table: title, subtitle, target duration, audience, tone | +| Cold Open | 0:30 | Show the running prototype; narrate the persona's pain in their own words | +| Section 1: The Problem | 1:30 | Walk through the persona brief on screen; highlight frustrations and the specific scenario | +| Section 2: Design Thinking Coach | 2:30 | Show the DT artifacts directory; narrate key method outputs and coaching state | +| Section 3: The Experiment Card | 1:00 | Open the experiment card; narrate hypothesis, success criteria, and failure criteria | +| Section 4+: Prototype Demo | 4:00 | Screen-by-screen narration of the prototype; one section per major screen | +| What You Just Saw | 1:30 | Recap the five HVE Core capabilities demonstrated | +| Where to Start | 4:00 | Three entry points with live demo prompts for Task Researcher, RPI Agent, and DT Coach | +| Closing | 0:30 | Summary statement and call to action | +| Production Notes | — | Recording setup table: tool, browser, theme, font size, resolution, pre-recording steps | + +### Section Authoring Rules + +* Visual cues appear in `**[VISUAL: description]**` format before the narrator text they accompany. +* Narrator text uses blockquote format (`>`) for spoken words. +* Demo prompts (text the presenter types on screen) appear in a dedicated code block labeled with the prompt context. +* Each prototype demo section covers one screen of the prototype. Name the section after the screen (for example, "Order Queue Demo" or "Classification Review Demo"). +* Timing annotations appear in parentheses in each section heading (for example, `## COLD OPEN (0:00 - 0:30)`). +* The "Where to Start" section includes three subsections, one per agent, each with a typed prompt and narration of the agent's response. +* Production Notes table includes at minimum: screen recording tool, browser, VS Code theme, font size, resolution, and any pre-recording reset steps (for example, clearing localStorage). + +### Content Derivation + +| Script Section | Source Artifact | +|---|---| +| Cold Open scene | Prototype `index.html` primary screen | +| The Problem narration | Customer persona brief: frustrations, problem scenario, constraints | +| DT Coach walkthrough | `.copilot-tracking/dt/{slug}/` artifact directory and coaching-state.md | +| Experiment Card | `experiment-card.md` hypothesis and criteria | +| Prototype Demo screens | Each `.html` file in the scaffold, walked through in workflow order | +| What You Just Saw | Integration with HVE Core Tools table from this skill | +| Where to Start | Standard three-agent intro: Task Researcher, RPI Agent, DT Coach | + +> Brought to you by microsoft/hve-core diff --git a/collections/design-thinking.collection.md b/collections/design-thinking.collection.md index dca7f9028..64a6bdeb8 100644 --- a/collections/design-thinking.collection.md +++ b/collections/design-thinking.collection.md @@ -15,6 +15,12 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **dt-coach** | Design Thinking coach guiding teams through the 9-method HVE framework with Think/Speak/Empower philosophy | | **dt-learning-tutor** | Design Thinking learning tutor providing structured curriculum, comprehension checks, and adaptive pacing | +### Skills + +| Name | Description | +|----------------|-----------------------------------------------------------------------------------------------------------------------------------| +| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | + ### Prompts | Name | Description | diff --git a/collections/design-thinking.collection.yml b/collections/design-thinking.collection.yml index f9cedd74e..287a6516a 100644 --- a/collections/design-thinking.collection.yml +++ b/collections/design-thinking.collection.yml @@ -16,6 +16,11 @@ items: kind: agent maturity: preview + # Skills + - path: .github/skills/design-thinking/demo-setup + kind: skill + maturity: preview + # Prompts - path: .github/prompts/design-thinking/dt-start-project.prompt.md kind: prompt From b86f4de0292edd0dbc0435f43df74046be0e1128 Mon Sep 17 00:00:00 2001 From: Emmeline Hoops <108825895+chaosdinosaur@users.noreply.github.com> Date: Fri, 22 May 2026 14:51:18 +0000 Subject: [PATCH 2/6] refactor(skills): remove built-in scenarios from demo-setup skill Remove IFS SmartParts and NYDoc Verify built-in example scenarios from the demo-setup SKILL.md. Demos now run exclusively from user-provided customer, industry, persona, and problem inputs. Commit the demo-video-script-template.md reference file that the skill loads during Step 6. --- .../design-thinking/demo-setup/SKILL.md | 60 +---- .../references/demo-video-script-template.md | 219 ++++++++++++++++++ 2 files changed, 229 insertions(+), 50 deletions(-) create mode 100644 .github/skills/design-thinking/demo-setup/references/demo-video-script-template.md diff --git a/.github/skills/design-thinking/demo-setup/SKILL.md b/.github/skills/design-thinking/demo-setup/SKILL.md index 6acca022f..0eb366c1a 100644 --- a/.github/skills/design-thinking/demo-setup/SKILL.md +++ b/.github/skills/design-thinking/demo-setup/SKILL.md @@ -23,7 +23,6 @@ Core design constraints: * The hifi-prototype skill handles all scaffold generation and experiment framing. * Presenter's guide included so demos are repeatable without memorizing the flow. * Demo video script generated for recording a polished walkthrough video. -* Built-in example scenarios available for immediate use without custom input. ## Prerequisites @@ -33,10 +32,10 @@ Core design constraints: ## Quick Start -Run a demo with a built-in scenario: +Run a demo with custom inputs: -1. Invoke `/demo-setup` with `customer=IFS`, `industry=field service`, `scenario=ifs-smartparts`. -2. The DT Coach walks through Methods 1 through 6 with a pre-built persona and conversation seeds. +1. Invoke `/demo-setup` with `customer={name}`, `industry={vertical}`, and optionally `persona` and `problem`. +2. The DT Coach walks through Methods 1 through 6 with a generated persona and conversation seeds. 3. At Method 7 the hifi-prototype skill scaffolds a runnable prototype. 4. Open `index.html` in a browser and follow the presenter's guide in `README.md`. @@ -62,7 +61,6 @@ Run a demo with a built-in scenario: | `industry` | Yes | Industry vertical (field service, government, healthcare, manufacturing, energy) | | `persona` | No | End-user persona name and role. Generated from customer and industry context when omitted | | `problem` | No | Brief problem statement. Inferred from industry patterns when omitted | -| `scenario` | No | Built-in scenario key (`ifs-smartparts`, `nydoc-verify`) or `custom` for user-provided context. Defaults to `custom` | | `accelerated` | No | Whether to use accelerated DT method pacing for demo purposes. Defaults to `true` | ## Customer Persona Brief Template @@ -131,13 +129,12 @@ Follow the six-step workflow to set up a complete HVE Core demo. Each step build ### Step 1: Define Customer Scenario -Accept customer context from user inputs or let them select a built-in example scenario. +Accept customer context from user inputs and generate the persona brief. -1. If `scenario` matches a built-in example, generate the persona brief from the built-in example data in the Built-In Example Scenarios section. -2. If custom inputs are provided, generate a Customer Persona Brief from the `customer`, `industry`, `persona`, and `problem` inputs. -3. Fill all sections of the Customer Persona Brief Template, including conversation seeds tailored to the industry and problem. -4. Derive the project slug: for built-in scenarios, use the scenario key as the slug (for example, `ifs-smartparts` or `nydoc-verify`). For custom scenarios, strip all characters except letters, digits, and spaces from the customer name, collapse consecutive spaces, then lowercase and replace spaces with hyphens (for example, `Contoso Manufacturing` becomes `contoso-manufacturing`, `O'Brien & Co.` becomes `obrien-co`). If the resulting slug is empty, prompt the user for a valid customer name. -5. Save the brief to `.copilot-tracking/dt/{project-slug}/context/customer-persona-brief.md` using the project slug derived above. +1. Generate a Customer Persona Brief from the `customer`, `industry`, `persona`, and `problem` inputs. +2. Fill all sections of the Customer Persona Brief Template, including conversation seeds tailored to the industry and problem. +3. Derive the project slug from the customer name: strip all characters except letters, digits, and spaces, collapse consecutive spaces, then lowercase and replace spaces with hyphens (for example, `Contoso Manufacturing` becomes `contoso-manufacturing`, `O'Brien & Co.` becomes `obrien-co`). If the resulting slug is empty, prompt the user for a valid customer name. +4. Save the brief to `.copilot-tracking/dt/{project-slug}/context/customer-persona-brief.md` using the project slug derived above. Checkpoint: persona brief exists with all sections populated. @@ -237,42 +234,6 @@ Generate a `demo-video-script.md` in the prototype directory with a complete nar Checkpoint: `demo-video-script.md` exists with all sections populated and timing annotations. -## Built-In Example Scenarios - -Two pre-built scenarios are available for immediate use without custom inputs. Each includes a complete persona brief with conversation seeds. - -The scenario slug names the DT coaching state directory under `.copilot-tracking/dt/`, while the prototype directory names the runnable code location in the workspace root. These are separate concerns: coaching artifacts and prototype code live in different trees. - -### Field Service AI (IFS SmartParts) - -| Field | Value | -|---|---| -| Industry | Field service management | -| Customer | IFS (enterprise software, 7000+ employees) | -| Persona | Marcus Ohlsson, field service technician | -| Problem | Technicians arrive at job sites without the correct replacement parts, causing return visits and customer dissatisfaction | -| Concept | AI agent analyzes failure history and peer evidence to suggest parts for the morning truck load | -| Slug | `ifs-smartparts` | -| Prototype directory | `ifs-smartparts-predict/` | -| Prototype | Smart Load List with IFS Loops agent suggestion cards and flywheel close-out screen | - -Reference files: `ifs-smartparts-predict/experiment-card.md`, `ifs-smartparts-predict/sim/fixtures/jobs.js` - -### Government Process Optimization (NYDoc Verify) - -| Field | Value | -|---|---| -| Industry | Government / corrections | -| Customer | NY State Department of Corrections | -| Persona | Unit Team counselor at Reception/Diagnostic Unit | -| Problem | Manual custody classification is slow and error-prone, with counselors spending over 20 minutes per inmate on scoring and data lookup | -| Concept | System pre-scores inmates with confidence indicators, counselor verifies rather than calculates from scratch | -| Slug | `nydoc-verify` | -| Prototype directory | `nydoc-verify-prototype/` | -| Prototype | Classification review screen with confidence indicators and housing pipeline board | - -Reference files: `nydoc-verify-prototype/experiment-card.md`, `nydoc-verify-prototype/sim/fixtures/inmates.js` - ## Demo Scaffold Template Every demo scaffold follows a fixed structure. The hifi-prototype skill generates this layout with demo-specific content. @@ -338,7 +299,6 @@ Each step of the demo workflow showcases specific HVE Core tools and features. - [ ] Demo video script exists with all sections, visual cues, and timing annotations - [ ] All simulated components display `[SIMULATED]` badges - [ ] Experiment banner visible on every prototype page -- [ ] Built-in example scenarios execute without errors when selected ## Troubleshooting @@ -355,7 +315,7 @@ Each step of the demo workflow showcases specific HVE Core tools and features. ## Demo Video Script Template -The demo video script follows a fixed section structure. Each section includes narrator text (blockquoted) and visual stage directions (bracketed). The template reference is `demos/contoso/order-intake/demo-video-script.md`. +The demo video script follows a fixed section structure. Each section includes narrator text (blockquoted) and visual stage directions (bracketed). The template reference is `references/demo-video-script-template.md`. ### Script Structure @@ -377,7 +337,7 @@ The demo video script follows a fixed section structure. Each section includes n * Visual cues appear in `**[VISUAL: description]**` format before the narrator text they accompany. * Narrator text uses blockquote format (`>`) for spoken words. * Demo prompts (text the presenter types on screen) appear in a dedicated code block labeled with the prompt context. -* Each prototype demo section covers one screen of the prototype. Name the section after the screen (for example, "Order Queue Demo" or "Classification Review Demo"). +* Each prototype demo section covers one screen of the prototype. Name the section after the screen (for example, "Order Queue Demo" or "Dashboard Demo"). * Timing annotations appear in parentheses in each section heading (for example, `## COLD OPEN (0:00 - 0:30)`). * The "Where to Start" section includes three subsections, one per agent, each with a typed prompt and narration of the agent's response. * Production Notes table includes at minimum: screen recording tool, browser, VS Code theme, font size, resolution, and any pre-recording reset steps (for example, clearing localStorage). diff --git a/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md b/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md new file mode 100644 index 000000000..505beeff2 --- /dev/null +++ b/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md @@ -0,0 +1,219 @@ +--- +title: Demo Video Script Template +description: Reusable template for HVE Core demo video scripts with section structure, visual cue format, and timing guidance +--- + +## Video Details + +| Field | Value | +|------------------|--------------------------------------------------------------------------------| +| Title | {{title — action-oriented statement about the demo outcome}} | +| Subtitle | HVE Core Design Thinking + Prototyping Workflow | +| Target duration | 14-16 minutes | +| Audience | {{audience — who will watch this recording}} | +| Tone | Conversational, confident, practitioner-to-practitioner | + +--- + +## COLD OPEN (0:00 - 0:30) + +**[VISUAL: Browser showing the prototype primary screen with key UI elements visible]** + +> {{Vivid description of the persona's daily pain in their own words. Show the running prototype as the backdrop. End with a hook: "We built this in under an hour using two HVE Core tools. Let me show you how."}} + +--- + +## SECTION 1: THE PROBLEM (0:30 - 2:00) + +**[VISUAL: VS Code, open to `customer-persona-brief.md`, scrolling through the Organization and Persona Profile sections]** + +> {{Introduce the persona: name, role, organization, scale. Ground the viewer in who this person is and what their day looks like.}} + +**[VISUAL: Highlight the "Frustrations" section of the persona brief]** + +> {{Walk through the top 3 frustrations. Be specific with numbers, names, and workflow details.}} + +**[VISUAL: Highlight the "Problem Scenario" section]** + +> {{Narrate one concrete instance of the problem occurring. Include the cascading consequences.}} + +**[VISUAL: Cut to the problem statement in `method-03-problem-statement.md`]** + +> {{State the problem statement as synthesized by the DT Coach. Frame it as a question: "Can [proposed solution] change that?"}} + +--- + +## SECTION 2: DESIGN THINKING COACH (2:00 - 4:30) + +**[VISUAL: VS Code file explorer showing the `.copilot-tracking/dt/{slug}/` directory with all method artifacts visible]** + +> {{Introduce the DT Coach: "Before writing any code, we ran a Design Thinking coaching session." Mention methods 1-6 and structured artifacts.}} + +**[VISUAL: Open `method-01-stakeholder-map.md`]** + +> {{Method 1 highlight: Who are the stakeholders? What insight emerged from mapping them?}} + +**[VISUAL: Open `coaching-state.md`, highlight the transition log]** + +> {{Coaching state persistence: session recovery, method tracking, artifact lineage. "If I close VS Code and come back tomorrow, the DT Coach picks up exactly where we left off."}} + +**[VISUAL: Open `method-03-theme-clusters.md`]** + +> {{Method 3 highlight: What themes emerged from synthesis? List 2-3 key themes with evidence.}} + +**[VISUAL: Open `method-05-concept-cards.md`, show the D/F/V summary table]** + +> {{Method 5 highlight: Desirability, feasibility, viability assessment. What was the verdict?}} + +**[VISUAL: Brief pause on the full `.copilot-tracking/dt/{slug}/` file tree]** + +> {{Summary: "Six methods. Ten artifacts. A validated problem, a testable hypothesis, and a clear concept. All before a single line of prototype code."}} + +--- + +## SECTION 3: THE EXPERIMENT CARD (4:30 - 5:30) + +**[VISUAL: Open `experiment-card.md` in VS Code]** + +> {{Introduce the experiment card concept: "This is not a requirements doc. It is a hypothesis with explicit success and failure criteria."}} + +**[VISUAL: Highlight the hypothesis]** + +> {{Read the hypothesis verbatim or paraphrase closely.}} + +**[VISUAL: Highlight the success criteria table]** + +> {{Walk through 2-3 key success criteria that are observable and measurable.}} + +**[VISUAL: Highlight the failure criteria]** + +> {{Explain what would prove the hypothesis wrong. "A good experiment is falsifiable."}} + +--- + +## SECTION 4: PROTOTYPE DEMO — PRIMARY SCREEN (5:30 - 7:30) + +**[VISUAL: Browser, `index.html` — primary screen visible]** + +> {{Describe the persona's new workflow. Narrate what each UI element means and how it maps to the problem statement.}} + +**[VISUAL: Interact with the primary screen — click buttons, hover elements, show state changes]** + +> {{Walk through 2-3 key interactions. Show the happy path first, then edge cases with lower confidence or flagged items.}} + +**[VISUAL: Point out the experiment banner and [SIMULATED] badges]** + +> {{Acknowledge the prototype constraints: "The simulated badge reminds us this is a prototype. The real architecture would [describe production approach]. But the prototype proved the workflow works before we invest."}} + +--- + +## SECTION 5: PROTOTYPE DEMO — SECONDARY SCREEN (7:30 - 9:30) + +**[VISUAL: Browser, secondary screen (e.g., review, pipeline, closeout)]** + +> {{Describe the second key screen. What does it show? How does the persona use it?}} + +**[VISUAL: Walk through the interaction flow on this screen]** + +> {{Narrate the specific interactions: approvals, overrides, confirmations. Show how the persona completes their core task.}} + +**[VISUAL: Show completion state or confirmation]** + +> {{Describe the endpoint: "The task is complete. The [action] is confirmed."}} + +--- + +## SECTION 6: WHAT YOU JUST SAW (9:30 - 11:00) + +> Let me recap what we covered. + +> First, the DT Coach agent. It guided us through six Design Thinking methods with a simulated customer persona. Every method produced a structured artifact. Those artifacts are reusable. They are the institutional memory of the design process. + +> Second, coaching state management. The session is persistent. You can close VS Code, come back next week, and the coach picks up where you left off. Method progress, artifact lineage, transition rationale: all tracked. + +> Third, the experiment card. Every prototype starts with a hypothesis written before any code. Success criteria you can observe. Failure criteria that tell you when to pivot. This is not a feature backlog. It is a falsifiable experiment. + +> Fourth, the prototype skill. It generated the scaffold in minutes. Intentionally rough UI so stakeholders react to the workflow, not the colors. Simulated badges on every mock component so nobody confuses this with a product. + +> And fifth, telemetry from day one. Page views, clicks, task timing, session IDs. When you run this prototype with real users, you get measurement data automatically. + +> The whole thing runs by opening a single HTML file. No servers, no cloud accounts, no API keys. + +--- + +## SECTION 7: WHERE TO START (11:00 - 15:00) + +**[VISUAL: VS Code command palette or agent selector showing the three agents]** + +> So you have seen the workflow end to end. The natural question is: where do I start? HVE Core gives you three entry points depending on where you are in your work. + +### Task Researcher Demo (11:00 - 12:30) + +**[VISUAL: VS Code with the Task Researcher agent active]** + +> If you are joining an existing project or picking up unfamiliar code, start with the **Task Researcher**. Point it at a codebase and it maps the architecture, identifies patterns, surfaces dependencies, and answers your questions grounded in what is actually there. + +**[DEMO: Ask the Task Researcher]** + +Prompt to type: + +> "I just opened this repo for the first time. Give me a technical overview — what does this project do, what's the tech stack, how is it organized, and where should I start if I want to add a new {{domain feature}}?" + +**[VISUAL: Watch the Task Researcher read files, scan directories, and synthesize a structured overview.]** + +> {{Narrate what the researcher does and the quality of its grounded output.}} + +### RPI Agent Demo (12:30 - 14:00) + +**[VISUAL: VS Code with rpi-agent active]** + +> When you are ready to build, reach for the **RPI Agent**. RPI stands for Research, Plan, Implement. It breaks your task into phases: the researcher gathers context, the planner writes a step-by-step implementation plan, and the implementor executes each phase. + +**[DEMO: Ask the RPI Agent]** + +Prompt to type: + +> "Add a telemetry dashboard page (telemetry-dashboard.html) that reads captured events from localStorage and visualizes: {{2-3 metrics relevant to the prototype's experiment card}}." + +**[VISUAL: Watch the RPI agent research, plan, and implement. Show the finished dashboard.]** + +> {{Narrate the three phases and the final result.}} + +### DT Coach Recap (14:00 - 14:30) + +**[VISUAL: VS Code with DT Coach agent active]** + +> And if you are starting from scratch, that is where the **DT Coach** comes in. It walks you through Design Thinking methods to make sure you are solving the right problem before you build anything. + +> One more thing. In this demo we used a generated persona brief to simulate the customer conversations. But in real engagements, you feed it real context. Drop a meeting transcript into the `context/` folder and the coach grounds its coaching in what was actually said. + +### Connecting the Three (14:30 - 15:00) + +**[VISUAL: Simple diagram or text overlay showing the three agents]** + +> Three starting points. Exploring existing code? Task Researcher. Building the next feature? RPI Agent. Validating a new idea from scratch? DT Coach. They work independently, but they also connect. The DT Coach's experiment card feeds the RPI Agent's planning. The Task Researcher grounds both of them in what is actually in the codebase. + +--- + +## CLOSING (15:00 - 15:30) + +**[VISUAL: VS Code showing the full `.copilot-tracking/dt/{slug}/` directory alongside the prototype files]** + +> {{Summarize the journey: persona to prototype. Name the key tools. Invite the viewer to try with their own scenario.}} + +> Thanks for watching. + +--- + +## Production Notes + +| Item | Detail | +|----------------------|---------------------------------------------------------------------------| +| Screen recording tool | OBS or VS Code screen recorder extension | +| Browser | Chrome with DevTools closed, zoom at 100% | +| VS Code theme | Default dark or light — keep it familiar | +| Font size | VS Code editor font 14px minimum for readability | +| Resolution | 1920x1080 or 2560x1440 | +| localStorage | Run `localStorage.clear()` in DevTools before each take | +| Pauses | Leave 1-2 second pauses at section transitions for editing | +| B-roll opportunities | File explorer navigation, coaching state YAML scrolling, status bar updates | From b15a398e6d27f92d624f1927418cb1978c8bf267 Mon Sep 17 00:00:00 2001 From: Emmeline Hoops <108825895+chaosdinosaur@users.noreply.github.com> Date: Fri, 22 May 2026 14:55:20 +0000 Subject: [PATCH 3/6] refactor(skills): move demo video script template detail to references Move Script Structure, Section Authoring Rules, and Content Derivation tables from demo-setup SKILL.md into references/demo-video-script-template.md to follow progressive disclosure guidance. SKILL.md retains a brief pointer to the template reference. --- .../design-thinking/demo-setup/SKILL.md | 39 +---------------- .../references/demo-video-script-template.md | 43 +++++++++++++++++++ 2 files changed, 44 insertions(+), 38 deletions(-) diff --git a/.github/skills/design-thinking/demo-setup/SKILL.md b/.github/skills/design-thinking/demo-setup/SKILL.md index 0eb366c1a..b1aa1d18d 100644 --- a/.github/skills/design-thinking/demo-setup/SKILL.md +++ b/.github/skills/design-thinking/demo-setup/SKILL.md @@ -315,43 +315,6 @@ Each step of the demo workflow showcases specific HVE Core tools and features. ## Demo Video Script Template -The demo video script follows a fixed section structure. Each section includes narrator text (blockquoted) and visual stage directions (bracketed). The template reference is `references/demo-video-script-template.md`. - -### Script Structure - -| Section | Duration | Content | -|---|---|---| -| Video Details | — | Metadata table: title, subtitle, target duration, audience, tone | -| Cold Open | 0:30 | Show the running prototype; narrate the persona's pain in their own words | -| Section 1: The Problem | 1:30 | Walk through the persona brief on screen; highlight frustrations and the specific scenario | -| Section 2: Design Thinking Coach | 2:30 | Show the DT artifacts directory; narrate key method outputs and coaching state | -| Section 3: The Experiment Card | 1:00 | Open the experiment card; narrate hypothesis, success criteria, and failure criteria | -| Section 4+: Prototype Demo | 4:00 | Screen-by-screen narration of the prototype; one section per major screen | -| What You Just Saw | 1:30 | Recap the five HVE Core capabilities demonstrated | -| Where to Start | 4:00 | Three entry points with live demo prompts for Task Researcher, RPI Agent, and DT Coach | -| Closing | 0:30 | Summary statement and call to action | -| Production Notes | — | Recording setup table: tool, browser, theme, font size, resolution, pre-recording steps | - -### Section Authoring Rules - -* Visual cues appear in `**[VISUAL: description]**` format before the narrator text they accompany. -* Narrator text uses blockquote format (`>`) for spoken words. -* Demo prompts (text the presenter types on screen) appear in a dedicated code block labeled with the prompt context. -* Each prototype demo section covers one screen of the prototype. Name the section after the screen (for example, "Order Queue Demo" or "Dashboard Demo"). -* Timing annotations appear in parentheses in each section heading (for example, `## COLD OPEN (0:00 - 0:30)`). -* The "Where to Start" section includes three subsections, one per agent, each with a typed prompt and narration of the agent's response. -* Production Notes table includes at minimum: screen recording tool, browser, VS Code theme, font size, resolution, and any pre-recording reset steps (for example, clearing localStorage). - -### Content Derivation - -| Script Section | Source Artifact | -|---|---| -| Cold Open scene | Prototype `index.html` primary screen | -| The Problem narration | Customer persona brief: frustrations, problem scenario, constraints | -| DT Coach walkthrough | `.copilot-tracking/dt/{slug}/` artifact directory and coaching-state.md | -| Experiment Card | `experiment-card.md` hypothesis and criteria | -| Prototype Demo screens | Each `.html` file in the scaffold, walked through in workflow order | -| What You Just Saw | Integration with HVE Core Tools table from this skill | -| Where to Start | Standard three-agent intro: Task Researcher, RPI Agent, DT Coach | +The demo video script follows a fixed section structure with narrator text (blockquoted) and visual stage directions (bracketed). See `references/demo-video-script-template.md` for the full template, section-by-section script structure, authoring rules, and content derivation guidance. Copy that file to the prototype directory as `demo-video-script.md` in Step 6 and fill in the placeholders. > Brought to you by microsoft/hve-core diff --git a/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md b/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md index 505beeff2..6f288cd86 100644 --- a/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md +++ b/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md @@ -3,6 +3,49 @@ title: Demo Video Script Template description: Reusable template for HVE Core demo video scripts with section structure, visual cue format, and timing guidance --- +## How to Use This Template + +This template provides both the structural reference for authoring a demo video script and a fillable scaffold. Copy this file to the prototype directory as `demo-video-script.md`, then replace the `{{placeholder}}` text with content derived from the customer persona brief, DT artifacts, experiment card, and prototype screens. + +### Script Structure + +| Section | Duration | Content | +|---|---|---| +| Video Details | — | Metadata table: title, subtitle, target duration, audience, tone | +| Cold Open | 0:30 | Show the running prototype; narrate the persona's pain in their own words | +| Section 1: The Problem | 1:30 | Walk through the persona brief on screen; highlight frustrations and the specific scenario | +| Section 2: Design Thinking Coach | 2:30 | Show the DT artifacts directory; narrate key method outputs and coaching state | +| Section 3: The Experiment Card | 1:00 | Open the experiment card; narrate hypothesis, success criteria, and failure criteria | +| Section 4+: Prototype Demo | 4:00 | Screen-by-screen narration of the prototype; one section per major screen | +| What You Just Saw | 1:30 | Recap the five HVE Core capabilities demonstrated | +| Where to Start | 4:00 | Three entry points with live demo prompts for Task Researcher, RPI Agent, and DT Coach | +| Closing | 0:30 | Summary statement and call to action | +| Production Notes | — | Recording setup table: tool, browser, theme, font size, resolution, pre-recording steps | + +### Section Authoring Rules + +* Visual cues appear in `**[VISUAL: description]**` format before the narrator text they accompany. +* Narrator text uses blockquote format (`>`) for spoken words. +* Demo prompts (text the presenter types on screen) appear in a dedicated code block labeled with the prompt context. +* Each prototype demo section covers one screen of the prototype. Name the section after the screen (for example, "Order Queue Demo" or "Dashboard Demo"). +* Timing annotations appear in parentheses in each section heading (for example, `## COLD OPEN (0:00 - 0:30)`). +* The "Where to Start" section includes three subsections, one per agent, each with a typed prompt and narration of the agent's response. +* Production Notes table includes at minimum: screen recording tool, browser, VS Code theme, font size, resolution, and any pre-recording reset steps (for example, clearing localStorage). + +### Content Derivation + +| Script Section | Source Artifact | +|---|---| +| Cold Open scene | Prototype `index.html` primary screen | +| The Problem narration | Customer persona brief: frustrations, problem scenario, constraints | +| DT Coach walkthrough | `.copilot-tracking/dt/{slug}/` artifact directory and coaching-state.md | +| Experiment Card | `experiment-card.md` hypothesis and criteria | +| Prototype Demo screens | Each `.html` file in the scaffold, walked through in workflow order | +| What You Just Saw | Integration with HVE Core Tools table from the demo-setup skill | +| Where to Start | Standard three-agent intro: Task Researcher, RPI Agent, DT Coach | + +--- + ## Video Details | Field | Value | From fe7e648c3a40a1f4a606754f13a0d54490298458 Mon Sep 17 00:00:00 2001 From: Emmeline Hoops <108825895+chaosdinosaur@users.noreply.github.com> Date: Fri, 22 May 2026 14:59:09 +0000 Subject: [PATCH 4/6] chore(skills): tidy stale wording in demo-setup SKILL.md - Update workflow table Step 1 description to reflect input-driven flow - Point Step 6 directly to references template - Bump last_updated to 2026-05-22 --- .github/skills/design-thinking/demo-setup/SKILL.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/skills/design-thinking/demo-setup/SKILL.md b/.github/skills/design-thinking/demo-setup/SKILL.md index b1aa1d18d..7cf75a6e5 100644 --- a/.github/skills/design-thinking/demo-setup/SKILL.md +++ b/.github/skills/design-thinking/demo-setup/SKILL.md @@ -5,7 +5,7 @@ user-invocable: true metadata: authors: "microsoft/hve-core" spec_version: "1.0" - last_updated: "2026-05-11" + last_updated: "2026-05-22" --- # Demo Setup @@ -120,7 +120,7 @@ Follow the six-step workflow to set up a complete HVE Core demo. Each step build | Step | Name | Purpose | |---|---|---| -| 1 | Define Customer Scenario | Accept or generate the customer context and persona brief | +| 1 | Define Customer Scenario | Generate the customer context and persona brief from user inputs | | 2 | Initialize DT Coach Session | Create project structure and start the coaching session | | 3 | Guided DT Methods 1-6 | Accelerated coaching with simulated customer conversations | | 4 | Prototype Scaffold | Transition to Method 7 and generate the runnable prototype | @@ -221,7 +221,7 @@ Checkpoint: README contains a complete presenter's walkthrough guide. Generate a `demo-video-script.md` in the prototype directory with a complete narrated video script for recording the demo. -1. Follow the Demo Video Script Template section structure for the script layout. +1. Follow the structure in `references/demo-video-script-template.md` for the script layout. 2. Populate the Cold Open with a vivid scene showing the prototype in action and stating the persona's core pain point. 3. Write Section 1 (The Problem) using the customer persona brief: organization profile, frustrations, and the specific problem scenario. 4. Write Section 2 (Design Thinking Coach) walking through the DT artifacts generated in Step 3, highlighting coaching state persistence and artifact lineage. From 0e0eb2de54aa41ce6ae411a0fe86195b4f985b50 Mon Sep 17 00:00:00 2001 From: Emmeline Hoops <108825895+chaosdinosaur@users.noreply.github.com> Date: Tue, 26 May 2026 16:51:53 +0000 Subject: [PATCH 5/6] feat(skills): add demo-setup skill and update related documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - introduce demo-setup skill for simulating DT Coach sessions - update README and collection files to include demo-setup details - refine demo video script template with new attribution 🤖 - Generated by Copilot --- .github/skills/design-thinking/demo-setup/SKILL.md | 4 ++++ .../references/demo-video-script-template.md | 5 +++++ collections/design-thinking.collection.md | 12 ++++++------ collections/hve-core-all.collection.md | 1 + collections/hve-core-all.collection.yml | 3 +++ plugins/design-thinking/.github/plugin/plugin.json | 3 +++ plugins/design-thinking/README.md | 12 ++++++++++++ plugins/hve-core-all/.github/plugin/plugin.json | 1 + plugins/hve-core-all/README.md | 1 + 9 files changed, 36 insertions(+), 6 deletions(-) diff --git a/.github/skills/design-thinking/demo-setup/SKILL.md b/.github/skills/design-thinking/demo-setup/SKILL.md index 7cf75a6e5..973d01fba 100644 --- a/.github/skills/design-thinking/demo-setup/SKILL.md +++ b/.github/skills/design-thinking/demo-setup/SKILL.md @@ -318,3 +318,7 @@ Each step of the demo workflow showcases specific HVE Core tools and features. The demo video script follows a fixed section structure with narrator text (blockquoted) and visual stage directions (bracketed). See `references/demo-video-script-template.md` for the full template, section-by-section script structure, authoring rules, and content derivation guidance. Copy that file to the prototype directory as `demo-video-script.md` in Step 6 and fill in the placeholders. > Brought to you by microsoft/hve-core + +--- + +*🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.* diff --git a/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md b/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md index 6f288cd86..c5399157a 100644 --- a/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md +++ b/.github/skills/design-thinking/demo-setup/references/demo-video-script-template.md @@ -260,3 +260,8 @@ Prompt to type: | localStorage | Run `localStorage.clear()` in DevTools before each take | | Pauses | Leave 1-2 second pauses at section transitions for editing | | B-roll opportunities | File explorer navigation, coaching state YAML scrolling, status bar updates | + + +--- + +*🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.* diff --git a/collections/design-thinking.collection.md b/collections/design-thinking.collection.md index 64a6bdeb8..ece62387f 100644 --- a/collections/design-thinking.collection.md +++ b/collections/design-thinking.collection.md @@ -15,12 +15,6 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **dt-coach** | Design Thinking coach guiding teams through the 9-method HVE framework with Think/Speak/Empower philosophy | | **dt-learning-tutor** | Design Thinking learning tutor providing structured curriculum, comprehension checks, and adaptive pacing | -### Skills - -| Name | Description | -|----------------|-----------------------------------------------------------------------------------------------------------------------------------| -| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | - ### Prompts | Name | Description | @@ -90,4 +84,10 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **design-thinking/dt-subagent-handoff** | DT subagent handoff workflow: readiness assessment, artifact compilation, and handoff validation via subagent dispatch | | **shared/hve-core-location** | Important: hve-core is the repository containing this instruction file; Guidance: if a referenced prompt, instructions, agent, or script is missing in the current directory, fall back to this hve-core location by walking up this file's directory tree. | +### Skills + +| Name | Description | +|----------------|-------------------------------------------------------------------------------------------------------------------------| +| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | + diff --git a/collections/hve-core-all.collection.md b/collections/hve-core-all.collection.md index dbc9553f5..1cb2b5d84 100644 --- a/collections/hve-core-all.collection.md +++ b/collections/hve-core-all.collection.md @@ -261,6 +261,7 @@ Use this edition when you want access to everything without choosing a focused c | Name | Description | |-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **customer-card-render** | Generate customer-card PowerPoint content YAML from Design Thinking canonical artifacts and build using the shared PowerPoint skill pipeline | +| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | | **gh-code-scanning** | Retrieves and groups GitHub code scanning alerts by rule and severity using the gh CLI | | **gitlab** | Manage GitLab merge requests and pipelines with a Python CLI | | **hve-core-installer** | Decision-driven installer for HVE-Core with 6 clone-based installation methods, extension quick-install, environment detection, and agent customization workflows | diff --git a/collections/hve-core-all.collection.yml b/collections/hve-core-all.collection.yml index 34f56fa0b..3a49701ce 100644 --- a/collections/hve-core-all.collection.yml +++ b/collections/hve-core-all.collection.yml @@ -574,6 +574,9 @@ items: - path: .github/skills/coding-standards/python-foundational kind: skill maturity: experimental +- path: .github/skills/design-thinking/demo-setup + kind: skill + maturity: preview - path: .github/skills/experimental/customer-card-render kind: skill - path: .github/skills/experimental/powerpoint diff --git a/plugins/design-thinking/.github/plugin/plugin.json b/plugins/design-thinking/.github/plugin/plugin.json index 7df0d0ca0..c70c05528 100644 --- a/plugins/design-thinking/.github/plugin/plugin.json +++ b/plugins/design-thinking/.github/plugin/plugin.json @@ -7,5 +7,8 @@ ], "commands": [ "commands/design-thinking/" + ], + "skills": [ + "skills/design-thinking/" ] } \ No newline at end of file diff --git a/plugins/design-thinking/README.md b/plugins/design-thinking/README.md index baead2d07..7f17a2e70 100644 --- a/plugins/design-thinking/README.md +++ b/plugins/design-thinking/README.md @@ -22,6 +22,12 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **dt-coach** | Design Thinking coach guiding teams through the 9-method HVE framework with Think/Speak/Empower philosophy | | **dt-learning-tutor** | Design Thinking learning tutor providing structured curriculum, comprehension checks, and adaptive pacing | +### Skills + +| Name | Description | +|----------------|-------------------------------------------------------------------------------------------------------------------------| +| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | + ### Prompts | Name | Description | @@ -175,6 +181,12 @@ copilot plugin install design-thinking@hve-core | dt-curriculum-scenario-manufacturing.instructions | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | hve-core-location.instructions | Important: hve-core is the repository containing this instruction file; Guidance: if a referenced prompt, instructions, agent, or script is missing in the current directory, fall back to this hve-core location by walking up this file's directory tree. | +## Skills + +| Skill | Description | +|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------| +| demo-setup | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype - Brought to you by microsoft/hve-core | + --- > Source: [microsoft/hve-core](https://github.com/microsoft/hve-core) diff --git a/plugins/hve-core-all/.github/plugin/plugin.json b/plugins/hve-core-all/.github/plugin/plugin.json index 1d160455a..567f074a2 100644 --- a/plugins/hve-core-all/.github/plugin/plugin.json +++ b/plugins/hve-core-all/.github/plugin/plugin.json @@ -32,6 +32,7 @@ ], "skills": [ "skills/coding-standards/", + "skills/design-thinking/", "skills/experimental/", "skills/github/", "skills/gitlab/", diff --git a/plugins/hve-core-all/README.md b/plugins/hve-core-all/README.md index 410cc4519..a6372df63 100644 --- a/plugins/hve-core-all/README.md +++ b/plugins/hve-core-all/README.md @@ -540,6 +540,7 @@ copilot plugin install hve-core-all@hve-core | Skill | Description | |---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | python-foundational | Foundational Python best practices, idioms, and code quality fundamentals - Brought to you by microsoft/hve-core | +| demo-setup | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype - Brought to you by microsoft/hve-core | | customer-card-render | Generate customer-card PowerPoint content YAML from Design Thinking canonical artifacts and build using the shared PowerPoint skill pipeline - Brought to you by microsoft/hve-core | | powerpoint | PowerPoint slide deck generation and management using python-pptx with YAML-driven content and styling - Brought to you by microsoft/hve-core | | tts-voiceover | Text-to-speech voice-over generation from YAML speaker notes using Azure Speech SDK with SSML pronunciation control - Brought to you by microsoft/hve-core | From 93e8de0f317dcd56f9feb99da99232365d0162ee Mon Sep 17 00:00:00 2001 From: Emmeline Hoops <108825895+chaosdinosaur@users.noreply.github.com> Date: Tue, 26 May 2026 17:40:03 +0000 Subject: [PATCH 6/6] feat(docs): restructure demo-setup skill documentation for clarity MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - update input and profile sections for better readability - enhance troubleshooting and validation sections - ensure consistent formatting across all tables 📚 - Generated by Copilot --- .../design-thinking/demo-setup/SKILL.md | 174 +++++++++--------- plugins/design-thinking/README.md | 12 +- plugins/hve-core-all/README.md | 1 + 3 files changed, 94 insertions(+), 93 deletions(-) diff --git a/.github/skills/design-thinking/demo-setup/SKILL.md b/.github/skills/design-thinking/demo-setup/SKILL.md index 973d01fba..4de9719ff 100644 --- a/.github/skills/design-thinking/demo-setup/SKILL.md +++ b/.github/skills/design-thinking/demo-setup/SKILL.md @@ -55,13 +55,13 @@ Run a demo with custom inputs: ## Inputs -| Input | Required | Description | -|---|---|---| -| `customer` | Yes | Customer name or organization for the demo scenario | -| `industry` | Yes | Industry vertical (field service, government, healthcare, manufacturing, energy) | -| `persona` | No | End-user persona name and role. Generated from customer and industry context when omitted | -| `problem` | No | Brief problem statement. Inferred from industry patterns when omitted | -| `accelerated` | No | Whether to use accelerated DT method pacing for demo purposes. Defaults to `true` | +| Input | Required | Description | +|---------------|----------|-------------------------------------------------------------------------------------------| +| `customer` | Yes | Customer name or organization for the demo scenario | +| `industry` | Yes | Industry vertical (field service, government, healthcare, manufacturing, energy) | +| `persona` | No | End-user persona name and role. Generated from customer and industry context when omitted | +| `problem` | No | Brief problem statement. Inferred from industry patterns when omitted | +| `accelerated` | No | Whether to use accelerated DT method pacing for demo purposes. Defaults to `true` | ## Customer Persona Brief Template @@ -71,44 +71,44 @@ Save location: `.copilot-tracking/dt/{project-slug}/context/customer-persona-bri ### Organization Profile -| Field | Description | -|---|---| -| Name | Organization name | -| Industry | Industry vertical and sub-sector | -| Size | Employee count and scale indicators | -| Context | Business context, market position, and relevant operational details | +| Field | Description | +|----------|---------------------------------------------------------------------| +| Name | Organization name | +| Industry | Industry vertical and sub-sector | +| Size | Employee count and scale indicators | +| Context | Business context, market position, and relevant operational details | ### Persona Profile -| Field | Description | -|---|---| -| Name | Full name of the persona | -| Role | Job title and department | -| Daily work | Typical workday activities and responsibilities | -| Frustrations | Top 3 to 5 pain points in current workflow | -| Goals | What success looks like for this person | +| Field | Description | +|--------------|-------------------------------------------------| +| Name | Full name of the persona | +| Role | Job title and department | +| Daily work | Typical workday activities and responsibilities | +| Frustrations | Top 3 to 5 pain points in current workflow | +| Goals | What success looks like for this person | ### Problem Scenario -| Field | Description | -|---|---| -| Specific situation | Concrete instance of the problem occurring | -| Constraints | Budget, timeline, regulatory, or technical limitations | -| Stakeholders affected | Who else feels the impact of this problem | -| Existing workarounds | How the persona currently copes with the problem | +| Field | Description | +|-----------------------|--------------------------------------------------------| +| Specific situation | Concrete instance of the problem occurring | +| Constraints | Budget, timeline, regulatory, or technical limitations | +| Stakeholders affected | Who else feels the impact of this problem | +| Existing workarounds | How the persona currently copes with the problem | ### Conversation Seeds Conversation seeds provide realistic customer responses that the DT Coach uses during simulated interactions. Each seed matches the coaching focus of its method. -| Method | Seed Focus | Example Response Pattern | -|---|---|---| -| M1 Scope | What the customer says about their problem initially | Describes the pain point in their own words, mentions what prompted the conversation | -| M2 Research | Daily workflow description and pain points | Walks through a typical day, highlights where things break down | -| M3 Synthesis | Reactions to synthesized themes | Confirms or challenges pattern accuracy, adds nuance from their experience | -| M4 Brainstorming | What excites and concerns them about ideas | Responds to feasibility, flags organizational constraints, identifies quick wins | -| M5 Concepts | Feedback on visual concepts | Reacts to desirability, viability, and feasibility of proposed solutions | -| M6 Lo-Fi | Reactions to paper prototypes | Points out usability friction, suggests workflow changes, identifies missing steps | +| Method | Seed Focus | Example Response Pattern | +|------------------|------------------------------------------------------|--------------------------------------------------------------------------------------| +| M1 Scope | What the customer says about their problem initially | Describes the pain point in their own words, mentions what prompted the conversation | +| M2 Research | Daily workflow description and pain points | Walks through a typical day, highlights where things break down | +| M3 Synthesis | Reactions to synthesized themes | Confirms or challenges pattern accuracy, adds nuance from their experience | +| M4 Brainstorming | What excites and concerns them about ideas | Responds to feasibility, flags organizational constraints, identifies quick wins | +| M5 Concepts | Feedback on visual concepts | Reacts to desirability, viability, and feasibility of proposed solutions | +| M6 Lo-Fi | Reactions to paper prototypes | Points out usability friction, suggests workflow changes, identifies missing steps | ### Domain Vocabulary @@ -118,14 +118,14 @@ Industry-specific terms the persona would naturally use in conversation. Include Follow the six-step workflow to set up a complete HVE Core demo. Each step builds on the previous one. -| Step | Name | Purpose | -|---|---|---| -| 1 | Define Customer Scenario | Generate the customer context and persona brief from user inputs | -| 2 | Initialize DT Coach Session | Create project structure and start the coaching session | -| 3 | Guided DT Methods 1-6 | Accelerated coaching with simulated customer conversations | -| 4 | Prototype Scaffold | Transition to Method 7 and generate the runnable prototype | -| 5 | Demo Walkthrough Guide | Generate the presenter's guide and finalize the demo | -| 6 | Demo Video Script | Generate a narrated video script for recording the demo | +| Step | Name | Purpose | +|------|-----------------------------|------------------------------------------------------------------| +| 1 | Define Customer Scenario | Generate the customer context and persona brief from user inputs | +| 2 | Initialize DT Coach Session | Create project structure and start the coaching session | +| 3 | Guided DT Methods 1-6 | Accelerated coaching with simulated customer conversations | +| 4 | Prototype Scaffold | Transition to Method 7 and generate the runnable prototype | +| 5 | Demo Walkthrough Guide | Generate the presenter's guide and finalize the demo | +| 6 | Demo Video Script | Generate a narrated video script for recording the demo | ### Step 1: Define Customer Scenario @@ -188,15 +188,15 @@ Transition to Method 7 and invoke the hifi-prototype skill for scaffold generati #### Hifi-Prototype Input Mapping -| hifi-prototype Input | Source DT Artifact | Derivation | -|---|---|---| -| Hypothesis | M3 problem statement | Reframe as a testable prediction about user behavior | -| Success criteria | M5 concept D/F/V assessment | Convert desirability, feasibility, and viability ratings into measurable conditions | -| Stack preference | Always `html` | Default zero-install stack for demos | -| Simulation needs | M2 constraint catalog and M6 usability notes | List components that cannot be built live and require fixtures | -| Telemetry level | Always `basic` | Page views, clicks, and task timing for demo purposes | -| Storage | Always `files` | Zero-dependency demo default; avoids database setup | -| LLM provider | Always `none` | Demos use fixture data, not live LLM calls | +| hifi-prototype Input | Source DT Artifact | Derivation | +|----------------------|----------------------------------------------|-------------------------------------------------------------------------------------| +| Hypothesis | M3 problem statement | Reframe as a testable prediction about user behavior | +| Success criteria | M5 concept D/F/V assessment | Convert desirability, feasibility, and viability ratings into measurable conditions | +| Stack preference | Always `html` | Default zero-install stack for demos | +| Simulation needs | M2 constraint catalog and M6 usability notes | List components that cannot be built live and require fixtures | +| Telemetry level | Always `basic` | Page views, clicks, and task timing for demo purposes | +| Storage | Always `files` | Zero-dependency demo default; avoids database setup | +| LLM provider | Always `none` | Demos use fixture data, not live LLM calls | Checkpoint: prototype runs locally by opening `index.html` in a browser. @@ -252,40 +252,40 @@ Every demo scaffold follows a fixed structure. The hifi-prototype skill generate ### Fixed Elements (same across all demos) -| Element | Details | -|---|---| -| Experiment banner | Visible on every page with hypothesis text | -| CSS reset | System fonts, 2-color palette, dashed borders, 44px touch targets | -| Rough UI constraints | No shadows, gradients, or custom fonts | -| Telemetry skeleton | Page views, clicks, task timing, session UUID | -| `[SIMULATED]` badges | Applied to every mock component | -| Experiment card | Hypothesis, success criteria, failure criteria, simulation inventory | -| Demo video script | Narrated walkthrough with visual cues, timing, and production notes | +| Element | Details | +|----------------------|----------------------------------------------------------------------| +| Experiment banner | Visible on every page with hypothesis text | +| CSS reset | System fonts, 2-color palette, dashed borders, 44px touch targets | +| Rough UI constraints | No shadows, gradients, or custom fonts | +| Telemetry skeleton | Page views, clicks, task timing, session UUID | +| `[SIMULATED]` badges | Applied to every mock component | +| Experiment card | Hypothesis, success criteria, failure criteria, simulation inventory | +| Demo video script | Narrated walkthrough with visual cues, timing, and production notes | ### Variable Elements (customized per demo) -| Element | Varies By | -|---|---| -| Accent color | Industry or customer brand association | -| Layout | Screen count and workflow shape (1 to 5 screens max) | -| Fixture schema | Domain-specific data structure in `sim/fixtures/` | -| Domain terms | Industry vocabulary in labels, headings, and fixture data | -| Hypothesis text | Derived from DT session Method 3 themes | -| Success criteria | Derived from DT session Method 5 concepts | +| Element | Varies By | +|------------------|-----------------------------------------------------------| +| Accent color | Industry or customer brand association | +| Layout | Screen count and workflow shape (1 to 5 screens max) | +| Fixture schema | Domain-specific data structure in `sim/fixtures/` | +| Domain terms | Industry vocabulary in labels, headings, and fixture data | +| Hypothesis text | Derived from DT session Method 3 themes | +| Success criteria | Derived from DT session Method 5 concepts | ## Integration with HVE Core Tools Each step of the demo workflow showcases specific HVE Core tools and features. -| Tool / Feature | Where Showcased | Demo Talking Point | -|---|---|---| -| DT Coach agent | Methods 1-6 coaching | AI-guided Design Thinking with structured method progression | -| Customer persona brief | Step 1 scenario setup | Simulated customer conversations grounded in realistic personas | -| Coaching state management | Session persistence across methods | Session recovery, method tracking, and artifact lineage | -| hifi-prototype skill | Method 7 scaffold generation | Experiment-framed prototypes with hypothesis-driven development | -| Experiment cards | Prototype setup | Every prototype starts with a falsifiable hypothesis | -| Telemetry instrumentation | Prototype scaffold | Measurement built in from day one, not added later | -| Canonical deck (optional) | Method 1, 3, and 5 snapshots | Visual summaries at scope, synthesis, and concept milestones | +| Tool / Feature | Where Showcased | Demo Talking Point | +|---------------------------|------------------------------------|-----------------------------------------------------------------| +| DT Coach agent | Methods 1-6 coaching | AI-guided Design Thinking with structured method progression | +| Customer persona brief | Step 1 scenario setup | Simulated customer conversations grounded in realistic personas | +| Coaching state management | Session persistence across methods | Session recovery, method tracking, and artifact lineage | +| hifi-prototype skill | Method 7 scaffold generation | Experiment-framed prototypes with hypothesis-driven development | +| Experiment cards | Prototype setup | Every prototype starts with a falsifiable hypothesis | +| Telemetry instrumentation | Prototype scaffold | Measurement built in from day one, not added later | +| Canonical deck (optional) | Method 1, 3, and 5 snapshots | Visual summaries at scope, synthesis, and concept milestones | ## Validation @@ -302,16 +302,16 @@ Each step of the demo workflow showcases specific HVE Core tools and features. ## Troubleshooting -| Issue | Cause | Solution | -|---|---|---| -| Persona brief feels generic | Insufficient industry context provided | Add specific domain vocabulary and 3 to 5 concrete workflow details to the inputs | -| DT Coach exits accelerated mode | Coaching state missing `session_mode: demo` | Verify coaching-state.md has `session_mode: demo` under the project block in Step 2 | -| Prototype scaffold missing telemetry | hifi-prototype skill not invoked correctly | Ensure the experiment card is complete before triggering Method 7 transition | -| Audience confuses demo with real product | Missing simulation labels | Every mock component requires a visible `[SIMULATED]` badge; check the validation list | -| Demo takes too long to present | Full coaching mode active | Set `accelerated` input to `true` (default) for 2 to 3 exchanges per method | -| Fixture data does not match domain | Conversation seeds missing domain vocabulary | Update the Domain Vocabulary section of the persona brief before starting the session | -| Demo video script too long | Too many prototype screens narrated | Limit prototype demo to 2 to 3 key screens; reference additional screens briefly without full narration | -| Video script feels disconnected from prototype | Script written before scaffold finalized | Generate the video script after Step 5 completes so all prototype screens and the README are available as source material | +| Issue | Cause | Solution | +|------------------------------------------------|----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------| +| Persona brief feels generic | Insufficient industry context provided | Add specific domain vocabulary and 3 to 5 concrete workflow details to the inputs | +| DT Coach exits accelerated mode | Coaching state missing `session_mode: demo` | Verify coaching-state.md has `session_mode: demo` under the project block in Step 2 | +| Prototype scaffold missing telemetry | hifi-prototype skill not invoked correctly | Ensure the experiment card is complete before triggering Method 7 transition | +| Audience confuses demo with real product | Missing simulation labels | Every mock component requires a visible `[SIMULATED]` badge; check the validation list | +| Demo takes too long to present | Full coaching mode active | Set `accelerated` input to `true` (default) for 2 to 3 exchanges per method | +| Fixture data does not match domain | Conversation seeds missing domain vocabulary | Update the Domain Vocabulary section of the persona brief before starting the session | +| Demo video script too long | Too many prototype screens narrated | Limit prototype demo to 2 to 3 key screens; reference additional screens briefly without full narration | +| Video script feels disconnected from prototype | Script written before scaffold finalized | Generate the video script after Step 5 completes so all prototype screens and the README are available as source material | ## Demo Video Script Template diff --git a/plugins/design-thinking/README.md b/plugins/design-thinking/README.md index 7f17a2e70..95e46651a 100644 --- a/plugins/design-thinking/README.md +++ b/plugins/design-thinking/README.md @@ -22,12 +22,6 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **dt-coach** | Design Thinking coach guiding teams through the 9-method HVE framework with Think/Speak/Empower philosophy | | **dt-learning-tutor** | Design Thinking learning tutor providing structured curriculum, comprehension checks, and adaptive pacing | -### Skills - -| Name | Description | -|----------------|-------------------------------------------------------------------------------------------------------------------------| -| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | - ### Prompts | Name | Description | @@ -97,6 +91,12 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **design-thinking/dt-subagent-handoff** | DT subagent handoff workflow: readiness assessment, artifact compilation, and handoff validation via subagent dispatch | | **shared/hve-core-location** | Important: hve-core is the repository containing this instruction file; Guidance: if a referenced prompt, instructions, agent, or script is missing in the current directory, fall back to this hve-core location by walking up this file's directory tree. | +### Skills + +| Name | Description | +|----------------|-------------------------------------------------------------------------------------------------------------------------| +| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | + ## Install diff --git a/plugins/hve-core-all/README.md b/plugins/hve-core-all/README.md index a6372df63..cc5dc8b4d 100644 --- a/plugins/hve-core-all/README.md +++ b/plugins/hve-core-all/README.md @@ -266,6 +266,7 @@ Use this edition when you want access to everything without choosing a focused c | Name | Description | |-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **customer-card-render** | Generate customer-card PowerPoint content YAML from Design Thinking canonical artifacts and build using the shared PowerPoint skill pipeline | +| **demo-setup** | Repeatable HVE Core demo setup that simulates DT Coach sessions with a customer persona and scaffolds a hi-fi prototype | | **gh-code-scanning** | Retrieves and groups GitHub code scanning alerts by rule and severity using the gh CLI | | **gitlab** | Manage GitLab merge requests and pipelines with a Python CLI | | **hve-core-installer** | Decision-driven installer for HVE-Core with 6 clone-based installation methods, extension quick-install, environment detection, and agent customization workflows |