feat(content): update GitHub Copilot lessons article with new insights and specifications

Author: TechWatching

content/1.posts/77.github-copilot-lessons-nuxt-blog.md

@@ -1,23 +1,64 @@
 ---
 title: 8 GitHub Copilot lessons learned upgrading my Nuxt blog
-description: Practical insights and lessons from using GitHub Copilot to upgrade a Nuxt blog.
-date: 2026-01-04
+description: Practical insights and lessons from using GitHub Copilot
+date: 2026-03-01
 image:
   src: /images/placeholder_1.jpg
 badge:
-  label: Essay
+  label: Development
 tags:
   - GitHub Copilot
   - Nuxt
   - AI
   - tooling
 ---
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+Last December, I upgraded my Nuxt blog with the help of GitHub Copilot and I learned 8 lessons about using AI-assisted development that I want to share.
 
-## Section Title
+## Plan your changes
+
+Whether it's a technology upgrade, a complex feature to implement or a complete redesign, it's important to ask your AI assistant to plan the complex changes before implementing them. It does not matter if you use the [built-in Plan agent](https://code.visualstudio.com/docs/copilot/agents/planning), a custom agent or just a simple prompt, asking your AI assistant to plan the changes will help you identify the AI mistakes, see what could be improved, and challenge the assistant.
+
+For my blog upgrade, GitHub Copilot gave me a checklist with the differents seps of the process and it was very useful
+
+## Specifications matter
+
+With AI assistants, it's easy to quickly generate code that works, and with latest models this code is often not that bad. However it's less easy to generate code that does exactly what you want without clear specifications. So provide your requirements to your AI assistant.
+
+My blog is based on the [Nuxt UI SaaS template](https://ui.nuxtjs.org/) that I modified to fit my needs. But I completely forgot how much I modified it and how much the template has evolved since I started. To start the website from scratch, I needed to reverse engineering my website specifications. I knew that Copilot would be able to analyze my website thanks to [Playwright MCP](https://github.com/microsoft/playwright-mcp) which can automate browser. So I created a agent that could do that for me: ["Website RetroSpec Generator"](https://github.com/TechWatching/copilot-goodies/blob/main/agents/website-retrospec-generator.agent.md).
+
+```md [website-retrospec-generator.agent.md]
+---
+name: website-retrospec-generator
+description: Generate comprehensive retro specifications of live websites by browsing with Playwright MCP, capturing structure, content, functionality, and creating architectural documentation.
+argument-hint: "Share the URL, scope (sections/flows), format, credentials, and any constraints before starting."
+tools: ['edit/createFile', 'edit/createDirectory', 'edit/editFiles', 'search/fileSearch', 'search/readFile', 'microsoft/playwright-mcp/*']
+handoffs:
+  - label: Deeper Exploration
+    agent: website-retrospec-generator
+    prompt: Ask if the user wants to explore specific areas in more depth.
+    send: false
+  - label: Visual Diagrams
+    agent: agent
+    prompt: Offer to generate visual diagrams or flowcharts.
+    send: false
+---
+
+# Website RetroSpec Generator
+
+You are an expert in reverse engineering website specifications by analyzing live websites through browser automation. [....]
+```
+
+::callout{icon="i-heroicons-chat-bubble-left-20-solid"}
+If I was doing it today, I would probably use a skill with [Playwright CLI](https://github.com/microsoft/playwright-cli) instead of Playwright MCP for token efficiency and simplicity.
+::
+
+If you need a guided process to create your specifications and have AI implement your changes from there, the [GitHub Spec Kit project](https://github.com/github/spec-kit) is an interesting tool to have a Specification-Driven Development (SDD) approach.
+
+## Use the appropriate MCP Servers
+
+## Use Git Worktrees
 
-Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
 
 ![Image description](/posts/images/77.github-copilot-lessons-nuxt-blog_1.png){.rounded-lg .mx-auto}