Add examples/: agent templates for building on TrueForge

[shubhamagarwal-create]

Adds an examples/ directory with ten example agents people can copy as starting points for building on TrueForge. Each is an agent.json definition plus a README covering what it does, the connectors and skills it uses, the auth and sandbox it needs, sample prompts, how it works, and ways to extend it.

Examples

Example	What it does	Connectors	Auth	Sandbox
security-auditor	Audit a repository for vulnerabilities and file issues	github, exa	GitHub token	yes
claim-red-teamer	Fact-check a claim or answer against sources	exa	none	no
decision-brief	Compare options into a scored, sourced brief	exa or tavily	none / free key	yes
codebase-onboarding	Generate a "start here" guide for a repository	deepwiki, github	GitHub token	yes
ci-fixer	Diagnose and patch a failing pull request	github	GitHub token	yes
db-analyst	Answer questions about a database with SQL and charts	supabase	free account	yes
issue-triage	Turn raw reports into structured tracker issues	linear	free account	yes
incident-investigator	Investigate a Sentry error and write it up	sentry	free account	yes
knowledge-capture	File notes into organized Notion pages	notion	free account	yes
bring-your-own-mcp	Connect a custom HTTP API to an agent (ships a small weather MCP to copy)	your own	none (demo)	yes/no

Notes

• Every example uses connectors that authenticate with no credentials or a self-serve key or free account. No paid plan required.
• Credentials live on the connector in Settings, never in the agent.json, so the specs are safe to share.
• Verified against the schema and validateAgentSpec: all specs parse, and connector/skill names, fields, and setup order match what the harness requires (including configuring skills under Settings → Skills before create).
• bring-your-own-mcp/mcp-server.mjs is a runnable no-auth MCP over Open-Meteo; its endpoints were checked live.

---

Note

Low Risk
Documentation and example specs only; no product runtime, auth, or data-path changes. Write tools in examples are gated by approval in the specs.

Overview
Adds a new examples/ tree of ten copyable agent templates so people can start from real TrueForge specs instead of a blank agent.json.

Each example is an agent.json plus a README (setup, sample prompts, how it works). Specs use catalog connectors with no paid plans, keep credentials out of the files, and demonstrate harness features: sub-agents, Code Mode, skills, write approvals, and generative UI.

Also includes bring-your-own-mcp: a small HTTP MCP (Open-Meteo weather) you can run locally and adapt to a custom API.

^{Reviewed by Cursor Bugbot for commit 314875b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[changeset-bot]

⚠️ No Changeset found

Latest commit: 314875b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR