Документирование TypeScript-кода в Medusa

documentation

writing-tsdocs is a Claude Code skill that adds and updates TypeDoc (TSDoc) comments to TypeScript source files across the Medusa codebase. It covers HTTP types, API routes, UI components, data models, service interfaces, JS SDK methods, abstract providers, Workflow SDK functions, core-flows workflows and steps, and event constants. Depending on the file being documented, the skill loads the appropriate reference file — for example, `reference/api-routes.md` for admin or store routes, or `reference/events.md` for event constants in `packages/core/utils/src/core-flows/events.ts`. Custom Medusa tags such as `@expandable`, `@featureFlag`, `@since`, and `@tags` are supported alongside standard JSDoc/TypeDoc tags. The skill strictly avoids documenting unexported or private members, never touches test files, and never alters runtime logic — making it the right choice for teams maintaining consistent API documentation across a large TypeScript monorepo.