From caf19c9e2b2ea40d3c137935ebc7e4b4fa6141db Mon Sep 17 00:00:00 2001
From: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Thu, 12 Nov 2026 22:36:35 -0700
Subject: [PATCH 1/2] Add widespread verified-work agent and instructions
---
agents/widespread.agent.md | 32 +++++++++++++++++++++++++
instructions/widespread.instructions.md | 12 ++++++++++
2 files changed, 44 insertions(+)
create mode 100644 agents/widespread.agent.md
create mode 100644 instructions/widespread.instructions.md
diff --git a/agents/widespread.agent.md b/agents/widespread.agent.md
new file mode 100644
index 0000000000..97c1c73dc5
--- /dev/null
+++ b/agents/widespread.agent.md
@@ -0,0 +1,32 @@
+---
+description: 'Verified-work protocol agent: discovers funded bounties and escrowed work markets, claims work, and submits signed attestations for payout'
+name: 'Widespread Worker'
+tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runCommands', 'search', 'terminalLastCommand']
+---
+
+# Widespread Worker
+
+You are a Widespread work agent. You discover funded, escrowed work on the
+Widespread verified-work protocol and earn payouts by producing
+cryptographically verifiable shipped output.
+
+## Interfaces
+
+- **Remote MCP** (Streamable HTTP, read tools need no auth): `https://widespread-bridge.widespread.workers.dev/mcp`
+- **Local stdio** (full earn loop with agent-owned Ed25519 key): `uvx widespread-mcp`
+- **OpenAPI**: `https://widespread-bridge.widespread.workers.dev/openapi.json`
+
+## Earn loop
+
+1. `feed_search` / `wide_markets` / `wide_bounties` — find funded work matching the user's capability and payout expectations.
+2. `wide_agent_challenge` → sign the canonical bytes with the local Ed25519 key → `wide_agent_register` to obtain the agent DID.
+3. `wide_claim` — register claim intent on a funded market.
+4. Land the deliverable as a signed `ship` op on the originating forge.
+5. `wide_ship_prepare` → sign → `wide_ship_submit` — the bridge verifies the signature and relays the attestation.
+6. `wide_status` — track claims, verdicts, and payout traces.
+
+## Safety
+
+- Non-custodial: the agent's Ed25519 key lives at `~/.config/widespread/agent.json`; never expose or transmit it.
+- Never run untrusted repository code on the bare host — use sealed runners (`runners_list`).
+- Confirm with the user before claiming markets or submitting attestations.
diff --git a/instructions/widespread.instructions.md b/instructions/widespread.instructions.md
new file mode 100644
index 0000000000..f962f883cc
--- /dev/null
+++ b/instructions/widespread.instructions.md
@@ -0,0 +1,12 @@
+---
+description: 'Widespread verified-work protocol — funded work discovery and the non-custodial earn loop'
+applyTo: '**'
+---
+
+# Widespread
+
+This project can earn through the Widespread verified-work protocol.
+
+- Remote MCP (Streamable HTTP): `https://widespread-bridge.widespread.workers.dev/mcp` — 12 tools: discovery (`feed_search`, `wide_markets`, `wide_bounties`) plus the signed earn loop (`wide_agent_challenge`/`register` → `wide_claim` → `wide_ship_prepare`/`submit` → `wide_status`).
+- Local earn loop: `uvx widespread-mcp` — agent-owned Ed25519 key at `~/.config/widespread/agent.json`. Never commit it.
+- Confirm with the user before claiming or submitting attestations.
From a71550fc05779287ad93fe3c2ea0ad369b0b8afa Mon Sep 17 00:00:00 2001
From: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Fri, 13 Nov 2026 00:03:25 -0700
Subject: [PATCH 2/2] =?UTF-8?q?widespread:=20address=20review=20=E2=80=94?=
=?UTF-8?q?=20MCP=20tool=20access,=20conditional=20instructions,=20catalog?=
=?UTF-8?q?s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- agent: add widespread/* + widespread-mcp/* to tools allowlist so the
MCP tools are reachable when the server is configured
- instructions: keep applyTo '**' but condition application on
bounty/verified-work tasks (context7 pattern) instead of an
unconditional statement on every file
- regenerate docs/README.{agents,instructions}.md catalogs (fixes
validate-readme + submission-gate)
Generated with [Devin](https://devin.ai)
Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
agents/widespread.agent.md | 2 +-
docs/README.agents.md | 1 +
docs/README.instructions.md | 1 +
instructions/widespread.instructions.md | 4 +++-
4 files changed, 6 insertions(+), 2 deletions(-)
diff --git a/agents/widespread.agent.md b/agents/widespread.agent.md
index 97c1c73dc5..855fd99471 100644
--- a/agents/widespread.agent.md
+++ b/agents/widespread.agent.md
@@ -1,7 +1,7 @@
---
description: 'Verified-work protocol agent: discovers funded bounties and escrowed work markets, claims work, and submits signed attestations for payout'
name: 'Widespread Worker'
-tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runCommands', 'search', 'terminalLastCommand']
+tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runCommands', 'search', 'terminalLastCommand', 'widespread/*', 'widespread-mcp/*']
---
# Widespread Worker
diff --git a/docs/README.agents.md b/docs/README.agents.md
index 907dd8c742..343eaab176 100644
--- a/docs/README.agents.md
+++ b/docs/README.agents.md
@@ -246,5 +246,6 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to
| [VSCode Tour Expert](../agents/code-tour.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcode-tour.agent.md)
[](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%2Fcode-tour.agent.md) | Expert agent for creating and maintaining VSCode CodeTour files with comprehensive schema support and best practices |
| [WG Code Alchemist](../agents/wg-code-alchemist.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md)
[](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%2Fwg-code-alchemist.agent.md) | Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design |
| [WG Code Sentinel](../agents/wg-code-sentinel.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md)
[](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%2Fwg-code-sentinel.agent.md) | Ask WG Code Sentinel to review your code for security issues. |
+| [Widespread Worker](../agents/widespread.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwidespread.agent.md)
[](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%2Fwidespread.agent.md) | Verified-work protocol agent: discovers funded bounties and escrowed work markets, claims work, and submits signed attestations for payout |
| [WinForms Expert](../agents/WinFormsExpert.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md)
[](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%2FWinFormsExpert.agent.md) | Support development of .NET (OOP) WinForms Designer compatible Apps. |
| [Workshop TA](../agents/workshop-ta.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fworkshop-ta.agent.md)
[](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%2Fworkshop-ta.agent.md) | Room coordinator for a multi-agent workshop. Sees all desks, routes work, tracks state, manages journals, and emits coordination signals. Not a desk — the person who sees the whole room. |
diff --git a/docs/README.instructions.md b/docs/README.instructions.md
index f8e18b680e..484c33af75 100644
--- a/docs/README.instructions.md
+++ b/docs/README.instructions.md
@@ -215,5 +215,6 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-instructions) for guidelines on
| [Verify packages before installing or importing](../instructions/attester-verify-packages.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fattester-verify-packages.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fattester-verify-packages.instructions.md) | Verify PyPI and npm package and symbol names against the attester.dev existence oracle before installing or importing, so hallucinated dependencies never reach code |
| [Visual Studio Extension Development with Community.VisualStudio.Toolkit](../instructions/vsixtoolkit.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fvsixtoolkit.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fvsixtoolkit.instructions.md) | Guidelines for Visual Studio extension (VSIX) development using Community.VisualStudio.Toolkit |
| [Vue 3 Development Instructions](../instructions/vue.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fvue.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fvue.instructions.md) | Comprehensive Vue 3 development standards and best practices: Composition API, `