# Why SDD Breaks Down in Microservices: Part 2. Why I Built Archspec to Keep Service Context Explicit

Page: https://stenobird.com/podcast/programming-tech-brief-by-hackernoon-6364125/why-sdd-breaks-down-in-microservices-part-2-why-i-built-archspec-to-keep-service-context-explicit
Text version: https://stenobird.com/podcast/programming-tech-brief-by-hackernoon-6364125/why-sdd-breaks-down-in-microservices-part-2-why-i-built-archspec-to-keep-service-context-explicit.md
Podcast: [Programming Tech Brief By HackerNoon](https://stenobird.com/podcast/programming-tech-brief-by-hackernoon-6364125)
Published: 2026-05-28T16:00:45+00:00
Episode link: https://share.transistor.fm/s/43b69ce4
Audio file: https://media.transistor.fm/43b69ce4/b1734277.mp3
Processing state: not_requested
JSON: https://stenobird.com/v1/public/podcasts/programming-tech-brief-by-hackernoon-6364125/episodes/why-sdd-breaks-down-in-microservices-part-2-why-i-built-archspec-to-keep-service-context-explicit
Duration seconds: 929

## Resource

This story was originally published on HackerNoon at: https://hackernoon.com/why-sdd-breaks-down-in-microservices-part-2-why-i-built-archspec-to-keep-service-context-explicit . I built archspec, an open source Claude Code plugin that turns microservice architecture rules into YAML contracts, docs, diagrams, and commit checks. Check more stories related to programming at: https://hackernoon.com/c/programming . You can also check exclusive content about #software-architecture , #microservices , #spec-driven-development , #claude-code , #ai-coding , #developer-tools , #system-design , #open-source , and more. This story was written by: @krus210 . Learn more about this writer by checking @krus210's about page, and for more stories, please visit hackernoon.com . Part 1 showed how LLM-generated specs lose the rules between microservices. Part 2 introduces archspec, an open source Claude Code plugin that initializes a YAML service contract, generated architecture docs, Mermaid diagrams, and pre-commit checks so idempotency, Outbox, consumers, and service links stay explicit.

## Actions

- request_transcript: `POST https://stenobird.com/v1/public/podcasts/programming-tech-brief-by-hackernoon-6364125/episodes/why-sdd-breaks-down-in-microservices-part-2-why-i-built-archspec-to-keep-service-context-explicit/transcription-requests` — Idempotently request low-priority transcript generation for this episode.
- read_markdown: `GET https://stenobird.com/podcast/programming-tech-brief-by-hackernoon-6364125/why-sdd-breaks-down-in-microservices-part-2-why-i-built-archspec-to-keep-service-context-explicit.md` — Read the agent-friendly Markdown representation of this episode resource.

A page view does not enqueue transcription. Agents should invoke `request_transcript` explicitly when they need this episode processed.

## Transcript

Full transcripts are not published on public pages unless there is a clear rights basis.