Changelog¶
All notable changes to this project are documented here. The format follows
Keep a Changelog, and this project uses
semantic versioning as interpreted for a skill library:
renaming or removing a skill, or changing a config.yaml key, is a major change.
Unreleased¶
0.1.1 — 2026-11-18¶
Changed¶
- Marketplace renamed to
ai-coding-microservices-skillsto match the repository. Reinstall with/plugin marketplace add parvez3019/ai-coding-microservices-skills; the plugin namemicroservices-skillsis unchanged. Display name is now "Microservices Skills". - Manifest
homepagefields point at the documentation site.
Added¶
- Documentation site (MkDocs Material, GitHub Pages) with one page per skill, assembled from
source/bytools/build-docs.sh;make docs,make docs-serve,make docs-install. .github/workflows/docs.yml— strict docs build on PRs, deploy to Pages onmain..github/workflows/release.yml— pushing avX.Y.Ztag publishes a GitHub release with that version's CHANGELOG section as notes.
0.1.0 — 2026-09-05¶
First release. 21 skills across three tiers, with build tooling, a validator, CI, and manifests for Claude Code, Cursor, Codex, and any Agent-Plugins-conformant host.
Principles (16)¶
service-boundaries— bounded contexts, context maps, data ownership, modular-monolith-first bias, strangler-fig extractionclean-architecture— ports and adapters, the dependency rule, SOLID at class and service level, patterns only for a named forcedomain-modelling— entities and value objects, aggregates justified by an invariant, ubiquitous language, illegal states unrepresentabledata-access— repositories, N+1, transaction boundaries, locking, pooling, keyset pagination, zero-downtime migrationscqrs-and-consistency— the five CQRS levels, projections with a staleness budget, read-your-writes, event sourcing honestlyapi-contracts— spec-first OpenAPI/AsyncAPI, additive evolution, RFC 9457 problem details, idempotency keys, event compatibility modesapi-protocols— REST, GraphQL, gRPC, WebSocket and SSE selection and per-protocol craftinfrastructure-adapters— ports owned inward, SDK wrapping, anti-corruption mapping, testing at the wireresilience-patterns— timeouts, retry budgets with full jitter, circuit breakers, bulkheads, outbox/inbox, sagas, health probesidempotency-and-immutability— idempotency keys, conditional updates, exactly-once effect, immutable values and events, safe publicationsecure-service— OWASP API Top 10 as checks, object-level authorisation, service identity, secrets, PII, supply chaintest-strategy— the test portfolio, component tests with real infrastructure, doubles, determinism, coverage versus mutation scorecontract-testing— consumer-driven flow, provider verification,can-i-deploygates, message contractsconfig-and-dependencies— fail-fast typed config, environment parity, flags with an expiry, lockfiles, shared-library disciplinedesign-first— Progressive Design Facilitation: the four-level ladder, depth calibration, approval gatescollaborative-judgment— how trade-offs are presented, decided, and recorded
Workflows (4)¶
/design-service,/implement-service,/review-service,/refactor-safely
Profiles (1)¶
/stack-profile— writes.msskills/stack.mdand a starter.msskills/config.yaml
Agents¶
microservice-reviewer— read-only independent auditor used by/review-service
Tooling¶
tools/build-skills.sh— compiles the tieredsource/tree into the flatskills/foldertools/install.sh— installs into any agent's skills directorytools/validate-skills.sh— frontmatter, description budgets, required sections, link and cross-reference resolution, size limits, and manifest version agreement- CI validates, rebuilds, and fails on any drift in
skills/