{
  "uid": "cogitave.learn.api-design.summary",
  "kind": "moduleUnit",
  "href": "/modules/api-design/summary/",
  "title": "Summary",
  "summary": "",
  "type": null,
  "products": [],
  "roles": [],
  "levels": [],
  "subjects": [],
  "headings": [
    "Next steps"
  ],
  "source": "You can now shape a Cogitave contract surface and evolve it without breaking the\npeople and agents that depend on it.\n\nIn this module, you:\n\n- Separated the two questions Cogitave keeps apart: how a contract is **shaped**\n  (the API design standard) and how it **changes over time** (the\n  versioning-and-deprecation standard), settled by ADR-0019 (design) and\n  ADR-0015 (versioning) respectively.\n- Designed **contract-first**, modeling resources with standard methods, one\n  canonical casing per place, and a custom method only when an action is not CRUD.\n- Applied the non-deviable invariants - the **RFC 9457** error model with a\n  stable `code`, **cursor pagination** with bounds, and **idempotency** on\n  creating writes - and learned that one concept has one shape across HTTP, gRPC,\n  GraphQL, and MCP.\n- Picked the right versioning scheme per surface, kept changes **additive**, and\n  walked a contract through `preview -> active -> deprecated -> sunset -> retired`\n  with one manifest keeping the API, docs, and changelog in lockstep - under\n  **never break userspace without consent**.\n\n## Next steps\n\n- @cogitave.learn.configuration-management - the next module in **Cogitave\n  engineering standards**, on classifying config from secrets and keeping both\n  out of git.\n- The **API design standard** is the canonical detail on modeling, errors,\n  pagination, idempotency, and per-protocol conventions - the source of truth\n  in the estate's standards repository; read it before you author a surface.\n- The **versioning-and-deprecation standard** is the canonical reference for\n  the full lifecycle, the N-version window, and the deprecation manifest\n  schema, in the same repository.\n- **ADR-0019** and **ADR-0015** are the estate's recorded decisions: ADR-0019\n  settled one shape across four protocols, and ADR-0015 settled how a\n  contract changes over time.\n",
  "partOf": "cogitave.learn.api-design",
  "durationInMinutes": 3,
  "quiz": null
}