Skip to content

docs: add README badges and publish workflow documentation#47

Merged
snipcodeit merged 5 commits intomainfrom
issue/24-add-readme-badges-and-publish
Feb 27, 2026
Merged

docs: add README badges and publish workflow documentation#47
snipcodeit merged 5 commits intomainfrom
issue/24-add-readme-badges-and-publish

Conversation

@snipcodeit
Copy link
Owner

Summary

  • Add shields.io badges to README.md header: npm version, MIT license, node engine version, and GitHub stars
  • Add a "Publishing" section to CONTRIBUTING.md documenting the manual npm publish workflow (login, build, pack, publish)
  • Include a pre-publish checklist covering version bump, changelog, build verification, and dry-run
  • Note CI-based publishing as future work

Closes #24

Milestone Context

  • Milestone: v1 — NPM Publishing & Distribution
  • Phase: 4 — Changelog and Badges (issue 5/5 in milestone)

Changes

Documentation

  • README.md — Added 4 shields.io badge links after the title line (npm version, license, node version, GitHub stars)
  • CONTRIBUTING.md — Added "Publishing" section with npm publish workflow, pre-publish checklist, and future CI note; updated Table of Contents

Test Plan

  • Verify README badges render correctly on GitHub (npm version, license, node, stars)
  • Verify badge links point to correct targets (npmjs.com, opensource.org, nodejs.org, GitHub stars page)
  • Verify CONTRIBUTING.md Table of Contents links to the new Publishing section
  • Verify publish workflow steps are accurate (npm login, npm run build, npm pack --dry-run, npm publish)
  • Verify no unrelated files were modified

Stephen Miller and others added 5 commits February 26, 2026 20:39
Add homepage and bugs fields, expand keywords array with npm
discoverability terms (claude-code, project-management, developer-tools,
ai). Verified existing repository, author, engines, bin, and files
fields are correct. npm pack --dry-run confirms clean 22-file output.

Closes #20

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Exclude development and internal files (.mgw/, .planning/, .worktrees/,
.test/, .github/, .claude/, source lib/ and bin/) from npm package.
Verified with npm pack: 22 files, 58.6 kB — includes only dist/,
commands/, templates/, package.json, README.md, and LICENSE.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Verify shebang in bin/mgw.cjs (already present), confirm npx . --help
and npx . --version work, and document npx usage in README with a
Quick Start section and an npx-vs-full-install comparison table showing
which commands work without Claude Code installed.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Derive changelog entries from git log covering all work to date.
Uses Keep a Changelog format with Added/Changed/Fixed groupings.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Add shields.io badges (npm version, MIT license, node version, GitHub
stars) to README.md header. Add a Publishing section to CONTRIBUTING.md
documenting the manual npm publish workflow with pre-publish checklist
and future CI automation note.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@github-actions github-actions bot added the documentation Documentation changes label Feb 27, 2026
@snipcodeit snipcodeit merged commit 4817784 into main Feb 27, 2026
1 check passed
@snipcodeit snipcodeit deleted the issue/24-add-readme-badges-and-publish branch February 27, 2026 03:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add README badges and publish workflow documentation

1 participant