@sleighmaster/bmad 1.1.2 → 1.2.0

package/data/_bmad/bmm/workflows/github-release/instructions.xml

@@ -0,0 +1,183 @@
+<workflow>
+  <critical>The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml</critical>
+  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
+  <critical>Communicate all responses in {communication_language}</critical>
+
+  <step n="1" goal="릴리즈 정보 수집">
+    <critical>🏷️ GITHUB RELEASE - 태그 생성 및 릴리즈 등록</critical>
+
+    <action>git repository 확인: git rev-parse --git-dir</action>
+    <check if="git repository NOT detected">
+      <output>🚫 Git 저장소가 감지되지 않습니다. 릴리즈를 생성할 수 없습니다.</output>
+      <action>HALT</action>
+    </check>
+
+    <action>gh CLI 인증 확인: gh auth status</action>
+    <check if="gh auth 실패">
+      <output>🚫 GitHub CLI 인증이 필요합니다.
+        `gh auth login`을 실행하여 인증해주세요.
+      </output>
+      <action>HALT</action>
+    </check>
+
+    <action>현재 태그 목록 조회: git tag --list --sort=-v:refname | head -10</action>
+    <action>가장 최근 태그 확인</action>
+
+    <output>📋 **릴리즈 정보**
+
+      **최근 태그:** {{latest_tag}} (없으면 "첫 번째 릴리즈")
+      **현재 브랜치:** {{current_branch}}
+      **마지막 커밋:** {{last_commit_hash}} - {{last_commit_message}}
+    </output>
+
+    <ask>새 버전을 입력해주세요 (예: v1.0.0, v1.1.0):
+      - Major (v2.0.0): 호환되지 않는 API 변경
+      - Minor (v1.1.0): 새로운 기능 추가 (하위 호환)
+      - Patch (v1.0.1): 버그 수정
+    </ask>
+
+    <action>입력된 버전 유효성 검사 (v로 시작, semantic versioning 형식)</action>
+    <check if="유효하지 않은 버전 형식">
+      <output>⚠️ 버전 형식이 올바르지 않습니다. 예: v1.0.0</output>
+      <ask>다시 입력해주세요:</ask>
+    </check>
+
+    <action>{{new_version}} 저장</action>
+  </step>
+
+  <step n="2" goal="릴리즈 노트 생성">
+    <critical>📝 RELEASE NOTES - 완료된 스토리/PR 기반 자동 생성</critical>
+
+    <check if="{{latest_tag}} 존재">
+      <action>이전 태그 이후 커밋 조회:
+        git log {{latest_tag}}..HEAD --pretty=format:"- %s" --no-merges
+      </action>
+    </check>
+
+    <check if="첫 번째 릴리즈">
+      <action>모든 커밋 조회:
+        git log --pretty=format:"- %s" --no-merges | head -50
+      </action>
+    </check>
+
+    <action>커밋 메시지를 타입별로 분류:
+      - feat: 새로운 기능
+      - fix: 버그 수정
+      - refactor: 리팩토링
+      - docs: 문서
+      - test: 테스트
+      - chore: 기타
+    </action>
+
+    <check if="sprint_status 파일 존재">
+      <action>완료된 스토리 목록 추출 (status: done)</action>
+    </check>
+
+    <action>릴리즈 노트 초안 생성</action>
+
+    <output>📝 **릴리즈 노트 초안**
+
+      ## {{new_version}}
+
+      ### ✨ New Features
+      {{feat_commits}}
+
+      ### 🐛 Bug Fixes
+      {{fix_commits}}
+
+      ### 🔧 Improvements
+      {{refactor_commits}}
+
+      ### 📚 Documentation
+      {{docs_commits}}
+
+      ### Completed Stories
+      {{completed_stories}}
+
+      ---
+      *Generated by BMAD Method*
+    </output>
+
+    <ask>릴리즈 노트를 수정하시겠습니까? [y/n]
+      - y: 수정 내용 입력
+      - n: 현재 내용으로 진행
+    </ask>
+
+    <check if="user wants to edit">
+      <ask>수정할 내용을 입력해주세요:</ask>
+      <action>릴리즈 노트 업데이트</action>
+    </check>
+  </step>
+
+  <step n="3" goal="태그 생성 및 Push">
+    <critical>🏷️ TAG CREATION - Git 태그 생성 및 원격 저장소 Push</critical>
+
+    <output>⚠️ **태그 생성 확인**
+
+      **버전:** {{new_version}}
+      **대상 커밋:** {{target_commit}}
+      **릴리즈 노트:** (위 내용 참조)
+
+      태그가 생성되면 GitHub Actions가 자동으로 릴리즈를 생성합니다.
+    </output>
+
+    <ask>태그를 생성하시겠습니까? [y/n]</ask>
+
+    <check if="user confirms">
+      <action>Annotated 태그 생성:
+        git tag -a {{new_version}} -m "Release {{new_version}}
+
+{{release_notes}}"
+      </action>
+
+      <check if="태그 생성 성공">
+        <output>✅ 태그 생성됨: {{new_version}}</output>
+      </check>
+
+      <check if="태그 생성 실패">
+        <output>🚫 태그 생성 실패: {{error_message}}</output>
+        <action>HALT</action>
+      </check>
+
+      <action>태그 Push:
+        git push origin {{new_version}}
+      </action>
+
+      <check if="push 성공">
+        <output>✅ 태그 Push 완료: {{new_version}}
+
+          GitHub Actions가 릴리즈를 자동으로 생성합니다.
+          릴리즈 페이지: https://github.com/{{owner}}/{{repo}}/releases/tag/{{new_version}}
+        </output>
+      </check>
+
+      <check if="push 실패">
+        <output>⚠️ 태그 Push 실패: {{error_message}}
+
+          로컬 태그는 생성되었습니다. 수동으로 push해주세요:
+          git push origin {{new_version}}
+        </output>
+      </check>
+    </check>
+
+    <check if="user cancels">
+      <output>❌ 릴리즈 취소됨</output>
+      <action>HALT</action>
+    </check>
+  </step>
+
+  <step n="4" goal="릴리즈 완료 및 정리">
+    <output>🎉 **릴리즈 완료!**
+
+      **버전:** {{new_version}}
+      **태그:** {{new_version}}
+      **릴리즈 URL:** https://github.com/{{owner}}/{{repo}}/releases/tag/{{new_version}}
+
+      **다음 단계:**
+      1. GitHub에서 릴리즈 페이지 확인
+      2. 필요시 릴리즈 노트 추가 편집
+      3. 릴리즈 자산(assets) 업로드 (필요한 경우)
+    </output>
+  </step>
+
+</workflow>

package/data/_bmad/bmm/workflows/github-release/workflow.yaml

@@ -0,0 +1,17 @@
+name: github-release
+description: "수동 트리거로 GitHub 태그 생성 및 릴리즈 등록"
+author: "BMAD"
+
+config_source: "{project-root}/_bmad/bmm/config.yaml"
+installed_path: "{project-root}/_bmad/bmm/workflows/github-release"
+instructions: "{installed_path}/instructions.xml"
+template: false
+standalone: true
+
+variables:
+  sprint_status: "{config_source:implementation_artifacts}/sprint-status.yaml"
+
+input_file_patterns:
+  sprint_status:
+    whole: "{config_source:implementation_artifacts}/sprint-status.yaml"
+    load_strategy: "FULL_LOAD"

package/data/_bmad/bmm/workflows/github-setup/instructions.xml

@@ -0,0 +1,241 @@
+<workflow>
+  <critical>The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml</critical>
+  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
+  <critical>Communicate all responses in {communication_language}</critical>
+
+  <step n="1" goal="환경 확인">
+    <critical>🔧 GITHUB SETUP - 프로젝트에 GitHub 설정 적용</critical>
+
+    <output>📋 **GitHub 설정 초기화**
+
+      이 워크플로우는 프로젝트에 다음 GitHub 설정을 적용합니다:
+      - GitHub Actions 워크플로우 (release-on-tag.yml)
+      - Issue 템플릿 (story.md, bug.md)
+      - Pull Request 템플릿
+
+    </output>
+
+    <action>git repository 확인: git rev-parse --git-dir</action>
+    <check if="git repository NOT detected">
+      <output>⚠️ Git 저장소가 감지되지 않습니다.</output>
+      <ask>Git 저장소를 초기화하시겠습니까? [y/n]</ask>
+      <check if="user confirms">
+        <action>git init</action>
+        <output>✅ Git 저장소 초기화 완료</output>
+      </check>
+      <check if="user cancels">
+        <output>❌ GitHub 설정을 적용하려면 Git 저장소가 필요합니다.</output>
+        <action>HALT</action>
+      </check>
+    </check>
+
+    <action>gh CLI 확인: gh --version</action>
+    <check if="gh CLI not installed">
+      <output>⚠️ GitHub CLI(gh)가 설치되지 않았습니다.
+
+        설치 방법:
+        - Windows: winget install GitHub.cli
+        - macOS: brew install gh
+        - Linux: https://github.com/cli/cli#installation
+
+        설치 후 `gh auth login`으로 인증해주세요.
+      </output>
+      <ask>gh CLI 없이 템플릿만 복사하시겠습니까? [y/n]</ask>
+      <check if="user cancels">
+        <action>HALT</action>
+      </check>
+    </check>
+
+    <action>gh CLI 인증 확인: gh auth status</action>
+    <check if="gh auth 실패">
+      <output>⚠️ GitHub CLI 인증이 필요합니다.</output>
+      <ask>`gh auth login`을 실행하시겠습니까? [y/n]</ask>
+      <check if="user confirms">
+        <action>gh auth login 안내 제공</action>
+      </check>
+    </check>
+  </step>
+
+  <step n="2" goal="기존 설정 확인">
+    <action>기존 .github 디렉토리 확인</action>
+
+    <check if=".github 디렉토리 존재">
+      <output>📁 기존 .github 디렉토리가 발견되었습니다.
+
+        **기존 파일:**
+        {{existing_files}}
+      </output>
+
+      <ask>기존 파일을 어떻게 처리할까요?
+        1. 덮어쓰기 (기존 파일 백업)
+        2. 병합 (기존 파일 유지, 없는 것만 추가)
+        3. 취소
+      </ask>
+
+      <check if="user chooses 1">
+        <action>기존 .github 디렉토리 백업: .github.backup.{{timestamp}}</action>
+        <action>{{overwrite_mode}} = true</action>
+      </check>
+
+      <check if="user chooses 2">
+        <action>{{merge_mode}} = true</action>
+      </check>
+
+      <check if="user chooses 3">
+        <output>❌ GitHub 설정 취소됨</output>
+        <action>HALT</action>
+      </check>
+    </check>
+
+    <check if=".github 디렉토리 없음">
+      <output>ℹ️ 새로운 .github 디렉토리를 생성합니다.</output>
+    </check>
+  </step>
+
+  <step n="3" goal="GitHub 템플릿 복사">
+    <critical>📋 COPY TEMPLATES - GitHub 템플릿 파일 복사</critical>
+
+    <action>.github/workflows 디렉토리 생성</action>
+    <action>.github/ISSUE_TEMPLATE 디렉토리 생성</action>
+
+    <!-- GitHub Actions 복사 -->
+    <check if="{{overwrite_mode}} OR workflows/release-on-tag.yml 없음">
+      <action>복사: {{github_templates}}/.github/workflows/release-on-tag.yml
+        → {{target_github_dir}}/workflows/release-on-tag.yml</action>
+      <output>✅ GitHub Actions 워크플로우 복사됨: release-on-tag.yml</output>
+    </check>
+
+    <!-- Issue 템플릿 복사 -->
+    <check if="{{overwrite_mode}} OR ISSUE_TEMPLATE/story.md 없음">
+      <action>복사: {{github_templates}}/.github/ISSUE_TEMPLATE/story.md
+        → {{target_github_dir}}/ISSUE_TEMPLATE/story.md</action>
+      <output>✅ Issue 템플릿 복사됨: story.md</output>
+    </check>
+
+    <check if="{{overwrite_mode}} OR ISSUE_TEMPLATE/bug.md 없음">
+      <action>복사: {{github_templates}}/.github/ISSUE_TEMPLATE/bug.md
+        → {{target_github_dir}}/ISSUE_TEMPLATE/bug.md</action>
+      <output>✅ Issue 템플릿 복사됨: bug.md</output>
+    </check>
+
+    <!-- PR 템플릿 복사 -->
+    <check if="{{overwrite_mode}} OR PULL_REQUEST_TEMPLATE.md 없음">
+      <action>복사: {{github_templates}}/.github/PULL_REQUEST_TEMPLATE.md
+        → {{target_github_dir}}/PULL_REQUEST_TEMPLATE.md</action>
+      <output>✅ PR 템플릿 복사됨: PULL_REQUEST_TEMPLATE.md</output>
+    </check>
+  </step>
+
+  <step n="4" goal="원격 저장소 확인">
+    <action>원격 저장소 확인: git remote -v</action>
+
+    <check if="원격 저장소 없음">
+      <output>⚠️ 원격 저장소가 설정되지 않았습니다.</output>
+      <ask>GitHub 저장소를 생성하시겠습니까? [y/n]</ask>
+
+      <check if="user confirms">
+        <ask>저장소 이름을 입력해주세요:</ask>
+        <ask>공개(public) 또는 비공개(private)? [public/private]</ask>
+        <action>gh repo create {{repo_name}} --{{visibility}} --source=. --remote=origin</action>
+        <output>✅ GitHub 저장소 생성됨: {{repo_url}}</output>
+      </check>
+    </check>
+
+    <check if="원격 저장소 존재">
+      <action>저장소 정보 추출: {{owner}}/{{repo}}</action>
+      <output>✅ 원격 저장소: {{owner}}/{{repo}}</output>
+    </check>
+  </step>
+
+  <step n="5" goal="저장소 머지 규칙 설정">
+    <critical>⚙️ REPO SETTINGS - 저장소 머지 규칙 설정</critical>
+
+    <output>📋 **저장소 머지 규칙 설정**
+
+      다음 설정을 적용합니다:
+      - Merge Commit만 허용 (머지 기록 유지)
+      - Squash Merge 비활성화
+      - Rebase Merge 비활성화
+      - 머지 후 브랜치 자동 삭제
+    </output>
+
+    <ask>저장소 머지 규칙을 설정하시겠습니까? [y/n]</ask>
+
+    <check if="user confirms">
+      <action>gh repo edit --enable-merge-commit --enable-squash-merge=false --enable-rebase-merge=false --delete-branch-on-merge</action>
+      <output>✅ 저장소 머지 규칙 설정 완료:
+        - Merge Commit: 허용
+        - Squash Merge: 비활성화
+        - Rebase Merge: 비활성화
+        - Delete Branch on Merge: 활성화</output>
+    </check>
+
+    <check if="user cancels">
+      <output>ℹ️ 저장소 머지 규칙 설정 건너뜀</output>
+    </check>
+  </step>
+
+  <step n="6" goal=".gitignore 설정">
+    <critical>📝 GITIGNORE - Claude 로컬 설정 제외</critical>
+
+    <output>📋 **.gitignore 설정**
+
+      다음 항목을 .gitignore에 추가합니다:
+      - .claude/settings.local.json (로컬 설정)
+      - .claude/plans/ (계획 파일)
+    </output>
+
+    <action>.gitignore 파일 확인</action>
+
+    <check if=".gitignore에 .claude/settings.local.json 없음">
+      <action>.gitignore에 추가:
+        # Claude Code (로컬 설정)
+        .claude/settings.local.json
+        .claude/plans/
+      </action>
+      <output>✅ .gitignore에 Claude 로컬 설정 제외 추가</output>
+    </check>
+
+    <check if=".gitignore에 이미 설정됨">
+      <output>ℹ️ .gitignore 이미 설정됨</output>
+    </check>
+  </step>
+
+  <step n="7" goal="설정 완료 및 안내">
+    <output>🎉 **GitHub 설정 완료!**
+
+      **적용된 설정:**
+      ✅ .github/workflows/release-on-tag.yml - 태그 push 시 자동 릴리즈
+      ✅ .github/ISSUE_TEMPLATE/story.md - 스토리 이슈 템플릿
+      ✅ .github/ISSUE_TEMPLATE/bug.md - 버그 리포트 템플릿
+      ✅ .github/PULL_REQUEST_TEMPLATE.md - PR 템플릿
+      ✅ 저장소 머지 규칙 - Merge Commit만 허용, 브랜치 자동 삭제
+      ✅ .gitignore - Claude 로컬 설정 제외
+
+      **다음 단계:**
+      1. 변경사항 커밋: `git add .github && git commit -m "chore: add GitHub templates"`
+      2. 원격 저장소에 Push: `git push origin main`
+      3. GitHub Actions 확인: https://github.com/{{owner}}/{{repo}}/actions
+
+      **사용 방법:**
+      - 릴리즈 생성: SM 에이전트에서 `*github-release` 실행
+      - 또는 태그 push: `git tag v1.0.0 && git push origin v1.0.0`
+    </output>
+
+    <ask>변경사항을 지금 커밋하고 Push하시겠습니까? [y/n]</ask>
+
+    <check if="user confirms">
+      <action>git add .github</action>
+      <action>git commit -m "chore: add GitHub templates and workflows
+
+- Add release-on-tag.yml for automatic releases
+- Add issue templates (story, bug)
+- Add pull request template
+
+Generated by BMAD Method"</action>
+      <action>git push origin {{current_branch}}</action>
+      <output>✅ 변경사항 Push 완료!</output>
+    </check>
+  </step>
+
+</workflow>

