{
  "id": "workflow:sdk-api-design",
  "_kind": "Workflow",
  "_file": "domain/workflows/workflows-technical-depth.yaml",
  "_cluster": "domain",
  "attributes": {
    "displayName": "SDK / API Design",
    "description": "Collaborative design workflow for creating stable, ergonomic public SDK and API\ninterfaces that will be consumed by external developers or internal platform teams.\nThe platform engineer drafts an interface proposal covering method signatures, data\nmodels, error semantics, versioning strategy, and backward compatibility guarantees.\nThe architect reviews the proposal for consistency with existing platform conventions\nand long-term extensibility. Iterative feedback rounds incorporate input from potential\nconsumers before the interface is frozen. Final design documentation and code stubs\nare committed as the authoritative contract ahead of implementation.\n",
    "workflowKind": "development",
    "triggerType": "on-demand",
    "typicalCadence": "per-feature",
    "complexity": "complex"
  },
  "outgoingEdges": [
    {
      "from": "workflow:sdk-api-design",
      "to": "role:platform-engineer",
      "kind": "involves_role"
    },
    {
      "from": "workflow:sdk-api-design",
      "to": "role:architect",
      "kind": "involves_role"
    },
    {
      "from": "workflow:sdk-api-design",
      "to": "role:tech-lead",
      "kind": "involves_role"
    },
    {
      "from": "workflow:sdk-api-design",
      "to": "role:technical-writer",
      "kind": "involves_role"
    },
    {
      "from": "workflow:sdk-api-design",
      "to": "domain:software-engineering",
      "kind": "applies_to_domain"
    }
  ],
  "incomingEdges": [
    {
      "from": "stack-profile:sdk-developer-kit",
      "to": "workflow:sdk-api-design",
      "kind": "follows_workflow"
    },
    {
      "from": "stack-profile:plugin-extension-system",
      "to": "workflow:sdk-api-design",
      "kind": "follows_workflow"
    },
    {
      "from": "lib-process:cli-mcp-development--argument-parser-setup",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-application-bootstrap",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-binary-distribution",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-command-structure-design",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-documentation-generation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-output-formatting",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-unit-integration-testing",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cli-update-mechanism",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--configuration-management-system",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--cross-platform-cli-compatibility",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--dashboard-monitoring-tui",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--error-handling-user-feedback",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--interactive-form-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--interactive-prompt-system",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-client-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-resource-provider",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-server-bootstrap",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-server-monitoring-debugging",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-server-registry-discovery",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-server-security-hardening",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-server-testing-suite",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-tool-documentation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-tool-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--mcp-transport-layer",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--package-manager-publishing",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--plugin-architecture-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--progress-status-indicators",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--shell-completion-scripts",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--shell-script-development",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:cli-mcp-development--tui-application-framework",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--bytecode-vm-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--code-generation-llvm",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--concurrency-primitives",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--error-message-enhancement",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--ffi-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--garbage-collector-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--generics-polymorphism",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--interpreter-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--jit-compiler-development",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--lexer-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--lsp-server-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--macro-system-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--parser-development",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--pattern-matching-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--repl-development",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--semantic-analysis",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--source-map-generation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    },
    {
      "from": "lib-process:programming-languages--type-system-implementation",
      "to": "workflow:sdk-api-design",
      "kind": "lib_implements_workflow",
      "attributes": {
        "weight": 1
      }
    }
  ]
}