improve server instructions

kentcdodds · kentcdodds · commit 070ef595bade · 2025-09-03T19:38:19.000-07:00
diff --git a/exercises/03.resources/01.problem.simple/src/index.ts b/exercises/03.resources/01.problem.simple/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				// 🐨 add resources to the capabilities
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/01.solution.simple/src/index.ts b/exercises/03.resources/01.solution.simple/src/index.ts
@@ -18,11 +18,19 @@ export class EpicMeMCP {
 				resources: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/02.problem.template/src/index.ts b/exercises/03.resources/02.problem.template/src/index.ts
@@ -18,11 +18,19 @@ export class EpicMeMCP {
 				resources: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/02.solution.template/src/index.ts b/exercises/03.resources/02.solution.template/src/index.ts
@@ -18,11 +18,19 @@ export class EpicMeMCP {
 				resources: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/03.problem.list/src/index.ts b/exercises/03.resources/03.problem.list/src/index.ts
@@ -18,11 +18,19 @@ export class EpicMeMCP {
 				resources: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/03.solution.list/src/index.ts b/exercises/03.resources/03.solution.list/src/index.ts
@@ -18,11 +18,19 @@ export class EpicMeMCP {
 				resources: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/04.problem.completion/src/index.ts b/exercises/03.resources/04.problem.completion/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				// 🐨 add completions capability
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/03.resources/04.solution.completion/src/index.ts b/exercises/03.resources/04.solution.completion/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				completions: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/04.resource-tools/01.problem.embedded/src/index.ts b/exercises/04.resource-tools/01.problem.embedded/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				completions: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/04.resource-tools/01.solution.embedded/src/index.ts b/exercises/04.resource-tools/01.solution.embedded/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				completions: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/04.resource-tools/02.problem.linked/src/index.ts b/exercises/04.resource-tools/02.problem.linked/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				completions: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/04.resource-tools/02.solution.linked/src/index.ts b/exercises/04.resource-tools/02.solution.linked/src/index.ts
@@ -19,11 +19,19 @@ export class EpicMeMCP {
 				completions: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/05.prompts/01.problem.prompts/src/index.ts b/exercises/05.prompts/01.problem.prompts/src/index.ts
@@ -22,11 +22,19 @@ export class EpicMeMCP {
 				// 🐨 add prompts capabilities here:
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/05.prompts/01.solution.prompts/src/index.ts b/exercises/05.prompts/01.solution.prompts/src/index.ts
@@ -21,11 +21,19 @@ export class EpicMeMCP {
 				prompts: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/05.prompts/02.problem.optimized-prompt/src/index.ts b/exercises/05.prompts/02.problem.optimized-prompt/src/index.ts
@@ -21,11 +21,19 @@ export class EpicMeMCP {
 				prompts: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/05.prompts/02.solution.optimized-prompt/src/index.ts b/exercises/05.prompts/02.solution.optimized-prompt/src/index.ts
@@ -21,11 +21,19 @@ export class EpicMeMCP {
 				prompts: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/05.prompts/03.problem.completion/src/index.ts b/exercises/05.prompts/03.problem.completion/src/index.ts
@@ -21,11 +21,19 @@ export class EpicMeMCP {
 				prompts: {},
 			},
 			instructions: `
-EpicMe is a journaling app that allows users to write about and review their experiences, thoughts, and reflections.
+EpicMe: Personal journaling server with AI-powered organization.
 
-These tools are the user's window into their journal. With these tools and your help, they can create, read, and manage their journal entries and associated tags.
+## Core Workflow
+- Create: \`create_entry\` → \`list_tags\` → \`create_tag\` (if needed) → \`add_tag_to_entry\`
 
-You can also help users add tags to their entries and get all tags for an entry.
+## Best Practices
+- Check \`list_tags\` before creating new tags to avoid duplicates
+- Use \`list_entries\` to find specific entry IDs before \`get_entry\`
+
+## Common Requests
+- "Write in my journal" → \`create_entry\`
+- "Show me my entries" → \`list_entries\` or \`view_journal\`
+- "Organize my entries" → \`list_tags\` then \`create_tag\` and \`add_tag_to_entry\`
 			`.trim(),
 		},
 	)
diff --git a/exercises/05.prompts/03.solution.completion/src/index.ts b/exercises/05.prompts/03.solution.completion/src/index.ts
