Skip to content

Commit 67160f6

Browse files
committed
Add custom chat mode adventure (not in readme yet)
1 parent 13b8a85 commit 67160f6

9 files changed

+202
-7
lines changed

Adventures/Agent/1-Beginner/The-Clockwork-Town-of-Tempora-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Your task is to create a system that checks all the clocks in the town and synch
1919
Before starting this adventure, you'll need to perform the following steps:
2020

2121
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
22-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
22+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
2323

2424
### Learning Outcomes
2525

Lines changed: 195 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,195 @@
1+
## The Command Center of Stellaris - Agent Mode Adventure
2+
3+
<a href="#">
4+
<img src="../../../Images/stellaris-command.jpg" style="width: 830px" />
5+
</a>
6+
7+
### Background
8+
9+
In the distant galaxy of Stellaris, the Galactic Command Center serves as the central hub for coordinating interstellar missions across thousands of star systems. The Command Center relies on specialized AI commanders, each with unique expertise in different aspects of space exploration, battle tactics, resource management, and diplomatic negotiations.
10+
11+
Recently, the Command Center's main AI system has been upgraded to support custom command protocols - specialized modes that can be activated for specific mission types. These custom modes allow commanders to access tailored knowledge bases, specialized tools, and mission-specific guidance that far surpasses standard operational procedures.
12+
13+
### Objective
14+
15+
Your mission is to learn how to install and utilize GitHub Copilot's Custom Chat Modes by setting up a specialized "Implementation Planner" AI commander for your development missions. You'll explore how custom chat modes available in the [Awesome Copilot repository](https://github.com/github/awesome-copilot) can transform your coding experience by providing specialized AI assistants tailored to your specific development needs.
16+
17+
**In this adventure, you'll learn to use GitHub Copilot's Custom Chat Modes** - specialized AI configurations that provide enhanced, context-aware assistance for particular tasks or workflows!
18+
19+
### Prerequisites
20+
21+
Before starting this adventure, you'll need to perform the following steps:
22+
23+
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
24+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
25+
26+
### Learning Outcomes
27+
28+
By completing this adventure, you'll learn:
29+
30+
- ✅ How to discover and install GitHub Copilot Custom Chat Modes from [Awesome Copilot](https://github.com/github/awesome-copilot)
31+
- ✅ How custom chat modes enhance AI assistance for specific tasks
32+
- ✅ Best practices for selecting the right chat mode for your needs
33+
34+
### Setting Up Your Mission
35+
36+
1. **Open VS Code** and ensure you're signed in to GitHub.
37+
2. **Open the GitHub Copilot Chat view** by selecting the chat icon in the top bar.
38+
3. **Prepare for custom mode installation** - we'll guide you through the process!
39+
40+
### Specifications
41+
42+
Your mission briefing includes the following objectives to understand custom chat modes:
43+
44+
1. **Install the Implementation Planner Mode**
45+
- Navigate to the GitHub repository containing custom chat modes
46+
- Install the "Implementation Planner" mode in VS Code
47+
- Configure the mode for your workspace
48+
49+
2. **Mission Simulation**
50+
- Activate the Implementation Planner mode
51+
- Use it to create a detailed plan for a space exploration project
52+
- Experience the enhanced capabilities compared to standard chat
53+
54+
3. **Explore Additional Modes**
55+
- Discover other custom chat modes available
56+
- Learn when to use different specialized modes
57+
58+
### Mission Phase 1: Installing Your First Custom Chat Mode
59+
60+
#### Step 1: Access the Stellaris Command Database
61+
62+
Navigate to the [Awesome Copilot Custom Chat Modes repository](https://github.com/github/awesome-copilot/blob/main/prompts/create-implementation-plan.prompt.md) to access the specialized "Implementation Plan Creator" command protocol.
63+
64+
This custom chat mode is designed to help you create detailed, structured implementation plans for any development project - perfect for planning complex space missions!
65+
66+
#### Step 2: Deploy the Custom Commander
67+
68+
1. **Click the "VS Code Install" button** next to the "Implementation Plan Creator" to automatically install the custom chat mode
69+
2. **VS Code will open** and prompt you to install chat mode file
70+
3. **Choose your installation location:**
71+
- **Workspace**: Install for current project only
72+
- **User Profile**: Install globally for all your projects
73+
4. **Confirm the installation** when prompted
74+
75+
#### Step 3: Activate Your Specialized Commander
76+
77+
1. **Open the GitHub Copilot Chat panel** in VS Code (you should see the chat icon in the top bar)
78+
2. **Select your new "Implementation Plan Creator" mode** from the dropdown at the bottom of the chat panel
79+
3. **Choose a "Standard Model"** from the available AI models
80+
81+
### Mission Phase 2: Test Your New AI Commander
82+
83+
Now let's test your specialized Implementation Planner with a space exploration scenario!
84+
85+
#### Step 1: Brief Your AI Commander
86+
87+
In the Chat panel with your new custom mode selected, provide this mission briefing:
88+
89+
```
90+
Mission Briefing: Plan the development of a "Stellar Navigation System" for our interstellar fleet.
91+
92+
The system should:
93+
- Track multiple spacecraft across different star systems
94+
- Calculate optimal hyperspace jump routes
95+
- Monitor fuel consumption and crew status
96+
- Provide real-time navigation updates
97+
- Include emergency protocols for system failures
98+
99+
Create a comprehensive implementation plan for this mission-critical system.
100+
```
101+
102+
#### Step 2: Observe Enhanced Planning Capabilities
103+
104+
Your specialized AI commander will now demonstrate advanced planning capabilities:
105+
106+
- 📋 **Structured Requirements Analysis** - Breaking down complex needs systematically
107+
- 🏗️ **Detailed Implementation Steps** - Task-by-task breakdown with clear identifiers
108+
- 🔗 **Dependency Mapping** - Understanding task relationships
109+
- 🧪 **Testing Strategies** - Comprehensive validation approaches
110+
- ⚠️ **Risk Assessment** - Potential challenges and mitigation strategies
111+
112+
#### Step 3: Compare with Standard Mode
113+
114+
To appreciate the enhancement, try the same prompt with standard Chat mode:
115+
116+
1. **Switch back to standard "Chat" mode**
117+
2. **Ask the same question**
118+
3. **Compare the responses** - notice how the custom mode provides more structured, implementation-focused guidance
119+
120+
### Mission Phase 3: Explore the Stellaris Command Fleet
121+
122+
Now that you've mastered your first custom commander, it's time to explore the full fleet of available AI specialists!
123+
124+
#### Step 1: Return to Command Headquarters
125+
126+
Navigate back to the [Awesome Copilot repository](https://github.com/github/awesome-copilot?tab=readme-ov-file#-custom-chat-modes) to explore the complete catalog of custom chat modes.
127+
128+
#### Step 2: Select Your Next Commander
129+
130+
Browse through the available modes and choose one that matches a real work scenario you face.
131+
132+
#### Step 3: Deploy and Test
133+
134+
1. **Install your chosen chat mode** using the VS Code Install button
135+
2. **Test it with a relevant scenario** from your actual work
136+
3. **Compare the results** with standard chat mode responses
137+
138+
### Custom Chat Mode Best Practices
139+
140+
<a href="#">
141+
<img src="../../../Images/agent-mode-tips.jpg" style="width: 830px" />
142+
</a>
143+
144+
#### Choosing the Right Commander
145+
146+
1. **Match the Mode to the Task**: Select specialized modes for specific types of work
147+
2. **Understand Mode Capabilities**: Read the custom chat mode document to understand its strengths
148+
3. **Experiment with Different Modes**: Try various modes for the same task to find your preference
149+
150+
#### Maximizing Custom Mode Effectiveness
151+
152+
1. **Provide Context**: Custom modes work best with detailed, specific prompts
153+
2. **Leverage Mode Strengths**: Use implementation planners for planning, code reviewers for reviews
154+
3. **Chain Modes**: Use one mode for planning, another for implementation
155+
4. **Create Your Own**: You can can create custom modes for unique workflows. Select the dropdown in the chat panel and choose "Configure Modes" followed by "Create new custom chat mode file" to get started.
156+
157+
### Important Custom Chat Mode Considerations
158+
159+
**Installation & Management:**
160+
- Custom modes are stored as `.chatmode.md` files in your workspace or user profile
161+
- You can edit these files to customize behavior further
162+
- Modes can be version-controlled with your project for team consistency
163+
- Remove unused modes to keep your interface clean
164+
165+
**Performance & Usage:**
166+
- Custom modes may have different token usage patterns
167+
- Some modes are optimized for specific types of responses
168+
- Mode selection affects the AI's behavior and knowledge focus
169+
- Always verify mode selection before starting complex tasks
170+
171+
### Mission Completion & Next Steps
172+
173+
Congratulations, Commander! You've successfully:
174+
175+
**Installed your first custom chat mode**
176+
**Experienced enhanced AI assistance for specialized tasks**
177+
**Learned to select appropriate modes for different scenarios**
178+
**Explored the ecosystem of community-created modes**
179+
180+
### Advanced Mission Objectives
181+
182+
After mastering basic custom chat modes:
183+
184+
1. **Create Your Own Mode**: Design a custom chat mode for your specific workflow needs
185+
2. **Team Deployment**: Share custom modes with your development team for consistency
186+
3. **Mode Chaining**: Use multiple specialized modes in sequence for complex projects
187+
4. **Community Contribution**: Share your custom modes with the GitHub community by submitting a PR to the [Awesome Copilot repository](https://github.com/github/awesome-copilot)
188+
189+
### Return to Headquarters
190+
191+
Your training in the Stellaris Command Center is complete! You now have access to a fleet of specialized AI commanders that can enhance your development capabilities far beyond standard assistance.
192+
193+
Remember: The right commander for the right mission makes all the difference in successfully navigating the vast galaxy of software development!
194+
195+
**Next Mission:** Try other GitHub Copilot adventures to discover more about GitHub Copilot Agent Mode!

Adventures/Agent/1-Beginner/The-Magical-Forest-of-Algora-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Your task is to create a system that simulates the sacred dance between Lox and
1919
Before starting this adventure, you'll need to perform the following steps:
2020

2121
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
22-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
22+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
2323

2424
### Learning Outcomes
2525

Adventures/Agent/2-Intermediate/The-Celestial-Alignment-of-Lumoria-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Your task is to create a system that calculates the intensity of light each plan
1919
Before starting this adventure, you'll need to perform the following steps:
2020

2121
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
22-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
22+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
2323

2424
### Learning Outcomes
2525

Adventures/Agent/2-Intermediate/The-Legendary-Duel-of-Stonevale-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Your task is to create a system that simulates the legendary duel between Rok an
1919
Before starting this adventure, you'll need to perform the following steps:
2020

2121
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
22-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
22+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
2323

2424
### Learning Outcomes
2525

Adventures/Agent/2-Intermediate/The-Scrolls-of-Eldoria-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Your task is to create a system that retrieves a digitized scroll from the Eldor
1919
Before starting this adventure, you'll need to perform the following steps:
2020

2121
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
22-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
22+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
2323

2424
### Learning Outcomes
2525

Adventures/Agent/3-Advanced/The-Gridlock-Arena-of-Mythos-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Your task is to create a comprehensive battle simulation system for the Gridlock
1919
Before starting this adventure, you'll need to perform the following steps:
2020

2121
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
22-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
22+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
2323

2424
### Learning Outcomes
2525

Adventures/Agent/Warmup-Adventure-Agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ If you're brand new to GitHub Copilot, check out this content to learn about the
2828
Before starting this adventure, you'll need to perform the following steps:
2929

3030
1. **Install VS Code** - Download from [VS Code](https://code.visualstudio.com/).
31-
2. **Set up Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
31+
2. **Set up GitHub Copilot in VS Code** - Follow the instructions at [Set up GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/setup).
3232

3333
### Starting Agent Mode
3434

Images/stellaris-command.jpg

320 KB
Loading

0 commit comments

Comments
 (0)