Ask Jody

{
  "$schema": "https://a2aproject.github.io/A2A/specification/json/agent-card-schema.json",
  "name": "Ask Jody",
  "description": "Read-only A2A surface over Jody Brewster's published writing on AI experience architecture. Speaks in third person (he/him) about a body of work, not as the author. Refuses questions outside the corpus.",
  "url": "https://jodybrewster.dev/api/a2a",
  "documentationUrl": "https://jodybrewster.dev/agent",
  "provider": {
    "organization": "Jody Brewster",
    "url": "https://jodybrewster.dev/about"
  },
  "version": "0.1.0",
  "protocolVersion": "0.2.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain",
    "text/markdown"
  ],
  "securitySchemes": {
    "oauth": {
      "type": "oauth2",
      "description": "Declared for forward-compatibility. Not enforced on v0 read skills.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://jodybrewster.dev/api/oauth/authorize",
          "tokenUrl": "https://jodybrewster.dev/api/oauth/token",
          "scopes": {
            "read:writing": "Read published essays, notes, and case briefs."
          }
        }
      }
    }
  },
  "security": [],
  "skills": [
    {
      "id": "discuss_writing",
      "name": "Discuss Jody's writing",
      "description": "Answer questions about what Jody has written, drawing only from his published essays, notes, and case briefs. Third person (he/him). Cites sources by title.",
      "tags": [
        "writing",
        "rag",
        "synthesis",
        "third-person"
      ],
      "examples": [
        "What has Jody written about evaluation as a design discipline?",
        "How does he think about agent handoffs to humans?",
        "What's his position on chat as a UI for AI?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "discuss_collaboration_style",
      "name": "Discuss Jody's practice and collaboration style",
      "description": "Describe how Jody works on AI experience architecture engagements \u2014 process, framings, what he pays attention to \u2014 strictly as expressed in published case briefs and essays.",
      "tags": [
        "practice",
        "process",
        "case-briefs"
      ],
      "examples": [
        "What's Jody's approach when he joins a team that already has an eval harness?",
        "How does he handle design's relationship to engineering on AI features?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "recommend_essays",
      "name": "Recommend essays for a topic",
      "description": "Given a topic or question, return the most relevant essays, notes, and briefs with titles, dates, and URLs. Pure retrieval \u2014 no synthesis.",
      "tags": [
        "search",
        "retrieval",
        "recommendation"
      ],
      "examples": [
        "What should I read if I'm thinking about runtime as a design surface?",
        "Anything on the politics of golden sets?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false
}