AGENTS.md

SIN-Code-DataScience

• Team: Team Coding
• Team Manager: A2A-SIN-Coding-CEO
• Slug: sin-code-datascience
• Repo: https://github.com/Delqhi/sin-code-datascience
• Google Doc: https://docs.google.com/document/d/1RtoHn4I0GntuEEOHHkqoh_dMuGzgMwQz7_8oxAOpQbw/edit

Arbeitsregel:

• Jede neue Action muss in runtime.ts, mcp-server.ts, a2a-http.ts, metadata.ts und A2A-CARD.md synchronisiert werden.
• Kein neuer Agent gilt als fertig, wenn Card, Dashboard-Registry und Google-Dokument nicht gemeinsam aktualisiert wurden.
• Jeder neue Agent muss auch agent.json, AGENTS.md, mcp-config.json, clients/opencode-mcp.json, clients/codex-config.toml, .well-known/agent-card.json, .well-known/agent.json, .well-known/oauth-client.json und ggf. einen bin/-Wrapper sauber besitzen.
• Google Docs Child-Tabs immer rekursiv ueber includeTabsContent=true + childTabs aufloesen. Nie nur Top-Level-Tabs pruefen.
• Wenn der Team-Haupt-Tab eine finalisierte A2A-Team-Tabelle hat und dieselbe Tabelle im Silicon Workforce-Tab gespiegelt wird, muessen beide Tabellen synchron gehalten werden. Das finale Tabellen-Schema darf nicht stillschweigend geaendert werden.
• Uebersichtstabellen im Silicon Workforce-Tab verwenden final das Schema: linke Typ-Spalte + Bezeichnung | Zweck | URL.
• Team-Haupttabellen und deren Spiegel im Silicon Workforce-Tab verwenden final das Schema: linke Typ-Spalte + Bezeichnung | Zweck | MCP's | Commands | Endpoints | Server (VM) | CLI's | URL.
• Jeder Team-Haupt-Tab enthaelt nur seine synchronisierte Team-Tabelle; dieselbe Tabelle wird im Silicon Workforce-Tab mit sichtbarer Trennlinie zwischen Team-Sektionen gespiegelt.
• Pflichtfelder fuer neue A2A-Agenten:
  • Identitaet, Team, Team-Manager, Zweck, Verwendung
  • Auth-/Secrets-Modell
  • MCP-Tools und A2A-Actions/Skills
  • Commands, Endpoints, Capabilities, Input/Output-Modi
  • Task-Lifecycle, Observability/Audit, Release/Rollback
  • Owner/Oncall, Dependencies, Deploy-Ziel
• Pflichtintegration:
  • repo .opencode/opencode.json
  • globale OpenCode-MCP-Integration falls benoetigt
  • Dashboard-/Workforce-Registry + Detailseite dashboard-enterprise/app/agents/<slug>/page.tsx
  • a2a.delqhi.com Landing/Card
  • npm run sync:a2a:control-plane-projection nach Registry-Aenderungen
  • Google Docs Child-Tab + Team-Tabellen
  • cloudflared/config.example.yml, wenn der Agent eine oeffentliche Runtime / einen Tunnel bekommen soll
  • echte Runtime-Provisionierung + echter Publish/Deploy-Schritt, sobald oeffentliche URLs/HF/tunnel eingetragen werden
  • scripts/complete-install.sh und scripts/hf_pull_script.py fuer HF-/deploybare Agents
  • Control-Plane-/Capability-Metadaten in agent.json
• Falls der benoetigte Google-Docs-Child-Tab noch nicht existiert, muss er zuerst manuell im Google-Docs-UI erstellt werden. Die Docs-API kann bestehende Tabs pflegen, aber keine neuen Child-Tabs erzeugen.
• Pflichtvalidierung vor Done:
  • Build/Typecheck
  • A2A health/card/rpc
  • MCP smoke
  • relevante Repo-Gates
  • OpenCode-Integration
  • Google-Docs-Sync
  • npm --prefix <agent-root> run build
  • node <agent-root>/dist/src/cli.js print-card
  • node <agent-root>/dist/src/cli.js run-action '{"action":"agent.help"}'
  • node <agent-root>/dist/src/cli.js run-action '{"action":"<namespace>.health"}' anhand der echten Skill-ID aus der Card
  • serve-mcp bleibt mit offenem stdin erreichbar
  • npm run test:a2a:fleet
  • npm run test:a2a:live -- --agent <slug>
  • Landing / publicPageUrl liefert 200
  • Runtime-Host ist real provisioniert
  • /.well-known/agent-card.json liefert 200
  • /a2a/v1 liefert nicht 404
• Ein Agent darf erst auf ready / live gesetzt werden, wenn diese Reachability-Pruefungen bestanden sind und Registry/Card/Docs denselben auditieren Stand zeigen.
• Beim Fuellen der Team-Tabellen muessen alle freigegebenen Spalten gepflegt werden. Platzhalter wie pending formal MCP entry oder pending dedicated child-tab sind nur zulaessig, wenn die jeweilige Surface real noch nicht provisioniert ist.