package/data/_bmad/bmm/workflows/github-setup/workflow.yaml

@@ -0,0 +1,13 @@
+name: github-setup
+description: "BMAD 프로젝트에 GitHub 설정 자동 적용 (Actions, 템플릿 등)"
+author: "BMAD"
+
+config_source: "{project-root}/_bmad/bmm/config.yaml"
+installed_path: "{project-root}/_bmad/bmm/workflows/github-setup"
+instructions: "{installed_path}/instructions.xml"
+template: false
+standalone: true
+
+variables:
+  github_templates: "{project-root}/_bmad/bmm/data/github-templates"
+  target_github_dir: "{project-root}/.github"

package/data/_bmad/bmm/workflows/qa/automate/checklist.md

@@ -0,0 +1,33 @@
+# Quinn Automate - Validation Checklist
+
+## Test Generation
+
+- [ ] API tests generated (if applicable)
+- [ ] E2E tests generated (if UI exists)
+- [ ] Tests use standard test framework APIs
+- [ ] Tests cover happy path
+- [ ] Tests cover 1-2 critical error cases
+
+## Test Quality
+
+- [ ] All generated tests run successfully
+- [ ] Tests use proper locators (semantic, accessible)
+- [ ] Tests have clear descriptions
+- [ ] No hardcoded waits or sleeps
+- [ ] Tests are independent (no order dependency)
+
+## Output
+
+- [ ] Test summary created
+- [ ] Tests saved to appropriate directories
+- [ ] Summary includes coverage metrics
+
+## Validation
+
+Run the tests using your project's test command.
+
+**Expected**: All tests pass ✅
+
+---
+
+**Need more comprehensive testing?** Install [Test Architect (TEA)](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/) for advanced workflows.

