The harness is all you need (mostly)
A practical GitHub Copilot workflow for prototyping, planning, implementing, and reviewing software without chasing every new AI tool. The post The harness is all you need (mostly) appeared first on The GitHub Blog .
Burke Holland Technologist, author, speaker, and creator. Working at GitHub where I focus on AI-powered development.
If youāre feeling overwhelmed by AI right now, youāre not alone. Every day it seems there is a new tool, new MCP, new model, new skill, new workflow, new feature, new social post that is some form of āHey look! I have completely figured out AI with this one weird prompt.ā Iā¦donāt believe you. I work with AI every single day, and what Iām finding is that less is way more. Itās not about what I install or configure or trick the agent into doing that makes any real difference. That stuff is interesting, but at the end of the day it feels like gimmicks. I see the biggest gains in my productivity from how I use the harness and how well I understand it. So in this post, Iām sharing you a simple workflow that you can use to drastically improve your effectiveness with AI just by using existing features of GitHub Copilot. No weird prompts. No skill everyone else seems to know about. Just the harness.
The harness is all you need-mostly.
Pick a Tool
This is an obvious one, right? Pick a tool! Itās so easy! But even within the GitHub Copilot family, there are a lot of options. These include the CLI, the new GitHub Copilot app, VS Code, Visual Studio, and JetBrains, just to name a few. The good news is that these experiences are increasingly being centralized on the same harness. The details can differ by tool, but the core workflow is consistent. Learn the harness once, use it everywhere. That said, I do believe that learning the harness is key, and the best way to learn it is to be as close to it as possible. So if you are just starting out, Iād recommend beginning with the GitHub Copilot CLI. Itās a terminal interface, which means itās just text. There isnāt much UI to learn. You enter a prompt. The agent does things. But the interaction is more direct, immediate, and, frankly, very satisfying.
For this demonstration, Iāll be using the new GitHub Copilot app. But the harness that app uses is the exact same thing youāll be using if you are using the GitHub Copilot CLI, Visual Studio Code and many other places you can find GitHub Copilot.
YOLO Mode (Allow All)
YOLO mode is also known as āAllow All.ā This lets the agent execute any command without asking permission. This can vary depending on the tool you are using, but for most it is simply an /allow-all command in the chat. Otherwise, the agent is going to stop and wait for your approval every single time it needs to do some work. Agents need autonomy for you to see an increase in productivity. If you have to approve everything the agent does, you might as well just do it yourself. Besides, thatās a miserable user experience. Nobody wants to be relegated to sitting at a desk pressing the āApproveā button all day. And pressing āApproveā over and over just trains you not to read what you are being asked to approve, which defeats the purpose.
You want to be safe with agents, though. Bad things happen to good people. When using YOLO mode, you donāt want to run the agent on your local machine. This is especially true when you are using them at work-data is private on your organizationās systems, and mistakes can be costly. Fortunately there are a bunch of options for running agents in sandboxes. An easy one to get started with is GitHub Codespaces or development containers.
Prototyping
One of the most magical things about AI is that you can easily prototype anything and everything up front. Historically, this was not the case. Prototyping was a full phase of a project, and were often a luxury. Now, you can make one with a prompt. Letās look at a few examples.
Letās say we want to build a date picker web component. That seems straighforward, but itās actually quite complex. Think of all the different things you might want to do with it. Start with a simple prototype and get several variations. I usually start with something like this:
In this case, the AI generated a bunch of different layouts, but one of them is a mock where it starts with the year view. Thatās interesting. I would like my date picker to enable the user to zoom out to the year, then into the month, and finally to the day. These are the kinds of things you donāt consider until you see them. As humans, we process sensory-rich models like images, shapes, and tangible layouts much faster than dense text. Creating low-effort prototypes early on helps make complex concepts immediately intuitive.
And this applies to non-visual tasks as well. For instance, if I want to add a new API endpoint, Iāll still create a visual prototype to understand the requirements and constraints before diving into the implementation.
Create a visual mockup of the API for this project. Add five options for how we could handle a new API endpoint that allows the user to download their analytics data.
Since the GitHub Copilot app supports Mermaid diagrams, the agent renders this as Markdown, mapping out five different ways we could implement this API endpoint. When working with agents, itās easy to forget that everything is nuanced. Prototyping helps uncover the nuances up front, so you avoid spending valuable time and tokens on rework.
I recommend using a medium-sized model, such as GPT 5.6 Terra or Claude Sonnet, on medium reasoning for most work. I also recommend you stick with whatever model you choose here for the duration of this particular feature, bug, or enhancement. Prompt caching will save you tokens. As long as you donāt switch to a different model or reasoning level, your previous chats remain cached with the model, giving you a discount on future requests.
Planning
Now that you know what you actually want versus what you initially thought you wanted, itās time to plan out the implementation. Switch to plan mode in GitHub Copilot without starting a new session.
/plan Build a date picker web component. I want the user to be able to zoom in and out of years, months, and days.
Thatās a pretty vague prompt, and youāll likely have more context for the model than I do here, but this is just a demonstration. If you donāt have more context, itās OK. Thatās exactly what this step is for. In theory, you can get a model to one-shot anything if you compose the perfect prompt with the perfect context in the perfect order. In theory. But none of us can do that. Planning helps you get closer to that ideal, though, by asking all of the questions that you would need to answer yourself along the way if you were to build this out by hand:
- The list goes on and on. You cannot possibly think of all of these edge cases, but the model can help you identify many of them.
You can make plan mode even more aggressive in the sheer number of questions and edge cases it asks about by installing the āgrill-meā skill from Matt Pocock.
/plan /grill-me Build a date picker web component. I want the user to be able to zoom in and out of years, months, and days.
This planning step is critical. The point is not for you to just accept every suggestion from the AI. If you do that, you are negating the value of this planning process. The point is for you to deeply engage with the problem and guide the model. This is where your expertise comes into play. You can also ask the model questions back. In the screenshot below, it asks me about ānon-contiguous dates.ā Iām pretty sure I know what the model means here, but Iām going to ask for clarification so weāre on the same page. The planning process will keep going even if you interrupt to ask clarifying questions, etc.
Once the plan is finished, GitHub Copilot will likely prompt you to switch to Autopilot and start implementing the plan.
Implementation (Autopilot)
Autopilot is a built-in loop. It forces the model to continue working by ensuring that it has actually done what it said it would do-which in this case is completing every item in the plan. GitHub Copilot will automatically act as an orchestrator during this phase. If it needs to read files in the codebase, it will use the āExploreā subagent with a small model. If it deems an action relatively complex, it will likely choose the āGeneral Purposeā subagent with a larger model. While you can get fine-grained control over orchestration in GitHub Copilot with custom agents and instructions, you donāt need to do anything special to get the advantages of subagents and multimodel workflows. This works out of the box, even if you did not know that any of these things existed.
Iteration and Design
This is where you get your dopamine hit. You get to see what the AI has created. But itās likely that you wonāt get exactly what you wanted. Thatās normal and expected. The model cannot read your mind, and it is error-prone. Iterate with the model until you get what you actually want. Whether thatās just code or an improved UI, this is the part where your taste will decide the quality of the final product.
For instance, hereās the date picker that GitHub Copilot gave me. Already I can see it has some issues:
- Also, I donāt love the design. It looks a little too much like it was created by AI-because it was!
So here weāre just in follow-up mode. Iām going to use a CSS framework I created called Postrboard. I add it as a skill that just points to the CSS and tells the agent how to use it. You can feel free to install it yourself if youād like to use it, or you can pick any other CSS framework out there that you like. Giving the model some design guidance is quite helpful, and often a CSS framework is all you need.
ok - we don't need a landing page here - just the component, output and settings panel in a minimal setting. Use the /postboard skill for the design and colors.
For the date picker, when I click on the day, it tries to zoom in, but canāt because there is nothing to zoom to. There should be no zoom there.
It doesnāt need to say āZoom Outā at the top
When I mouse over a month or year that contains the selected day, I cannot read the hover text.
When I click āTodayā it should take me to that day view, even if Iām on the month or the year.
The months donāt need numbers under them and they donāt need to be in boxes
Same goes for years. And it doesnāt need to say ā12 yearsā at the top.
Notice how conversational this is. Donāt overthink it. When youāre fixing a bunch of small things like this, just give it to the model. If youāve got the context, youāve got the prompt. The most important thing is not to settle for AI output that is āgood enough.ā Insist on quality. Be ruthless about it. That part is still your responsibility, and knowing what a quality result is from something that isnāt is the value that you bring. No AI will ever replace your human touch and creativity.
Hereās what my final date picker looks like. Scroll to the end of this post to see it in action.
Rubber Duck Review
After youāve iterated and are happy with what youāve created, itās time to do a final review. Request a Rubber Duck review from GitHub Copilot. You can do this just by asking for it:
Perform a rubber duck review on this date picker component implementation
In a Rubber Duck review, GitHub Copilot will request a review from a model of a different AI family. For instance, since I was using GPT 5.6 Terra, it requested a review from Sonnet. Different models were trained on different data, so they have different blind spots. A Rubber Duck review helps identify potential issues that might be missed by a single model.
Note that you can use this at any point in this workflow. You can rubber duck prototypes. You can rubber duck plans. It all just depends on if you want a second AI review on something.
And if you want to take this a step further, you can combine rubber duck with Autopilot to get the models to work together in a loop to improve the final result.
/autopilot rubber duck this date picker implementation. When you have the result, review it carefully and make any necessary adjustments. Repeat the rubber duck review until both you and the reviewing model agree that the only items that remain have diminishing returns.
After this step, you will have an even more refined result than before and will have likely identified many extra edge cases. This step does cost more tokens, but you are really battle-hardening the code. Think of it as an investment in your future self who wonāt have to deal with these issues because you caught them now.
Final Notes
At this point, youāre ready to stage and commit, or move on to the next feature you want to add along with this pull request. Iād recommend starting a new chat session for anything you do next that doesnāt have to do with this date picker. You can think of chat sessions as being topical; if you start to diverge too much from the main topic, itās probably time for a new session.
Hereās the final result from my workflow building the date picker for this post. I realize that this is a bit of a contrived example, but can we all just pause for a moment and marvel at what weāre able to pull off with AI now? Building a date picker used to be one of the hardest things you could try to do. Just ask any of the heroes out there who have built them.
This simple workflow will be enough for most people. The simplicity also helps you multitask. Itās easier to reason about what agent is in what state and what you were doing last when you keep things simple. Your context window is limited too.
There is so much happening in the AI space right now. There is no upper limit on the things that you can build and experiment with. You can add MCP servers, skills, instructions, and custom agents. You can set up workflows and loops, create agents that prompt agents, and stand up entire virtual dev teams. But keep in mind that nobody really knows what they are doing right now. Weāre all figuring this out as we go. A lot of what is todayās magical incantation for AI will be tomorrowās anti-pattern. Just f
Comments
No comments yet. Start the discussion.