Title: PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec · Issue #511 · github/squad · GitHub
Open Graph Title: PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec · Issue #511 · github/squad
X Title: PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec · Issue #511 · github/squad
Description: PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec Author: Dina's Squad (Flight, EECOM, CONTROL, RETRO, FIDO, PAO) Status: Team-reviewed (v2, all 29 blockers addressed) Related: #485 (Agent Spec and Validation), #...
Open Graph Description: PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec Author: Dina's Squad (Flight, EECOM, CONTROL, RETRO, FIDO, PAO) Status: Team-reviewed (v2, all 29 blockers addressed) Rela...
X Description: PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec Author: Dina's Squad (Flight, EECOM, CONTROL, RETRO, FIDO, PAO) Status: Team-reviewed (v2, all 29 blockers addressed) ...
Opengraph URL: https://github.com/github/squad/issues/511
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec","articleBody":"## PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec\n\n**Author:** Dina's Squad (Flight, EECOM, CONTROL, RETRO, FIDO, PAO)\n**Status:** Team-reviewed (v2, all 29 blockers addressed)\n**Related:** #485 (Agent Spec and Validation), #332 (A2A Protocol), #481 (StorageProvider)\n\n---\n\n### The pitch\n\nNo portable, typed agent specification exists today. Each framework (M365 Copilot, AutoGen, CrewAI, Semantic Kernel, Squad) defines agents differently. **@agentspec/core is the OpenAPI equivalent for agent definitions** — a TypeSpec library + emitter that defines universal agent primitives and produces a canonical agent manifest.\n\n### Two phases\n\n**Phase 1: `@agentspec/core` — The open standard (~1.5 weeks)**\n- TypeSpec library defining 12 universal decorators: `@agent`, `@role`, `@instruction`, `@capability`, `@boundary`, `@tool`, `@knowledge`, `@conversationStarter`, `@memory`, `@version`, `@inputMode`, `@outputMode`\n- Emitter producing `agent-manifest.json` (canonical format) + `agent-manifest.schema.json` (JSON Schema for validation without TypeSpec)\n- `model AgentManifest` TypeSpec type as single source of truth\n- Security: `@instruction` omitted from A2A cards by default, PII compiler diagnostics, sensitivity field\n- Package: `@agentspec/core` on npm (2FA + provenance attestation required)\n\n**Phase 2: Squad emitters (~2.5 weeks)**\n- `@bradygaster/typespec-squad` — Squad extensions (`@casting`, `@routing`, `@ceremony`) → charter.md, team.md, routing.md, registry.json\n- `@bradygaster/typespec-squad-copilot` — Copilot SDK extensions (`@model`) → squad.config.ts, copilot-instructions.md\n- Parallel path to existing `squad build` (not a replacement)\n- Generates `AgentDefinition` TypeScript type from TypeSpec into `builders/generated/types.ts`\n\n### The layer architecture\n\n`\n@agentspec/core \u003c- open standard (12 decorators)\n |\n +-- @bradygaster/typespec-squad \u003c- Squad extensions\n | +-- @bradygaster/typespec-squad-copilot \u003c- Copilot SDK target\n | +-- @bradygaster/typespec-squad-mcp \u003c- MCP server scaffolding (future)\n | +-- @bradygaster/typespec-squad-a2a \u003c- A2A protocol types (future)\n |\n +-- (community emitters for AutoGen, CrewAI, Semantic Kernel, etc.)\n`\n\n### Prerequisites (do now)\n- [ ] Register `agentspec` npm org (before someone else takes it)\n- [ ] Confirm TypeSpec team is aware and supportive\n\n### Key decisions made by team review\n- Casting stays in Squad layer (not base) — it is implementation flavor, not universal\n- `@model` is Copilot-specific (not base)\n- TypeSpec peer dep minor-locked (`>=0.60.0 \u003c0.62.0`)\n- Emitter uses `program.host.writeFile` only (no raw `fs`)\n- `AgentDefinition.name` maps to manifest `id` via translation table\n- Phase 2 effort includes sub-emitter split and `squad.config.ts` codegen complexity\n\n### Competitive position\nNo one has done this. Microsoft's `@microsoft/typespec-m365-copilot` is M365-locked. Oracle Agent Spec is YAML. OASF is JSON. **A TypeSpec-based portable agent spec that compiles to any framework is unoccupied territory.**\n\n### Full PRD\nThe complete PRD v2 (~500 lines, all 29 review items addressed) is at `.squad/decisions/inbox/pao-agentspec-typespec-prd-v2.md` on the dev branch.\n\n---\n\nsquad obo dina — this PRD was produced by Flight (Lead), reviewed by EECOM, CONTROL, RETRO, FIDO, written by PAO, revised by Flight after 4 rejection reviews with 29 blockers fixed.","author":{"url":"https://github.com/diberry","@type":"Person","name":"diberry"},"datePublished":"2026-03-22T18:30:26Z","url":"https://github.com/github/squad/issues/511"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:0dbd81f4-3723-7691-4317-1d10cbf1e337 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 8BBE:CC1A4:20D9C25:29BB82D:6B016FE3 |
| html-safe-nonce | 1a84044891a0878799703dde571b9b7c4a0c872991a2e551e26485aa620b8b92 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4QkJFOkNDMUE0OjIwRDlDMjU6MjlCQjgyRDo2QjAxNkZFMyIsInZpc2l0b3JfaWQiOiI3ODYyMzMyMzkxODYyMzk4OTQ4IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 7b0a0cb903763fd0e58c51145d2e02d92f2d32321e877ebd412b5fb29f223475 |
| hovercard-subject-tag | issue:4116734629 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/511/issue_layout |
| twitter:image | https://opengraph.githubassets.com/33f8fa84e88030b3b802d8a76f712c19f8cf86968ab53433b90777f385125068/github/squad/issues/511 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/33f8fa84e88030b3b802d8a76f712c19f8cf86968ab53433b90777f385125068/github/squad/issues/511 |
| og:image:alt | PRD: @agentspec/core — Framework-Agnostic Agent Specification via TypeSpec Author: Dina's Squad (Flight, EECOM, CONTROL, RETRO, FIDO, PAO) Status: Team-reviewed (v2, all 29 blockers addressed) Rela... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | diberry |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width