Remove external forgewright repo reference; fix agent name/filename validator errors

- Made the skill self-contained: replaced the pointer to the companion
  lordlinus/forgewright repo (scripts/new-app.sh, vendored reference/dojo/)
  with an inline project layout and direct upstream source citations
  (microsoft/agent-framework, ag-ui-protocol/ag-ui).
- Renamed the agent from 'Forgewright App Builder' to
  'foundry-hosted-agent-copilotkit' (lowercase-hyphen, matches the
  .agent.md filename) to fix the two validator errors reported by CI.
- Dropped the 'Forgewright' persona/branding throughout the skill and
  agent files.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: lordlinus

agents/foundry-hosted-agent-copilotkit.agent.md

@@ -2,11 +2,11 @@
 description: 'Builds a complete agentic web app on the Azure AI Foundry hosted-agent + AG-UI + CopilotKit stack — a Next.js/CopilotKit v2 UI over a light FastAPI/AG-UI bridge forwarding to ONE Microsoft Agent Framework agent hosted in Foundry, with native human-in-the-loop approval on consequential tools. Requires an Azure AI Foundry project (paid).'
 model: 'gpt-5'
 tools: ['codebase', 'terminalCommand']
-name: 'Forgewright App Builder'
+name: 'foundry-hosted-agent-copilotkit'
 ---
 
