From c3d1bf3fe889a0bc9ea81bbf9cb951b674dc5811 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sat, 31 Jan 2026 22:55:26 -0600 Subject: [PATCH 1/7] Fix duplicate 2-letter code - brainstorming now uses BSP - BS -> BSP (Brainstorming in core module) Resolves conflict with cis Brainstorming (BS). Core is for project brainstorming, cis is general brainstorming. --- src/core/module-help.csv | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/core/module-help.csv b/src/core/module-help.csv index 599cef33..1fdf064c 100644 --- a/src/core/module-help.csv +++ b/src/core/module-help.csv @@ -1,5 +1,5 @@ module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs -core,anytime,Brainstorming,BS,,_bmad/core/workflows/brainstorming/workflow.md,bmad-brainstorming,false,analyst,,"Generate diverse ideas through interactive techniques. Use early in ideation phase or when stuck generating ideas.",{output_folder}/brainstorming/brainstorming-session-{{date}}.md,, +core,anytime,Brainstorming,BSP,,_bmad/core/workflows/brainstorming/workflow.md,bmad-brainstorming,false,analyst,,"Generate diverse ideas through interactive techniques. Use early in ideation phase or when stuck generating ideas.",{output_folder}/brainstorming/brainstorming-session-{{date}}.md,, core,anytime,Party Mode,PM,,_bmad/core/workflows/party-mode/workflow.md,bmad-party-mode,false,party-mode facilitator,,"Orchestrate multi-agent discussions. Use when you need multiple agent perspectives or want agents to collaborate.",, core,anytime,bmad-help,BH,,_bmad/core/tasks/help.md,bmad-help,false,,,"Get unstuck by showing what workflow steps come next or answering BMad Method questions.",, core,anytime,Index Docs,ID,,_bmad/core/tasks/index-docs.xml,bmad-index-docs,false,,,"Create lightweight index for quick LLM scanning. Use when LLM needs to understand available docs without loading everything.",, From 0bbb544521b7e78fff9163082696a6c4a8bf0d78 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 1 Feb 2026 12:19:36 -0600 Subject: [PATCH 2/7] remove skills that are now part of a plugin installer --- .claude/skills/gh-triage/SKILL.md | 158 ------------------------------ .gitignore | 2 +- 2 files changed, 1 insertion(+), 159 deletions(-) delete mode 100644 .claude/skills/gh-triage/SKILL.md diff --git a/.claude/skills/gh-triage/SKILL.md b/.claude/skills/gh-triage/SKILL.md deleted file mode 100644 index 59795159..00000000 --- a/.claude/skills/gh-triage/SKILL.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -name: gh-triage -description: Fetch all GitHub issues via gh CLI and use AI agents to deeply analyze, cluster, and prioritize issues with actual understanding. Use for issue triage, backlog cleanup, or when user mentions "issues", "triage", or "backlog". -license: MIT -disable-model-invocation: true -metadata: - author: bmad-code-org - version: "3.0.0" - anthropic-internal: Core team issue triage tool for BMad Method repositories - min-github-cli-version: "2.0" -compatibility: Requires gh CLI, git repository, and BMad Method with Task tool support ---- - -# GitHub Issue Triage with AI Analysis - -**CRITICAL RULES:** -- NEVER include time or effort estimates in output or recommendations -- Focus on WHAT needs to be done, not HOW LONG it takes -- Use Bash tool with gh CLI for all GitHub operations - -## Execution Plan - -You will perform GitHub issue triage using AI agents for deep analysis: - -### Step 1: Fetch Issues -Use `gh issue list` to fetch all open issues from the current repository in JSON format. - -### Step 2: Batch Creation -Split issues into batches of ~10 issues each for parallel analysis. - -### Step 3: Parallel Agent Analysis -For EACH batch, use the Task tool with `subagent_type=general-purpose` to launch an agent with this prompt: - -``` -You are analyzing a batch of GitHub issues for deep understanding and triage. - -**YOUR TASK:** -Read the issues in your batch and provide DEEP analysis: - -1. **For EACH issue, analyze:** - - What is this ACTUALLY about? (beyond keywords) - - What component/system does it affect? - - What's the impact and severity? - - Is it a bug, feature request, or something else? - - What specific theme does it belong to? - -2. **PRIORITY ASSESSMENT:** - - CRITICAL: Blocks users, security issues, data loss, broken installers - - HIGH: Major functionality broken, important features missing - - MEDIUM: Workarounds available, minor bugs, nice-to-have features - - LOW: Edge cases, cosmetic issues, questions - -3. **RELATIONSHIPS:** - - Duplicates: Near-identical issues about the same problem - - Related: Issues connected by theme or root cause - - Dependencies: One issue blocks or requires another - -**YOUR BATCH:** -[Paste the batch of issues here - each with number, title, body, labels] - -**OUTPUT FORMAT (JSON only, no markdown):** -{ - "issues": [ - { - "number": 123, - "title": "issue title", - "deep_understanding": "2-3 sentences explaining what this is really about", - "affected_components": ["installer", "workflows", "docs"], - "issue_type": "bug/feature/question/tech-debt", - "priority": "CRITICAL/HIGH/MEDIUM/LOW", - "priority_rationale": "Why this priority level", - "theme": "installation/workflow/integration/docs/ide-support/etc", - "relationships": { - "duplicates_of": [456], - "related_to": [789, 101], - "blocks": [111] - } - } - ], - "cross_repo_issues": [ - {"number": 123, "target_repo": "bmad-builder", "reason": "about agent builder"} - ], - "cleanup_candidates": [ - {"number": 456, "reason": "v4-related/outdated/duplicate"} - ], - "themes_found": { - "Installation Blockers": { - "count": 5, - "root_cause": "Common pattern if identifiable" - } - } -} - -Return ONLY valid JSON. No explanations outside the JSON structure. -``` - -### Step 4: Consolidate & Generate Report -After all agents complete, create a comprehensive markdown report saved to `_bmad-output/triage-reports/triage-YYYY-MM-DD.md` with: - -## Report Structure - -### Executive Summary -- Total issues analyzed -- Issue count by priority (CRITICAL, HIGH, MEDIUM, LOW) -- Major themes discovered -- Top 5 critical issues requiring immediate attention - -### Critical Issues (CRITICAL Priority) -For each CRITICAL issue: -- **#123 - [Issue Title](url)** -- **What it's about:** [Deep understanding] -- **Affected:** [Components] -- **Why Critical:** [Rationale] -- **Suggested Action:** [Specific action] - -### High Priority Issues (HIGH Priority) -Same format as Critical, grouped by theme. - -### Theme Clusters -For each major theme: -- **Theme Name** (N issues) -- **What connects these:** [Pattern] -- **Root cause:** [If identifiable] -- **Consolidated actions:** [Bulk actions if applicable] -- **Issues:** #123, #456, #789 - -### Relationships & Dependencies -- **Duplicates:** List pairs with `gh issue close` commands -- **Related Issues:** Groups of related issues -- **Dependencies:** Blocking relationships - -### Cross-Repo Issues -Issues that should be migrated to other repositories (bmad-builder, bmad-module-creative-intelligence-suite, bmad-module-game-dev-studio, bmad-method-test-architecture-enterprise). - -For each, provide: -``` -gh issue close XXX --repo CURRENT_REPO --comment "This issue belongs in REPO. Please report at https://github.com/TARGET_REPO/issues/new" -``` - -### Cleanup Candidates -- **v4-related:** Deprecated version issues with close commands -- **Stale:** No activity >30 days -- **Low priority + old:** Low priority issues >60 days old - -### Actionable Next Steps -Specific, prioritized actions: -1. [CRITICAL] Fix broken installer - affects all new users -2. [HIGH] Resolve Windows path escaping issues -3. [HIGH] Address workflow integration bugs -etc. - -Include `gh` commands where applicable for bulk actions. - ---- - -## Execute Now - -Begin by fetching issues from the current repository and follow the plan above. diff --git a/.gitignore b/.gitignore index 6af83303..885cb245 100644 --- a/.gitignore +++ b/.gitignore @@ -50,7 +50,7 @@ _bmad-output .qwen .rovodev .kilocodemodes -.claude/commands +.claude .codex .github/chatmodes .github/agents From fa01b4929b94bc2c409ace0b21c05fd4e74189ff Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 1 Feb 2026 16:01:29 -0600 Subject: [PATCH 3/7] add helper skills --- .claude/skills/draft-changelog/SKILL.md | 7 ++ .../draft-changelog/prompts/instructions.md | 58 +++++++++++++++ .claude/skills/gh-triage/README.md | 14 ++++ .claude/skills/gh-triage/SKILL.md | 12 +++ .../skills/gh-triage/prompts/agent-prompt.md | 60 +++++++++++++++ .../skills/gh-triage/prompts/instructions.md | 74 +++++++++++++++++++ .claude/skills/release-module/README.md | 24 ++++++ .claude/skills/release-module/SKILL.md | 7 ++ .../release-module/prompts/instructions.md | 57 ++++++++++++++ .gitignore | 2 +- 10 files changed, 314 insertions(+), 1 deletion(-) create mode 100644 .claude/skills/draft-changelog/SKILL.md create mode 100644 .claude/skills/draft-changelog/prompts/instructions.md create mode 100644 .claude/skills/gh-triage/README.md create mode 100644 .claude/skills/gh-triage/SKILL.md create mode 100644 .claude/skills/gh-triage/prompts/agent-prompt.md create mode 100644 .claude/skills/gh-triage/prompts/instructions.md create mode 100644 .claude/skills/release-module/README.md create mode 100644 .claude/skills/release-module/SKILL.md create mode 100644 .claude/skills/release-module/prompts/instructions.md diff --git a/.claude/skills/draft-changelog/SKILL.md b/.claude/skills/draft-changelog/SKILL.md new file mode 100644 index 00000000..f25f8c48 --- /dev/null +++ b/.claude/skills/draft-changelog/SKILL.md @@ -0,0 +1,7 @@ +--- +name: draft-changelog +description: Analyzes changes since the last release and generates a draft changelog entry +disable-model-invocation: true +--- + +Read `prompts/instructions.md` and execute. diff --git a/.claude/skills/draft-changelog/prompts/instructions.md b/.claude/skills/draft-changelog/prompts/instructions.md new file mode 100644 index 00000000..a9b98bb8 --- /dev/null +++ b/.claude/skills/draft-changelog/prompts/instructions.md @@ -0,0 +1,58 @@ +# Draft Changelog Execution + +## Input +Project path (or run from project root) + +## Step 1: Identify Current State +- Get the latest released tag +- Get current version +- Verify there are commits since the last release + +## Step 2: Launch Explore Agent + +Use `thoroughness: "very thorough"` to analyze all changes since the last release tag. + +**Key: For each merge commit, look up the merged PR/issue that was closed.** +- Use `gh pr view` or git commit body to find the PR number +- Read the PR description and comments to understand full context +- Don't rely solely on commit merge messages - they lack context + +**Analyze:** + +1. **All merges/commits** since the last tag +2. **For each merge, read the original PR/issue** that was closed +3. **Files changed** with statistics +4. **Categorize changes:** + - 🎁 **Features** - New functionality, new agents, new workflows + - 🐛 **Bug Fixes** - Fixed bugs, corrected issues + - ♻️ **Refactoring** - Code improvements, reorganization + - 📚 **Documentation** - Docs updates, README changes + - 🔧 **Maintenance** - Dependency updates, tooling, infrastructure + - 💥 **Breaking Changes** - Changes that may affect users + +**Provide:** +- Comprehensive summary of ALL changes with PR context +- Categorization of each change +- Identification of breaking changes +- Significance assessment (major/minor/trivial) + +## Step 3: Generate Draft Changelog + +Format: +```markdown +## v0.X.X - [Date] + +* [Change 1 - categorized by type] +* [Change 2] +``` + +Guidelines: +- Present tense ("Fix bug" not "Fixed bug") +- Most significant changes first +- Group related changes +- Clear, concise language +- For breaking changes, clearly indicate impact + +## Step 4: Present Draft + +Show the draft with current version, last tag, commit count, and options to edit/retry. diff --git a/.claude/skills/gh-triage/README.md b/.claude/skills/gh-triage/README.md new file mode 100644 index 00000000..3692e3d2 --- /dev/null +++ b/.claude/skills/gh-triage/README.md @@ -0,0 +1,14 @@ +# gh-triage + +Fetches all GitHub issues via gh CLI and uses AI agents to deeply analyze, cluster, and prioritize issues. + +## Usage + +Run from within any BMad Method repository to triage issues. + +## What It Does + +1. Fetches all open issues via `gh issue list` +2. Splits issues into batches +3. Launches parallel agents to analyze each batch +4. Generates comprehensive triage report to `_bmad-output/triage-reports/` diff --git a/.claude/skills/gh-triage/SKILL.md b/.claude/skills/gh-triage/SKILL.md new file mode 100644 index 00000000..6a6d7c83 --- /dev/null +++ b/.claude/skills/gh-triage/SKILL.md @@ -0,0 +1,12 @@ +--- +name: gh-triage +description: Fetch all GitHub issues via gh CLI and use AI agents to deeply analyze, cluster, and prioritize issues +license: MIT +disable-model-invocation: true +metadata: + author: bmad-code-org + version: "3.0.0" +compatibility: Requires gh CLI, git repository, and BMad Method with Task tool support +--- + +Read `prompts/instructions.md` and execute. diff --git a/.claude/skills/gh-triage/prompts/agent-prompt.md b/.claude/skills/gh-triage/prompts/agent-prompt.md new file mode 100644 index 00000000..5c0d7d8d --- /dev/null +++ b/.claude/skills/gh-triage/prompts/agent-prompt.md @@ -0,0 +1,60 @@ +You are analyzing a batch of GitHub issues for deep understanding and triage. + +**YOUR TASK:** +Read the issues in your batch and provide DEEP analysis: + +1. **For EACH issue, analyze:** + - What is this ACTUALLY about? (beyond keywords) + - What component/system does it affect? + - What's the impact and severity? + - Is it a bug, feature request, or something else? + - What specific theme does it belong to? + +2. **PRIORITY ASSESSMENT:** + - CRITICAL: Blocks users, security issues, data loss, broken installers + - HIGH: Major functionality broken, important features missing + - MEDIUM: Workarounds available, minor bugs, nice-to-have features + - LOW: Edge cases, cosmetic issues, questions + +3. **RELATIONSHIPS:** + - Duplicates: Near-identical issues about the same problem + - Related: Issues connected by theme or root cause + - Dependencies: One issue blocks or requires another + +**YOUR BATCH:** +[Paste the batch of issues here - each with number, title, body, labels] + +**OUTPUT FORMAT (JSON only, no markdown):** +{ + "issues": [ + { + "number": 123, + "title": "issue title", + "deep_understanding": "2-3 sentences explaining what this is really about", + "affected_components": ["installer", "workflows", "docs"], + "issue_type": "bug/feature/question/tech-debt", + "priority": "CRITICAL/HIGH/MEDIUM/LOW", + "priority_rationale": "Why this priority level", + "theme": "installation/workflow/integration/docs/ide-support/etc", + "relationships": { + "duplicates_of": [456], + "related_to": [789, 101], + "blocks": [111] + } + } + ], + "cross_repo_issues": [ + {"number": 123, "target_repo": "bmad-builder", "reason": "about agent builder"} + ], + "cleanup_candidates": [ + {"number": 456, "reason": "v4-related/outdated/duplicate"} + ], + "themes_found": { + "Installation Blockers": { + "count": 5, + "root_cause": "Common pattern if identifiable" + } + } +} + +Return ONLY valid JSON. No explanations outside the JSON structure. diff --git a/.claude/skills/gh-triage/prompts/instructions.md b/.claude/skills/gh-triage/prompts/instructions.md new file mode 100644 index 00000000..782d2326 --- /dev/null +++ b/.claude/skills/gh-triage/prompts/instructions.md @@ -0,0 +1,74 @@ +# GitHub Issue Triage with AI Analysis + +**CRITICAL RULES:** +- NEVER include time or effort estimates in output or recommendations +- Focus on WHAT needs to be done, not HOW LONG it takes +- Use Bash tool with gh CLI for all GitHub operations + +## Execution + +### Step 1: Fetch Issues +Use `gh issue list --json number,title,body,labels` to fetch all open issues. + +### Step 2: Batch Creation +Split issues into batches of ~10 issues each for parallel analysis. + +### Step 3: Parallel Agent Analysis +For EACH batch, use the Task tool with `subagent_type=general-purpose` to launch an agent with prompt from `prompts/agent-prompt.md` + +### Step 4: Consolidate & Generate Report +After all agents complete, create a comprehensive markdown report saved to `_bmad-output/triage-reports/triage-YYYY-MM-DD.md` + +## Report Format + +### Executive Summary +- Total issues analyzed +- Issue count by priority (CRITICAL, HIGH, MEDIUM, LOW) +- Major themes discovered +- Top 5 critical issues requiring immediate attention + +### Critical Issues (CRITICAL Priority) +For each CRITICAL issue: +- **#123 - [Issue Title](url)** +- **What it's about:** [Deep understanding] +- **Affected:** [Components] +- **Why Critical:** [Rationale] +- **Suggested Action:** [Specific action] + +### High Priority Issues (HIGH Priority) +Same format as Critical, grouped by theme. + +### Theme Clusters +For each major theme: +- **Theme Name** (N issues) +- **What connects these:** [Pattern] +- **Root cause:** [If identifiable] +- **Consolidated actions:** [Bulk actions if applicable] +- **Issues:** #123, #456, #789 + +### Relationships & Dependencies +- **Duplicates:** List pairs with `gh issue close` commands +- **Related Issues:** Groups of related issues +- **Dependencies:** Blocking relationships + +### Cross-Repo Issues +Issues that should be migrated to other repositories. + +For each, provide: +``` +gh issue close XXX --repo CURRENT_REPO --comment "This issue belongs in REPO. Please report at https://github.com/TARGET_REPO/issues/new" +``` + +### Cleanup Candidates +- **v4-related:** Deprecated version issues with close commands +- **Stale:** No activity >30 days +- **Low priority + old:** Low priority issues >60 days old + +### Actionable Next Steps +Specific, prioritized actions: +1. [CRITICAL] Fix broken installer - affects all new users +2. [HIGH] Resolve Windows path escaping issues +3. [HIGH] Address workflow integration bugs +etc. + +Include `gh` commands where applicable for bulk actions. diff --git a/.claude/skills/release-module/README.md b/.claude/skills/release-module/README.md new file mode 100644 index 00000000..5dbaf254 --- /dev/null +++ b/.claude/skills/release-module/README.md @@ -0,0 +1,24 @@ +# release-module + +Automates the complete release process for npm modules. + +## Usage + +Run from project root or pass project path: +``` +bmad-utility-skills:release-module +``` + +## Prerequisite + +First run `draft-changelog` to analyze changes and create a draft changelog. + +## What It Does + +1. Gets and confirms changelog entry +2. Confirms version bump type (patch/minor/major) +3. Updates CHANGELOG.md +4. Bumps version with `npm version` +5. Pushes git tag +6. Publishes to npm +7. Creates GitHub release diff --git a/.claude/skills/release-module/SKILL.md b/.claude/skills/release-module/SKILL.md new file mode 100644 index 00000000..3ba15657 --- /dev/null +++ b/.claude/skills/release-module/SKILL.md @@ -0,0 +1,7 @@ +--- +name: release-module +description: Automates the complete release process for npm modules - version bump, changelog, git tag, npm publish, GitHub release +disable-model-invocation: true +--- + +Read `prompts/instructions.md` and execute. diff --git a/.claude/skills/release-module/prompts/instructions.md b/.claude/skills/release-module/prompts/instructions.md new file mode 100644 index 00000000..b026ed2d --- /dev/null +++ b/.claude/skills/release-module/prompts/instructions.md @@ -0,0 +1,57 @@ +# Release BMad Module Execution + +## Input +Project path (or run from project root) + +## Execution Steps + +### Step 1: Get Current State +- Verify git working tree is clean +- Get latest tag and current version +- Check for unpushed commits + +### Step 2: Get Changelog Entry + +Ask the user for the changelog entry (from draft-changelog skill or manual). + +### Step 3: Confirm Changelog + +Show project name, current version, proposed next version, and changelog. Get confirmation. + +### Step 4: Confirm Version Bump Type + +Ask what type of bump: patch, minor, major, prerelease, or custom. + +### Step 5: Update CHANGELOG.md + +Insert new entry at top, commit, and push. + +### Step 6: Bump Version + +Run `npm version` to update package.json, create commit, and create tag. + +### Step 7: Push Tag + +Push the new version tag to GitHub. + +### Step 8: Publish to npm + +Publish the package. + +### Step 9: Create GitHub Release + +Create release with changelog notes using `gh release create`. + +### Step 10: Confirm Completion + +Show npm and GitHub links. + +## Error Handling + +Stop immediately on any step failure. Inform user and suggest fix. + +## Important Notes + +- Wait for user confirmation before destructive operations +- Push changelog commit before version bump +- Use explicit directory paths in commands diff --git a/.gitignore b/.gitignore index 885cb245..6af83303 100644 --- a/.gitignore +++ b/.gitignore @@ -50,7 +50,7 @@ _bmad-output .qwen .rovodev .kilocodemodes -.claude +.claude/commands .codex .github/chatmodes .github/agents From 79067a94275df6ef34b1ca0d32667e15eb15c694 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 1 Feb 2026 16:13:15 -0600 Subject: [PATCH 4/7] changelog: v6.0.0-Beta.5 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ### 🎁 Features * Add generate-project-context workflow * Shard market research customer analysis ### 🐛 Bug Fixes * Fix npm install peer dependency issues (PR #1476) * Fix leaked source paths in PRD validation report (#1481) * Fix orphaned market research customer analysis (#1486) * Fix duplicate 2-letter brainstorming code (BS → BSP) * Fix tech writer sidecar functionality (#1487) * Fix relative paths in workflow steps (#1497, #1498) * Fix party-mode workflow file extension (#1499) * Fix generated slash commands (#1501) * Fix agent scan and help CSV files * Fix HELP_STEP placeholder replacement (#1437) ### 📚 Documentation * Add exact slash commands to Getting Started guide (#1505) * Remove .claude/commands from version control (#1506) ### 🔧 Maintenance * Update Starlight to 0.37.5 * Add GitHub issue templates --- CHANGELOG.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 953a4664..2420869b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,37 @@ # Changelog +## [6.0.0-Beta.5] + +### 🎁 Features + +* **Add generate-project-context workflow** — New 3-step workflow for project context generation, integrated with quick-flow-solo-dev agent +* **Shard market research customer analysis** — Refactor monolithic customer insights into 4-step detailed customer behavior analysis workflow + +### 🐛 Bug Fixes + +* **Fix npm install peer dependency issues** — Add `.npmrc` with `legacy-peer-deps=true`, update Starlight to 0.37.5, and add `--legacy-peer-deps` flag to module installer (PR #1476) +* **Fix leaked source paths in PRD validation report** — Replace absolute `/src/core/` paths with `{project-root}/_bmad/core/` (#1481) +* **Fix orphaned market research customer analysis** — Connect step-01-init to step-02-customer-behavior to complete workflow sharding (#1486) +* **Fix duplicate 2-letter brainstorming code** — Change BS to BSP to resolve conflict with cis Brainstorming module +* **Fix tech writer sidecar functionality** — Enable proper sidecar operation (#1487) +* **Fix relative paths in workflow steps** — Correct paths in step-11-polish (#1497) and step-e-04-complete (#1498) +* **Fix party-mode workflow file extension** — Correct extension in workflow.xml (#1499) +* **Fix generated slash commands** — Add `disable-model-invocation` to all generated commands (#1501) +* **Fix agent scan and help CSV files** — Correct module-help.csv entries +* **Fix HELP_STEP placeholder replacement** — Fix placeholder not replaced in compiled agents, fix hardcoded path, fix single quote (#1437) + +### 📚 Documentation + +* **Add exact slash commands to Getting Started guide** — Provide precise command examples for users (#1505) +* **Remove .claude/commands from version control** — Commands are generated, not tracked (#1506) + +### 🔧 Maintenance + +* **Update Starlight to 0.37.5** — Latest version with peer dependency compatibility +* **Add GitHub issue templates** — New bug-report.yaml and documentation.yaml templates + +--- + ## [6.0.0-Beta.4] ### 🐛 Bug Fixes From 0c46ef0be2521ceeefed5de7a7e82422a8ae4567 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 1 Feb 2026 16:13:27 -0600 Subject: [PATCH 5/7] 6.0.0-Beta.5 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index b5f966e7..fe41085b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "bmad-method", - "version": "6.0.0-Beta.4", + "version": "6.0.0-Beta.5", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "bmad-method", - "version": "6.0.0-Beta.4", + "version": "6.0.0-Beta.5", "license": "MIT", "dependencies": { "@clack/prompts": "^0.11.0", diff --git a/package.json b/package.json index 76f24133..f3342a41 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "$schema": "https://json.schemastore.org/package.json", "name": "bmad-method", - "version": "6.0.0-Beta.4", + "version": "6.0.0-Beta.5", "description": "Breakthrough Method of Agile AI-driven Development", "keywords": [ "agile", From b0c35d595f64a4cdd4b60181b87ed5e2b5b11479 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 1 Feb 2026 16:59:43 -0600 Subject: [PATCH 6/7] social post skill helper --- .claude/skills/changelog-social/SKILL.md | 168 ++++++++++++++++++ .../release-module/prompts/instructions.md | 20 ++- 2 files changed, 186 insertions(+), 2 deletions(-) create mode 100644 .claude/skills/changelog-social/SKILL.md diff --git a/.claude/skills/changelog-social/SKILL.md b/.claude/skills/changelog-social/SKILL.md new file mode 100644 index 00000000..02ee2ae0 --- /dev/null +++ b/.claude/skills/changelog-social/SKILL.md @@ -0,0 +1,168 @@ +--- +name: changelog-social +description: Generate social media announcements for Discord and Twitter from the latest changelog entry.asks to create release announcements, social posts, or share changelog updates on Discord/Twitter. Reads CHANGELOG.md in current working directory. +disable-model-invocation: true +--- + +# Changelog Social + +Generate engaging social media announcements from changelog entries. + +## Workflow + +### Step 1: Extract Changelog Entry + +Read `./CHANGELOG.md` and extract the latest version entry. The changelog follows this format: + +```markdown +## [VERSION] + +### 🎁 Features +* **Title** — Description + +### 🐛 Bug Fixes +* **Title** — Description + +### 📚 Documentation +* **Title** — Description + +### 🔧 Maintenance +* **Title** — Description +``` + +Parse: +- **Version number** (e.g., `6.0.0-Beta.5`) +- **Features** - New functionality, enhancements +- **Bug Fixes** - Fixes users will care about +- **Documentation** - New or improved docs +- **Maintenance** - Dependency updates, tooling improvements + +### Step 2: Get Git Contributors + +Use git log to find contributors since the previous version. Get commits between the current version tag and the previous one: + +```bash +# Find the previous version tag first +git tag --sort=-version:refname | head -5 + +# Get commits between versions with PR numbers and authors +git log .. --pretty=format:"%h|%s|%an" --grep="#" +``` + +Extract PR numbers from commit messages that contain `#` followed by digits. Compile unique contributors. + +### Step 3: Generate Discord Announcement + +Use this template style: + +```markdown +🚀 **BMad vVERSION RELEASED!** + +🎉 [Brief hype sentence] + +🪥 **KEY HIGHLIGHT** - [One-line summary] + +🎯 **CATEGORY NAME** +• Feature one - brief description +• Feature two - brief description +• Coming soon: Future teaser + +🔧 **ANOTHER CATEGORY** +• Fix or feature +• Another item + +📚 **DOCS OR OTHER** +• Item +• Item with link + +🌟 **COMMUNITY PHILOSOPHY** (optional - include for major releases) +• Everything is FREE - No paywalls +• Knowledge shared, not sold + +📊 **STATS** +X commits | Y PRs merged | Z files changed + +🙏 **CONTRIBUTORS** +@username1 (X PRs!), @username2 (Y PRs!) +@username3, @username4, username5 + dependabot 🛡️ +Community-driven FTW! 🌟 + +📦 **INSTALL:** +`npx bmad-method@VERSION install` + +⭐ **SUPPORT US:** +🌟 GitHub: github.com/bmad-code-org/BMAD-METHOD/ +📺 YouTube: youtube.com/@BMadCode +☕ Donate: buymeacoffee.com/bmad + +🔥 **Next version tease!** +``` + +**Content Strategy:** +- Focus on **user impact** - what's better for them? +- Highlight **annoying bugs fixed** that frustrated users +- Show **new capabilities** that enable workflows +- Keep it **punchy** - use emojis and short bullets +- Add **personality** - excitement, humor, gratitude + +### Step 4: Generate Twitter Post + +Create a condensed version (280 chars or less for main tweet, optionally thread): + +``` +🚀 BMad vVERSION is live! + +[Most exciting feature] + [Critical bug fix] + +• Feature 1 +• Feature 2 +• Fix 3 + +Install: npx bmad-method@VERSION install + +#AI #DevTools +``` + +**For major releases**, create a thread: +1. Hook tweet - biggest news +2. Feature highlights tweet +3. Community/contributors tweet +4. Install CTA + +## Content Selection Guidelines + +**Include:** +- New features that change workflows +- Bug fixes for annoying/blocking issues +- Documentation that helps users +- Performance improvements +- New agents or workflows +- Breaking changes (call out clearly) + +**Skip/Minimize:** +- Internal refactoring +- Dependency updates (unless user-facing) +- Test improvements +- Minor style fixes + +**Emphasize:** +- "Finally fixed" issues +- "Faster" operations +- "Easier" workflows +- "Now supports" capabilities + +## Output Format + +Present both announcements in clearly labeled sections: + +```markdown +## Discord Announcement + +[paste Discord content here] + +## Twitter Post + +[paste Twitter content here] +``` + +Offer to make adjustments if the user wants different emphasis, tone, or content. diff --git a/.claude/skills/release-module/prompts/instructions.md b/.claude/skills/release-module/prompts/instructions.md index b026ed2d..39e45ac1 100644 --- a/.claude/skills/release-module/prompts/instructions.md +++ b/.claude/skills/release-module/prompts/instructions.md @@ -42,9 +42,25 @@ Publish the package. Create release with changelog notes using `gh release create`. -### Step 10: Confirm Completion +### Step 10: Create Social Announcement -Show npm and GitHub links. +Create a social media announcement file at `_bmad-output/social/{repo-name}-release.md`. + +Format: +```markdown +# {name} v{version} Released + +## Highlights +{2-3 bullet points of key features/changes} + +## Links +- GitHub: {release-url} +- npm: {npm-url} +``` + +### Step 11: Confirm Completion + +Show npm, GitHub, and social announcement file paths. ## Error Handling From 323cd75efd7c28257673b6dd090c379be34d182d Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 1 Feb 2026 17:32:46 -0600 Subject: [PATCH 7/7] x post premium example udpate for social post tool - do not add to changelog --- .claude/skills/changelog-social.skill | Bin 0 -> 7296 bytes .claude/skills/changelog-social/SKILL.md | 41 ++++++------- .../examples/discord-example.md | 53 +++++++++++++++++ .../examples/linkedin-example.md | 49 ++++++++++++++++ .../examples/twitter-example.md | 55 ++++++++++++++++++ 5 files changed, 178 insertions(+), 20 deletions(-) create mode 100644 .claude/skills/changelog-social.skill create mode 100644 .claude/skills/changelog-social/examples/discord-example.md create mode 100644 .claude/skills/changelog-social/examples/linkedin-example.md create mode 100644 .claude/skills/changelog-social/examples/twitter-example.md diff --git a/.claude/skills/changelog-social.skill b/.claude/skills/changelog-social.skill new file mode 100644 index 0000000000000000000000000000000000000000..8ef04097da76ee4d69a0daa5febd6b5fae13d178 GIT binary patch literal 7296 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