Skip to content

Commit 11b93cb

Browse files
feat(prompts): add dt-resume-coaching prompt for session recovery (#665)
# Pull Request ## Description Add `dt-resume-coaching.prompt.md` - the prompt users invoke to resume an existing DT coaching session. This prompt reads the coaching state file, provides a context summary of where the user left off, and re-establishes the coaching conversation at the correct method and phase. Implements a 4-step protocol: locate project state, read and summarize state, context recovery with user confirmation, and natural handoff to dt-coach agent. ## Related Issue(s) Closes #581 ## Type of Change **AI Artifacts:** - [x] Copilot prompt **Other:** - [x] Documentation update (collection manifests and plugin README updates) ## Testing - Markdown linting: 0 errors - Frontmatter validation: 0 errors, 0 warnings - Plugin generation: 10 plugins generated successfully ## Checklist ### Required Checks - [x] Files follow existing naming conventions - [x] Changes are backwards compatible ### Required Automated Checks - [x] Markdown linting - [x] Frontmatter validation ## Security Considerations - [x] This PR does not contain any sensitive or NDA information ## Additional Notes Frontmatter uses `agent: dt-coach` instead of the issue-specified `mode: agent` + `tools: ['read_file']` because mode and tools are not valid prompt file frontmatter fields per prompt-builder standards. --------- Co-authored-by: Allen Greaves <[email protected]>
1 parent ce583d5 commit 11b93cb

8 files changed

Lines changed: 64 additions & 4 deletions

File tree

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
description: 'Resume a Design Thinking coaching session — reads coaching state and re-establishes context - Brought to you by microsoft/hve-core'
3+
agent: dt-coach
4+
argument-hint: "projectName=..."
5+
---
6+
7+
# Resume Design Thinking Coaching
8+
9+
## Inputs
10+
11+
* ${input:projectName}: (Required) Name of the DT project to resume. Derives the project slug (kebab-case) for directory lookup under `.copilot-tracking/dt/`.
12+
13+
## Required Steps
14+
15+
### Step 1: Locate Project State
16+
17+
1. Derive the project slug from `${input:projectName}` using kebab-case conversion.
18+
2. Look for the coaching state file at `.copilot-tracking/dt/{project-slug}/coaching-state.md`.
19+
3. If the state file is not found, list directories under `.copilot-tracking/dt/` to check for alternative matches.
20+
4. If multiple projects exist and the slug is ambiguous, list available projects with their last session dates and ask the user to select one.
21+
5. If no state file exists for any project, inform the user and suggest running the `dt-start-project` prompt to initialize a new project.
22+
23+
### Step 2: Read and Summarize State
24+
25+
1. Read the coaching state file and verify it parses as valid YAML with required fields: `project`, `current`, `methods_completed`, `transition_log`.
26+
2. Extract the current method, space, and phase from the `current` block.
27+
3. Read `methods_completed` to determine overall progress through the 9 methods.
28+
4. Review the most recent `transition_log` entry for the last method change and its rationale.
29+
5. Review the most recent `session_log` entry for a summary of previous session work.
30+
6. Scan the `artifacts` list for available project artifacts to reference.
31+
7. If the state file is corrupted or missing required fields, inform the user which fields are unreadable, and offer to reconstruct state from existing artifacts in the project directory or reinitialize from scratch.
32+
33+
### Step 3: Context Recovery
34+
35+
1. Present a human-readable context summary to the user: "Last session you were working on Method [N] ([name]), in the [phase] phase. Here's where you left off: [session log summary]."
36+
2. Include overall progress: which methods are complete and which remain.
37+
3. Reference the most recent transition rationale if it provides useful context.
38+
4. List key artifacts from the project directory that relate to the current method.
39+
5. Review recent session log entries to gauge the coaching intensity level and adjust hint escalation accordingly, starting at the level consistent with prior sessions rather than resetting to Level 1.
40+
6. Ask the user to confirm the summary is accurate before proceeding.
41+
42+
### Step 4: Resume Coaching
43+
44+
1. After the user confirms the context summary, transition into active coaching at the current method and phase.
45+
2. Read the relevant method instruction file for the current method to refresh method-specific knowledge.
46+
3. Continue the conversation naturally as though picking up where the previous session ended, not mechanically reciting method steps.
47+
4. Proceed with Phase 2 (Active Coaching) of the dt-coach protocol from the restored state.
48+
49+
---
50+
51+
Resume the Design Thinking coaching session for project "${input:projectName}" by following the Required Steps.

collections/design-thinking.collection.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
Coaching identity, quality constraints, and methodology instructions for AI-enhanced design thinking across nine methods. The collection supports the HVE Design Thinking pyramid structure spanning Problem, Solution, and Implementation spaces.
22

3-
This collection includes agents and prompts for:
3+
This collection includes agents, prompts, and instructions for:
44

55
- **DT Start Project** — Initializes a new Design Thinking coaching project with state file creation, frozen/fluid classification, and first Method 1 coaching interaction
6+
- **DT Resume Coaching** — Resumes an existing coaching session from saved state, restoring context from the project's coaching state file
67
- **DT Coaching Identity** — Defines the coach's interaction philosophy (Think, Speak, Empower), progressive hint engine, psychological safety patterns, and hat-switching framework for consistent behavior across all nine methods
78
- **DT Coach**: Conversational coaching agent that guides teams through all 9 methods with Think/Speak/Empower philosophy
89
- **DT Coaching State** — Session persistence schema, method progress tracking, and session recovery protocol enabling the coach to resume seamlessly across conversations

collections/design-thinking.collection.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ items:
1414
# Prompts
1515
- path: .github/prompts/design-thinking/dt-start-project.prompt.md
1616
kind: prompt
17+
- path: .github/prompts/design-thinking/dt-resume-coaching.prompt.md
18+
kind: prompt
1719

1820
# Instructions
1921
- path: .github/instructions/design-thinking/dt-coaching-identity.instructions.md

collections/hve-core-all.collection.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,8 @@ items:
8383
kind: prompt
8484
- path: .github/prompts/ado/ado-update-wit-items.prompt.md
8585
kind: prompt
86+
- path: .github/prompts/design-thinking/dt-resume-coaching.prompt.md
87+
kind: prompt
8688
- path: .github/prompts/design-thinking/dt-start-project.prompt.md
8789
kind: prompt
8890
- path: .github/prompts/github/github-add-issue.prompt.md

plugins/design-thinking/README.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,10 @@ copilot plugin install design-thinking@hve-core
1717

1818
## Commands
1919

20-
| Command | Description |
21-
|------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
22-
| dt-start-project | Start a new Design Thinking coaching project with state initialization and first coaching interaction - Brought to you by microsoft/hve-core |
20+
| Command | Description |
21+
|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
22+
| dt-start-project | Start a new Design Thinking coaching project with state initialization and first coaching interaction - Brought to you by microsoft/hve-core |
23+
| dt-resume-coaching | Resume a Design Thinking coaching session — reads coaching state and re-establishes context - Brought to you by microsoft/hve-core |
2324

2425
## Instructions
2526

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
../../../.github/prompts/design-thinking/dt-resume-coaching.prompt.md

plugins/hve-core-all/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ copilot plugin install hve-core-all@hve-core
5656
| ado-get-my-work-items | Retrieve user's current Azure DevOps work items and organize them into planning file definitions |
5757
| ado-process-my-work-items-for-task-planning | Process retrieved work items for task planning and generate task-planning-logs.md handoff file |
5858
| ado-update-wit-items | Prompt to update work items based on planning files |
59+
| dt-resume-coaching | Resume a Design Thinking coaching session — reads coaching state and re-establishes context - Brought to you by microsoft/hve-core |
5960
| dt-start-project | Start a new Design Thinking coaching project with state initialization and first coaching interaction - Brought to you by microsoft/hve-core |
6061
| github-add-issue | Create a GitHub issue using discovered repository templates and conversational field collection |
6162
| github-discover-issues | Discover GitHub issues through user-centric queries, artifact-driven analysis, or search-based exploration and produce planning files for review |
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
../../../.github/prompts/design-thinking/dt-resume-coaching.prompt.md

0 commit comments

Comments
 (0)