-You are **Forgewright**, an expert builder of agentic web apps on the **Azure AI
-Foundry hosted-agent + AG-UI + CopilotKit** stack. From a single prompt ("build me an
+You are an expert builder of agentic web apps on the **Azure AI Foundry
+hosted-agent + AG-UI + CopilotKit** stack. From a single prompt ("build me an
 assistant that can … with approval before …") you produce a complete, runnable,
 verified app — you do the work, you do not hand the user manual steps.
 
@@ -26,8 +26,9 @@ anti-patterns, and Definition of Done exactly.
 
 ## Your workflow
 
-1. **Scaffold** the canonical template into a new runnable app (never start from a
-   blank repo).
+1. **Scaffold** the project layout described in the skill's `SKILL.md` and
+   `references/` (Next.js/CopilotKit v2 frontend, light FastAPI/AG-UI bridge,
+   `src/agent.py` hosted-agent brain) — never start from an ad-hoc layout.
 2. **Customize only the marked extension points**: agent instructions + tools (≥1 read
    tool, ≥1 `@tool(approval_mode="always_require")` consequential tool) and the
    CopilotKit components. Map "needs approval before X" to the gated tool.

docs/README.agents.md

@@ -99,7 +99,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to
 | [Expert React Frontend Engineer](../agents/expert-react-frontend-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md) | Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization |  |
 | [Expert Vue.js Frontend Engineer](../agents/vuejs-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvuejs-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvuejs-expert.agent.md) | Expert Vue.js frontend engineer specializing in Vue 3 Composition API, reactivity, state management, testing, and performance with TypeScript |  |
 | [Fedora Linux Expert](../agents/fedora-linux-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md) | Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows. |  |
-| [Foundry Hosted Agent Copilotkit](../agents/foundry-hosted-agent-copilotkit.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffoundry-hosted-agent-copilotkit.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffoundry-hosted-agent-copilotkit.agent.md) | Builds a complete agentic web app on the Azure AI Foundry hosted-agent + AG-UI + CopilotKit stack — a Next.js/CopilotKit v2 UI over a light FastAPI/AG-UI bridge forwarding to ONE Microsoft Agent Framework agent hosted in Foundry, with native human-in-the-loop approval on consequential tools. Requires an Azure AI Foundry project. |  |
+| [Foundry Hosted Agent Copilotkit](../agents/foundry-hosted-agent-copilotkit.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffoundry-hosted-agent-copilotkit.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffoundry-hosted-agent-copilotkit.agent.md) | Builds a complete agentic web app on the Azure AI Foundry hosted-agent + AG-UI + CopilotKit stack — a Next.js/CopilotKit v2 UI over a light FastAPI/AG-UI bridge forwarding to ONE Microsoft Agent Framework agent hosted in Foundry, with native human-in-the-loop approval on consequential tools. Requires an Azure AI Foundry project (paid). |  |
 | [Frontend Performance Investigator](../agents/frontend-performance-investigator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffrontend-performance-investigator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffrontend-performance-investigator.agent.md) | Runtime web-performance specialist for diagnosing Core Web Vitals, Lighthouse regressions, layout shifts, long tasks, and slow network paths with Chrome DevTools MCP. |  |
 | [Gem Browser Tester](../agents/gem-browser-tester.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-browser-tester.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-browser-tester.agent.md) | E2E browser testing, UI/UX validation, visual regression. |  |
 | [Gem Code Simplifier](../agents/gem-code-simplifier.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-code-simplifier.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-code-simplifier.agent.md) | Refactoring specialist — removes dead code, reduces complexity, consolidates duplicates. |  |

skills/foundry-hosted-agent-copilotkit/SKILL.md

@@ -3,7 +3,7 @@ name: foundry-hosted-agent-copilotkit
 description: "Build a complete agentic web app on the Azure AI Foundry hosted-agent + AG-UI + CopilotKit stack: a Next.js/CopilotKit v2 chat UI over a light FastAPI/AG-UI bridge that forwards every turn to ONE Microsoft Agent Framework agent hosted in Azure AI Foundry, with native human-in-the-loop approval on consequential tools. Requires an Azure AI Foundry project (paid). Triggers: agentic app, CopilotKit app, AG-UI bridge, Foundry hosted agent, Microsoft Agent Framework, human-in-the-loop/HITL approval, approval_mode always_require, confirm_changes. Also for fixing the known traps: HITL approve-resume 400 'No tool output found', confirm_changes mis-wired, AG-UI snapshot cards vanishing, CopilotKit catch-all route 404/422, useSingleEndpoint, keyless Foundry 401 audience, Docker Hub rate-limit on ACR build."
 ---
 
-# Forgewright — Foundry hosted agent + AG-UI + CopilotKit apps
+# Foundry hosted agent + AG-UI + CopilotKit apps
 
 Build an agentic web app on the **hosted-agent-first** standard: ALL intelligence
 (`FoundryChatClient` + tools + HITL + history) runs in an **Azure AI Foundry HOSTED
@@ -49,23 +49,31 @@ passes for the patterns in scope. Never declare success on an unverified build.
 - `LOAD references/hosted-deploy.md` — Foundry hosted-agent deploy gotchas (azd,
   remote build, dependency pinning).
 
-The canonical, runnable template + scaffolding scripts live in the companion repo
-**[lordlinus/forgewright](https://github.com/lordlinus/forgewright)** under
-`templates/agentic-copilot-foundry/`, with vendored AG-UI dojo source under
-`reference/dojo/`. Read both before changing anything; do not reinvent the bridge,
-the patches, or the state machinery.
+Read all four reference docs before writing any code; they encode the
+load-bearing rules, the framework traps, and the Definition of Done that keep
+this stack correct — do not reinvent the bridge, the patches, or the state
+machinery from scratch each time.
 
 ## 1. Scaffold (always start here)
 
-Instantiate the canonical template into a new, runnable app (lowercase-hyphen name)
-and rewrite the agent-name tokens (`AGENT_NAME`, the CopilotKit agent, the route, the
-hosted yaml) so they stay consistent:
+Create the project with this layout (lowercase-hyphen app name), then wire it
+per the architecture in `references/architecture.md`:
 
-```bash
-scripts/new-app.sh <app-name> [target-dir]    # from the forgewright repo
+```
+<app-name>/
+  frontend/            # Next.js + CopilotKit v2
+    app/api/copilotkit/[[...slug]]/route.ts   # catch-all bridge route
+    components/                                # useAgent / useFrontendTool /
+                                                # useRenderTool / useHumanInTheLoop
+  backend/
+    bridge_app.py       # HostedProxyAgent — forwards turns + mcp_approval_response
+    src/agent.py         # build_hosted_agent() -> FoundryChatClient (Responses)
+  azure.yaml / infra/    # azd config to provision + publish the hosted agent
 ```
 
-The result already runs and already passes the bridge end-to-end smoke check.
+Keep the agent-name token (`AGENT_NAME`, the CopilotKit agent id, the route, the
+hosted yaml) consistent across every file. The result must run end-to-end and
+pass the checks in step 3 before you customize anything.
 
 ## 2. Customize to the user's prompt — extension points
 

skills/foundry-hosted-agent-copilotkit/references/patterns-7.md

@@ -2,8 +2,8 @@
 
 These are the AG-UI dojo "Microsoft Agent Framework Python" feature patterns,
 adapted to our standard (intelligence in the Foundry HOSTED agent; a light bridge;
-CopilotKit **v2** UI hooks). Canonical source is vendored under `reference/dojo/`:
-backend agents from `microsoft/agent-framework`
+CopilotKit **v2** UI hooks). Canonical source: backend agents from
+`microsoft/agent-framework`
 (`python/packages/ag-ui/agent_framework_ag_ui_examples/agents/*`) and the v2
 frontend pages from `ag-ui-protocol/ag-ui`
 (`apps/dojo/src/app/[integrationId]/feature/(v2)/*`).