package/data/_bmad/bmm/workflows/qa/automate/instructions.md

@@ -0,0 +1,110 @@
+# Quinn QA - Automate
+
+**Goal**: Generate automated API and E2E tests for implemented code.
+
+**Scope**: This workflow generates tests ONLY. It does **not** perform code review or story validation (use Code Review `CR` for that).
+
+## Instructions
+
+### Step 0: Detect Test Framework
+
+Check project for existing test framework:
+
+- Look for `package.json` dependencies (playwright, jest, vitest, cypress, etc.)
+- Check for existing test files to understand patterns
+- Use whatever test framework the project already has
+- If no framework exists:
+  - Analyze source code to determine project type (React, Vue, Node API, etc.)
+  - Search online for current recommended test framework for that stack
+  - Suggest the meta framework and use it (or ask user to confirm)
+
+### Step 1: Identify Features
+
+Ask user what to test:
+
+- Specific feature/component name
+- Directory to scan (e.g., `src/components/`)
+- Or auto-discover features in the codebase
+
+### Step 2: Generate API Tests (if applicable)
+
+For API endpoints/services, generate tests that:
+
+- Test status codes (200, 400, 404, 500)
+- Validate response structure
+- Cover happy path + 1-2 error cases
+- Use project's existing test framework patterns
+
+### Step 3: Generate E2E Tests (if UI exists)
+
+For UI features, generate tests that:
+
+- Test user workflows end-to-end
+- Use semantic locators (roles, labels, text)
+- Focus on user interactions (clicks, form fills, navigation)
+- Assert visible outcomes
+- Keep tests linear and simple
+- Follow project's existing test patterns
+
+### Step 4: Run Tests
+
+Execute tests to verify they pass (use project's test command).
+
+If failures occur, fix them immediately.
+
+### Step 5: Create Summary
+
+Output markdown summary:
+
+```markdown
+# Test Automation Summary
+
+## Generated Tests
+
+### API Tests
+- [x] tests/api/endpoint.spec.ts - Endpoint validation
+
+### E2E Tests
+- [x] tests/e2e/feature.spec.ts - User workflow
+
+## Coverage
+- API endpoints: 5/10 covered
+- UI features: 3/8 covered
+
+## Next Steps
+- Run tests in CI
+- Add more edge cases as needed
+```
+
+## Keep It Simple
+
+**Do:**
+
+- Use standard test framework APIs
+- Focus on happy path + critical errors
+- Write readable, maintainable tests
+- Run tests to verify they pass
+
+**Avoid:**
+
+- Complex fixture composition
+- Over-engineering
+- Unnecessary abstractions
+
+**For Advanced Features:**
+
+If the project needs:
+
+- Risk-based test strategy
+- Test design planning
+- Quality gates and NFR assessment
+- Comprehensive coverage analysis
+- Advanced testing patterns and utilities
+
+→ **Install Test Architect (TEA) module**: <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
+
+## Output
+
+Save summary to: `{implementation_artifacts}/tests/test-summary.md`
+
+**Done!** Tests generated and verified.

package/data/_bmad/bmm/workflows/qa/automate/workflow.yaml

@@ -0,0 +1,47 @@
+# Quinn QA workflow: Automate
+name: qa-automate
+description: "Generate tests quickly for existing features using standard test patterns"
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/bmm/config.yaml"
+output_folder: "{config_source}:output_folder"
+implementation_artifacts: "{config_source}:implementation_artifacts"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/_bmad/bmm/workflows/qa/automate"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+template: false
+
+# Variables and inputs
+variables:
+  # Directory paths
+  test_dir: "{project-root}/tests" # Root test directory
+  source_dir: "{project-root}" # Source code directory
+
+# Output configuration
+default_output_file: "{implementation_artifacts}/tests/test-summary.md"
+
+# Required tools
+required_tools:
+  - read_file # Read source code and existing tests
+  - write_file # Create test files
+  - create_directory # Create test directories
+  - list_files # Discover features
+  - search_repo # Find patterns
+  - glob # Find files
+
+tags:
+  - qa
+  - automation
+  - testing
+
+execution_hints:
+  interactive: false
+  autonomous: true
+  iterative: false