AGENTS.md — Works With Agents

Open specifications and SDKs for AI agent interoperability. 17 protocol specifications — communication, identity, skills, trust, economics, compliance. CC BY 4.0.

Architecture

workswithagents.dev (main portal)
├── Cloudflare Worker: proxy → VPS
├── Hetzner VPS: Node/Fastify frontend (port 8610, systemd: wwa-ts)
│   └── TSX server-side rendering (@kitajs/html), blog, benchmarks, all pages
├── Hetzner VPS: Python/FastAPI legacy API (port 8499, systemd: wwa-dev)
├── .com, .co.uk, .io → 301 redirect to .dev
└── Bastion Gateway: /admin on same VPS (port 8500)

Key files

• README.md — public brand overview
• DEPLOY.md — deployment runbook (Cloudflare + Hetzner)
• MOATS-PLAN.md — 16-moat standards strategy
• market-validation.md — market research and competitor analysis
• deploy.sh — one-shot hybrid deploy script
• .dev/AGENTS.md — API-level agent discovery (endpoints, FactBase, skill registry)
• .dev/ts-api/src/index.ts — Fastify application (canonical source)
• .dev/ts-api/src/routes/pages.ts — all page routes (homepage, blog, benchmarks, learn, specs)
• .dev/blog/ — blog posts as markdown files with YAML frontmatter

Directory map

Directory	Purpose
.dev/	Main portal — ts-api (Fastify+TSX), blog/, specs/, static/
.com/, .co.uk/	Static redirects → .dev (Cloudflare Pages)
.io/	301 redirect → .dev (nginx on Hetzner VPS)
docs/	Course outline, launch package, architecture docs
engine/	Agent engine — flow compiler, process parser, validator
methodology/	10 patterns — lesson pages, Learn content (free, no paywall)
sdk/	Python + TypeScript + Go + C# + Rust + Shell SDK references
tools/	CLI tooling — API Integrity Auditor, compliance proxy

SDK packages

• Python: pip install workswithagents (PyPI: workswithagents)
• TypeScript: npm install @workswithagents/agent-foundry
• Source: github.com/workswithagents/works-with-agents

Deployment

# TS API (Hetzner VPS) — deploy and restart
rsync -avz --exclude 'node_modules' \
  ~/Agent-Projects/works-with-agents/.dev/ts-api/src/ \
  ~/Agent-Projects/works-with-agents/.dev/blog/ \
  [email protected]:/opt/works-with-agents/.dev/
ssh [email protected] "systemctl restart wwa-ts"

# Static Redirects (Cloudflare Pages)
cd ~/Agent-Projects/works-with-agents && ./deploy.sh

Contact

Vilius Vystartas — Technical Pelin Kayhan — Business & Compliance