Skip to content

docs: add CONTRIBUTING.md workflow section and RELEASE.md#103

Merged
samuelds merged 1 commit into
developfrom
docs/contributing-release
Apr 30, 2026
Merged

docs: add CONTRIBUTING.md workflow section and RELEASE.md#103
samuelds merged 1 commit into
developfrom
docs/contributing-release

Conversation

@samuelds
Copy link
Copy Markdown
Contributor

Summary

  • Enriched CONTRIBUTING.md with git branching rules, commit convention table (body-max-line-length disabled), architecture overview (CLI mode vs MCP server mode, golden rule core=brains, pure command function rule), common pitfalls (snapshot drift, develop↔main divergence, focus_self_update side effects, bricks: namespace clash), and auto-merge policy.
  • Added docs/RELEASE.md covering the stable release process (via /release skill or manual fallback), release order (core first), back-merge recovery, post-release verification (including npx @focus-mcp/cli --version smoke test), and npm OIDC Trusted Publishing reference.

Test plan

  • Markdown renders correctly on GitHub
  • Links in both docs resolve (CODE_OF_CONDUCT.md, SECURITY.md)
  • No content duplicated from core or marketplace docs

🤖 Generated with Claude Code

Add git branching rules, commit convention details (body-max-line-length
disabled), architecture overview (CLI mode vs MCP server mode, golden
rule core=brains), common pitfalls (snapshot drift, develop↔main
divergence, focus_self_update, namespace bricks: prefix) and pure
command function rule to CONTRIBUTING.md.

Add docs/RELEASE.md covering stable release process, manual fallback,
back-merge recovery, post-release verification, and OIDC publishing.
@samuelds samuelds merged commit 2aeda01 into develop Apr 30, 2026
8 checks passed
@samuelds samuelds deleted the docs/contributing-release branch April 30, 2026 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant