Stats
Actions
Available In
Tags
@savvy-web/changesets
Custom changelog formatter and markdown processing pipeline for the Silk Suite. Replaces the default @changesets/cli/changelog formatter with a three-layer architecture: pre-validation (remark-lint), changelog formatting (Changesets API), and post-processing (remark-transform).
Features
- Section-aware changesets -- Categorize changes with h2/h3 headings (Features, Bug Fixes, Breaking Changes, etc.)
- CLI tooling --
savvy-changesetsbinary with init, lint, check, validate-file, transform, and version subcommands - GitHub integration -- Automatic PR links, commit references, and contributor attribution
- Editor support -- markdownlint rules for real-time validation in VS Code and CI
- Claude Code plugin -- Automated validation hooks, skills, and a changeset-writer agent for AI-assisted development
Repository Structure
This is a pnpm workspace monorepo:
| Directory | Purpose |
|---|---|
package/ | The published @savvy-web/changesets npm package |
plugin/ | Companion Claude Code plugin (hooks, skills, agents) |
docs/ | Repository-level documentation |
lib/ | Shared workspace configuration (lint-staged, markdownlint) |
Development
pnpm install
pnpm run build # Build all (dev + prod)
pnpm run test # Run all tests
pnpm run lint # Check code with Biome
pnpm run typecheck # Type-check via Turbo (tsgo)
See CONTRIBUTING.md for full development setup and conventions.
Documentation
- Package README -- Installation, quick start, and API overview
- CLI Reference -- All commands and options
- Section-Aware Pipeline -- End-to-end walkthrough
- Configuration -- Options, version files, CI integration
- Architecture -- Three-layer pipeline design
- API Reference -- Classes, types, Effect services, remark plugins
- Markdownlint Rules -- Per-rule documentation
