Merge branch 'main' into chore/dual-mode-code-review

Author: alexeyv

.claude/skills/changelog-social/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: changelog-social
+name: bmad-os-changelog-social
 description: Generate social media announcements for Discord, Twitter, and LinkedIn from the latest changelog entry. Use when user asks to create release announcements, social posts, or share changelog updates. Reads CHANGELOG.md in current working directory. Reference examples/ for tone and format.
 disable-model-invocation: true
 ---
@@ -154,7 +154,13 @@ Read the appropriate example file before generating to match the established sty
 
 ## Output Format
 
-Present both announcements in clearly labeled sections:
+**CRITICAL: ALWAYS write to files** - Create files in `_bmad-output/social/` directory:
+
+1. `{repo-name}-discord-{version}.md` - Discord announcement
+2. `{repo-name}-twitter-{version}.md` - Twitter post
+3. `{repo-name}-linkedin-{version}.md` - LinkedIn post (if applicable)
+
+Also present a preview in the chat:
 
 ```markdown
 ## Discord Announcement
@@ -166,4 +172,7 @@ Present both announcements in clearly labeled sections:
 [paste Twitter content here]
 ```
 
+Files created:
+- `_bmad-output/social/{filename}`
+
 Offer to make adjustments if the user wants different emphasis, tone, or content.

.claude/skills/draft-changelog/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: draft-changelog
-description: Analyzes changes since the last release and generates a draft changelog entry
+name: bmad-os-draft-changelog
+description: Analyzes changes since last release and updates CHANGELOG.md ONLY. Does NOT trigger releases.
 disable-model-invocation: true
 ---
 

.claude/skills/draft-changelog/prompts/instructions.md

@@ -1,5 +1,17 @@
 # Draft Changelog Execution
 
+## ⚠️ IMPORTANT - READ FIRST
+
+**This skill ONLY updates CHANGELOG.md. That is its entire purpose.**
+
+- **DO** update CHANGELOG.md with the new version entry
+- **DO** present the draft for user review before editing
+- **DO NOT** trigger any GitHub release workflows
+- **DO NOT** run any other skills or workflows automatically
+- **DO NOT** make any commits
+
+After the changelog is complete, you may suggest the user can run `/release-module` if they want to proceed with the actual release — but NEVER trigger it yourself.
+
 ## Input
 Project path (or run from project root)
 
@@ -53,6 +65,18 @@ Guidelines:
 - Clear, concise language
 - For breaking changes, clearly indicate impact
 
-## Step 4: Present Draft
+## Step 4: Present Draft & Update CHANGELOG.md
 
 Show the draft with current version, last tag, commit count, and options to edit/retry.
+
+When user accepts:
+1. Update CHANGELOG.md with the new entry (insert at top, after `# Changelog` header)
+2. STOP. That's it. You're done.
+
+You may optionally suggest: *"When ready, you can run `/release-module` to create the actual release."*
+
+**DO NOT:**
+- Trigger any GitHub workflows
+- Run any other skills
+- Make any commits
+- Do anything beyond updating CHANGELOG.md

.claude/skills/gh-triage/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: gh-triage
+name: bmad-os-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

.claude/skills/release-module/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: release-module
+name: bmad-os-release-module
 description: Automates the complete release process for npm modules - version bump, changelog, git tag, npm publish, GitHub release
 disable-model-invocation: true
 ---

.claude/skills/release-module/prompts/instructions.md

@@ -42,26 +42,6 @@ Publish the package.
 
 Create release with changelog notes using `gh release create`.
 
-### Step 10: Create Social Announcement
-
-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
 
 Stop immediately on any step failure. Inform user and suggest fix.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## What
+<!-- 1-2 sentences describing WHAT changed -->
+
+## Why
+<!-- 1-2 sentences explaining WHY this change is needed -->
+<!-- Fixes `#issue_number` (if applicable) -->
+
+## How
+<!-- 2-3 bullets listing HOW you implemented it -->
+-
+
+## Testing
+<!-- 1-2 sentences on how you tested this -->

.github/workflows/coderabbit-review.yaml

@@ -0,0 +1,22 @@
+name: Trigger CodeRabbit on Ready for Review
+
+on:
+  pull_request:
+    types: [ready_for_review]
+
+jobs:
+  trigger-review:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - name: Request CodeRabbit review
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number,
+              body: '@coderabbitai review'
+            });

.github/workflows/docs.yaml

@@ -8,7 +8,7 @@ on:
       - "docs/**"
       - "src/modules/*/docs/**"
       - "website/**"
-      - "tools/build-docs.js"
+      - "tools/build-docs.mjs"
       - ".github/workflows/docs.yaml"
   workflow_dispatch:
 

.github/workflows/quality.yaml

@@ -113,3 +113,6 @@ jobs:
 
       - name: Test agent compilation components
         run: npm run test:install
+
+      - name: Validate file references
+        run: npm run validate:refs