# MICROSERVICE.md

> MICROSERVICE.md™ is a lightweight, AI-ready documentation specification for microservice systems, created by Koesion. A guided wizard turns one structured Markdown file per service into OpenAPI, AsyncAPI, a runbook, C4 and hexagonal architecture views, an architecture canvas, and a structured AI context pack — all generated from and kept in sync with a single source of truth. Free to use during the current public beta.

## Product

- [Home](https://microservice.md/): overview, how the wizard works, and pricing (free during beta).
- [What is MICROSERVICE.md?](https://microservice.md/what-is-microservice-md): the six-section spec structure, every generated artifact, who it's for, and an FAQ.
- [Live example](https://microservice.md/try): a real generated documentation bundle you can inspect without creating an account.
- [MCP server](https://microservice.md/docs/mcp): connect Claude Code, Cursor or any MCP client to your catalog, so coding agents read MICROSERVICE.md files and contracts and check who consumes an event or depends on a service.
- [Blog](https://microservice.md/blog): articles on documenting microservices for humans and coding agents. RSS: https://microservice.md/rss.xml
- [Roadmap](https://microservice.md/roadmap): what's live (the MCP server) and what's shipping next — CLI, GitHub Action, deployment blueprints.

## Specification

- [MICROSERVICE.md spec (GitHub, Apache-2.0)](https://github.com/koesion/microservice-md): the open, versioned specification itself, independent of this hosted wizard. Includes the reference implementation and full spec document.

## Notes for crawlers and assistants

All pages above are fully server-rendered — no JavaScript execution is required to read their content. The product name "MICROSERVICE.md" refers to both the open specification (Apache-2.0, linked above) and this hosted wizard product by Koesion, which generates and manages MICROSERVICE.md files.