feat(instructions): add DT image prompt generation guidance for Method 5 by ofimbres · Pull Request #726 · microsoft/hve-core

ofimbres · 2026-02-21T03:01:04Z

Pull Request

Description

Adds comprehensive instructions for generating lo-fi image prompts during Design Thinking Method 5 (Concept Articulation). This instruction file guides coaches and practitioners in transforming conceptual ideas into structured M365 Copilot prompts that produce sketch-style visualizations for stakeholder evaluation.

Key additions:

dt-image-prompt-generation.instructions.md: New instruction file with 5-layer lo-fi enforcement framework
Prompt generation approach with 4-step transformation sequence
Image prompt structure templates with required components
Three cross-industry example patterns (manufacturing, healthcare, office)
Integration with Method 5 workflow (5b → 5c → 6 transition)
Updated design-thinking collection with new instructions entry
Regenerated all plugin outputs with new DT method command symlinks

Related Issue(s)

Fixes #571

Type of Change

AI Artifacts:

Copilot instructions (.github/instructions/*.instructions.md)

Sample Prompts (for AI Artifact Contributions)

User Request:
During Method 5b concept articulation, after drafting concept cards, the DT coach needs to create DALL-E prompts for lo-fi concept visualizations.

Execution Flow:

Coach identifies core interaction from concept (e.g., "worker scans QR code")
Extracts visual elements: stakeholder archetype, tool/object, environmental context
Applies 5-layer lo-fi directive stack (stick figures, minimal lines, plain background, b&w, no shading)
Validates with 15-second napkin sketch test
Writes prompt into concepts.yml YAML schema

Output Artifacts:
The instruction file auto-applies when editing .copilot-tracking/dt/**/method-05**/concepts.yml files. Example YAML output:

concepts:
  - name: QR Snap Manuals
    description: Workers scan machine QR codes to access step-by-step safety procedures.
    file: qr-snap-manuals.png
    prompt: >-
      Create a simple stick-figure scene of a factory worker pointing a phone at a big
      QR code on a machine; on the phone screen, show a plain card with three bullet
      lines labelled 'Step 1, Step 2, Step 3'. Black-and-white line art, stick figures,
      minimal lines, no shading, plain white background.

Success Indicators:

Prompt includes all 5 lo-fi directive layers
Visual can be sketched on napkin in 15 seconds
Generated image is rough/scrappy (invites structural feedback vs cosmetic)
YAML schema valid and ready for generate-dalle-images.ps1 processing

Testing

✅ Validated frontmatter targets Method 5 paths: **/.copilot-tracking/dt/**/method-05**/concepts.yml
✅ Confirmed all required sections present (Purpose, Approach, Structure, Requirements, Integration, Examples)
✅ Verified 3 example patterns across manufacturing, healthcare, office contexts
✅ Token count within target range (~740-1,280 tokens)
✅ Prompt-builder compliance verified against instructions file standards
✅ Generated test concepts.yml and validated lo-fi prompt structure

Review log: .copilot-tracking/reviews/2026-02-21/dt-image-prompt-generation-review.md

Checklist

Required Checks

Documentation is updated (collection manifests, plugin outputs)
Files follow existing naming conventions (kebab-case, .instructions.md extension)
Changes are backwards compatible (purely additive)

AI Artifact Contributions

Verified contribution follows common standards and type-specific requirements
Instruction file includes required frontmatter (description, applyTo)
Content defines standards and conventions with code examples
Examples wrapped in fenced code blocks

Required Automated Checks

Markdown linting: npm run lint:md ✓ No errors
Frontmatter validation: npm run lint:frontmatter ✓ Passed
Link validation: npm run lint:md-links (no new links)

Security Considerations

This PR does not contain any sensitive or NDA information
No new dependencies introduced
No security-related scripts

Additional Notes

Design Rationale:

The 5-layer lo-fi enforcement framework prevents DALL-E from generating polished, production-ready visualizations that would invite cosmetic feedback rather than structural validation. Rough concepts keep stakeholder evaluation focused on "Does this solve the right problem?" rather than "I'd change the wording here."

Integration Point:

This instruction file complements existing Method 5 guidance:

dt-method-05-concepts.instructions.md: Overall Method 5 coaching knowledge
dt-image-prompt-generation.instructions.md: Specialized image prompt writing techniques
generate-dalle-images.ps1: Batch processing script for concept visualization

Token Budget:

Instruction file is 986 words (~740-1,280 tokens), staying within recommended range for auto-applied instructions that load on file match.

- add dt-image-prompt-generation.instructions.md for M365 Copilot visualization prompts - update design-thinking collection with new instructions entry - regenerate plugins with new DT method command symlinks 🎨 - Generated by Copilot

Resolved merge conflicts in plugin README files by regenerating with npm run plugin:generate. 🔧 - Generated by Copilot

# Conflicts: # collections/design-thinking.collection.yml # collections/hve-core-all.collection.yml # plugins/design-thinking/README.md # plugins/hve-core-all/README.md

- add dt-image-prompt-generation, dt-method-04-brainstorming, dt-method-05-concepts, dt-method-06-lofi-prototypes to design-thinking collection - set maturity: experimental for dt-image-prompt-generation in hve-core-all - regenerate plugin outputs 🔧 - Generated by Copilot

## Pre-Release 3.1.44 ### ✨ Features - add Docusaurus 3 documentation site with GitHub Pages deployment (#680) - add workflow permissions validation for OpenSSF Scorecard compliance (#759) - add DT coach return path handoff to task-researcher (#591) (#758) - add DT subagent handoff workflow instructions (#592) (#757) - create dt-method-06-deep.instructions.md (#602) (#748) - create dt-method-05-deep.instructions.md (#747) - add DT-aware task-implementor context instructions (#755) - extract embedded PowerShell from workflows into testable scripts (#738) - add gitleaks binary-based secret scanning as PR gate (#734) - add SBOM generation, attestation, and diff tooling to release pipeline (#730) - add dt-learning-tutor agent for DT education (#662) - add DT image prompt generation guidance for Method 5 (#726) - add DT-aware task-reviewer review context (#714) - add dt-method-next routing prompt (#713) - create dt-method-04-deep.instructions.md (#709) - add Implementation Space exit handoff prompt for DT workflows (#708) - add Write-CIStepSummary markdown table to Test-SHAStaleness github output (#660) - add dt-handoff-solution-space prompt for Solution Spac… (#707) ### 🐛 Bug Fixes - update sidebar link color to meet WCAG AA contrast requirements (#814) - harden even/odd versioning against regression and syntax errors (#816) - replace even/odd versioning with SemVer -rc.N suffixes (#811) - ensure prerelease label exists before PR creation (#806) - replace Docusaurus favicons with Microsoft logo (#808) - add missing subagents and shared instructions to collection manifests (#804) - standardize file path conventions for copilot-tracking output (#784) - enforce project-scoped artifact isolation across DT files (#766) - add top-level permissions to copilot-setup-steps.yml (#760) - update broken file directives and markdown links after collection directory reorg (#743) - add pre-release companion pipeline with even/odd versioning (#735) - exclude auto-generated CHANGELOG.md from spell check (#756) - add job-level permissions to extension-publish.yml (#729) - resolve handoff dependencies using display names (#727) - add job-level permissions to validate-version in extension-publish-prerelease (#731) - replace parent-directory VS Code settings paths with per-subdirectory enumeration (#732) ### 📚 Documentation - add Design Thinking documentation and DT-to-RPI handoff (#789) - add customization guides for HVE Core artifacts (#772) - reconcile documentation against implementation (#771) - document accepted Token-Permissions risks and add lint:dependency-pinning (#763) - add Design Thinking section to hve-core-all collection description (#762) ### ♻️ Refactoring - move collection scripts from plugins to collections (#728) - remove duplicate git diff logic in frontmatter validator (#473) ### 🔧 Maintenance - bump basic-ftp from 5.0.5 to 5.2.0 (#780) - standardize script path references in SKILL.md files (#768) - bump the github-actions group across 1 directory with 2 updates (#752) --- *Managed automatically by pre-release workflow.* Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

## Pre-Release 3.1.46 ### ✨ Features - add Docusaurus 3 documentation site with GitHub Pages deployment (#680) - add workflow permissions validation for OpenSSF Scorecard compliance (#759) - add DT coach return path handoff to task-researcher (#591) (#758) - add DT subagent handoff workflow instructions (#592) (#757) - create dt-method-06-deep.instructions.md (#602) (#748) - create dt-method-05-deep.instructions.md (#747) - add DT-aware task-implementor context instructions (#755) - extract embedded PowerShell from workflows into testable scripts (#738) - add gitleaks binary-based secret scanning as PR gate (#734) - add SBOM generation, attestation, and diff tooling to release pipeline (#730) - add dt-learning-tutor agent for DT education (#662) - add DT image prompt generation guidance for Method 5 (#726) - add DT-aware task-reviewer review context (#714) - add dt-method-next routing prompt (#713) - create dt-method-04-deep.instructions.md (#709) - add Implementation Space exit handoff prompt for DT workflows (#708) - add Write-CIStepSummary markdown table to Test-SHAStaleness github output (#660) - add dt-handoff-solution-space prompt for Solution Spac… (#707) ### 🐛 Bug Fixes - update prerelease publish to use even/odd convention (#822) - update sidebar link color to meet WCAG AA contrast requirements (#814) - harden even/odd versioning against regression and syntax errors (#816) - replace even/odd versioning with SemVer -rc.N suffixes (#811) - ensure prerelease label exists before PR creation (#806) - replace Docusaurus favicons with Microsoft logo (#808) - add missing subagents and shared instructions to collection manifests (#804) - standardize file path conventions for copilot-tracking output (#784) - enforce project-scoped artifact isolation across DT files (#766) - add top-level permissions to copilot-setup-steps.yml (#760) - update broken file directives and markdown links after collection directory reorg (#743) - add pre-release companion pipeline with even/odd versioning (#735) - exclude auto-generated CHANGELOG.md from spell check (#756) - add job-level permissions to extension-publish.yml (#729) - resolve handoff dependencies using display names (#727) - add job-level permissions to validate-version in extension-publish-prerelease (#731) - replace parent-directory VS Code settings paths with per-subdirectory enumeration (#732) ### 📚 Documentation - add Design Thinking documentation and DT-to-RPI handoff (#789) - add customization guides for HVE Core artifacts (#772) - reconcile documentation against implementation (#771) - document accepted Token-Permissions risks and add lint:dependency-pinning (#763) - add Design Thinking section to hve-core-all collection description (#762) ### ♻️ Refactoring - move collection scripts from plugins to collections (#728) - remove duplicate git diff logic in frontmatter validator (#473) ### 🔧 Maintenance - pre-release 3.1.44 (#819) - bump basic-ftp from 5.0.5 to 5.2.0 (#780) - standardize script path references in SKILL.md files (#768) - bump the github-actions group across 1 directory with 2 updates (#752) --- *Managed automatically by pre-release workflow.* Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

ofimbres added 2 commits February 21, 2026 02:58

Include prompt files

60c0624

ofimbres requested a review from a team as a code owner February 21, 2026 03:01

ofimbres and others added 4 commits February 21, 2026 03:06

chore: merge upstream/main and regenerate plugins

e69c32d

Resolved merge conflicts in plugin README files by regenerating with npm run plugin:generate. 🔧 - Generated by Copilot

npm run format:tables

21bb8d3

Merge remote-tracking branch 'origin/main' into feature/571-merge

27dce3f

# Conflicts: # collections/design-thinking.collection.yml # collections/hve-core-all.collection.yml # plugins/design-thinking/README.md # plugins/hve-core-all/README.md

WilliamBerryiii approved these changes Feb 23, 2026

View reviewed changes

WilliamBerryiii merged commit bbce9c2 into microsoft:main Feb 23, 2026
19 checks passed

hve-core-release-please bot mentioned this pull request Feb 28, 2026

chore(main): pre-release 3.1.46 #823

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(instructions): add DT image prompt generation guidance for Method 5#726

feat(instructions): add DT image prompt generation guidance for Method 5#726
WilliamBerryiii merged 6 commits intomicrosoft:mainfrom
ofimbres:feature/571

ofimbres commented Feb 21, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ofimbres commented Feb 21, 2026

Pull Request

Description

Related Issue(s)

Type of Change

Sample Prompts (for AI Artifact Contributions)

Testing

Checklist

Required Checks

AI Artifact Contributions

Required Automated Checks

Security Considerations

Additional Notes

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants