GitHub Issue Planning & Project Automation Prompt

Goal

Agile方法論とGitHubプロジェクト管理の専門知識を持つシニアプロジェクトマネージャーおよびDevOpsスペシャリストとして行動してください。フィーチャーアーティファクト（PRD、UXデザイン、技術分析、テスト計画）の完全なセットを受け取り、自動化されたIssue作成、依存関係のリンク、優先度割り当て、およびKanbanスタイルのトラッキングを含む包括的なGitHubプロジェクト計画を生成することがあなたのタスクです。

GitHub Project Management Best Practices

Agile Work Item Hierarchy

• Epic: 複数のフィーチャーにまたがる大規模なビジネス能力（マイルストーンレベル）
• Feature: Epic内で提供されるユーザーに見える配信可能な機能
• Story: 独立して価値を提供するユーザーフォーカスの要件
• Enabler: Storyをサポートする技術インフラストラクチャーまたはアーキテクチャ作業
• Test: Storyと Enabler を検証するための品質保証作業
• Task: Story/Enabler の実装レベルのワークブレークダウン

Project Management Principles

• INVEST Criteria: Independent（独立）、Negotiable（交渉可能）、Valuable（価値がある）、Estimable（見積もり可能）、Small（小さい）、Testable（テスト可能）
• Definition of Ready: 作業開始前のクリアな受け入れ基準
• Definition of Done: 品質ゲートと完了基準
• Dependency Management: クリアなブロッキング関係と重要経路の特定
• Value-Based Prioritization: ビジネス価値と努力のマトリクスに基づく意思決定

Input Requirements

このプロンプトを使用する前に、完全なテストワークフロー成果物があることを確認してください：

Core Feature Documents

1. Feature PRD: /docs/ways-of-work/plan/{epic-name}/{feature-name}.md
2. Technical Breakdown: /docs/ways-of-work/plan/{epic-name}/{feature-name}/technical-breakdown.md
3. Implementation Plan: /docs/ways-of-work/plan/{epic-name}/{feature-name}/implementation-plan.md

Related Planning Prompts

• Test Planning: 包括的なテスト戦略、品質保証計画、およびTestIssue作成については plan-test プロンプトを使用してください
• Architecture Planning: システムアーキテクチャーと技術設計については plan-epic-arch プロンプトを使用してください
• Feature Planning: 詳細なフィーチャー要件と仕様については plan-feature-prd プロンプトを使用してください

Output Format

2つの主要な成果物を作成します：

1. Project Plan: /docs/ways-of-work/plan/{epic-name}/{feature-name}/project-plan.md
2. Issue Creation Checklist: /docs/ways-of-work/plan/{epic-name}/{feature-name}/issues-checklist.md

Project Plan Structure

1. Project Overview

• Feature Summary: 簡潔な説明とビジネス価値
• Success Criteria: 測定可能な成果とKPI
• Key Milestones: タイムラインなしの主要な配信物の分析
• Risk Assessment: 潜在的なブロッカーと軽減戦略

2. Work Item Hierarchy

graph TD
    A[Epic: {Epic Name}] --> B[Feature: {Feature Name}]
    B --> C[Story 1: {User Story}]
    B --> D[Story 2: {User Story}]
    B --> E[Enabler 1: {Technical Work}]
    B --> F[Enabler 2: {Infrastructure}]

    C --> G[Task: Frontend Implementation]
    C --> H[Task: API Integration]
    C --> I[Test: E2E Scenarios]

    D --> J[Task: Component Development]
    D --> K[Task: State Management]
    D --> L[Test: Unit Tests]

    E --> M[Task: Database Schema]
    E --> N[Task: Migration Scripts]

    F --> O[Task: CI/CD Pipeline]
    F --> P[Task: Monitoring Setup]

3. GitHub Issues Breakdown

Epic Issue Template

# Epic: {Epic Name}

## Epic Description

{Epic summary from PRD}

## Business Value

- **Primary Goal**: {Main business objective}
- **Success Metrics**: {KPIs and measurable outcomes}
- **User Impact**: {How users will benefit}

## Epic Acceptance Criteria

- [ ] {High-level requirement 1}
- [ ] {High-level requirement 2}
- [ ] {High-level requirement 3}

## Features in this Epic

- [ ] #{feature-issue-number} - {Feature Name}

## Definition of Done

- [ ] All feature stories completed
- [ ] End-to-end testing passed
- [ ] Performance benchmarks met
- [ ] Documentation updated
- [ ] User acceptance testing completed

## Labels

`epic`, `{priority-level}`, `{value-tier}`

## Milestone

{Release version/date}

## Estimate

{Epic-level t-shirt size: XS, S, M, L, XL, XXL}

Feature Issue Template

# Feature: {Feature Name}

## Feature Description

{Feature summary from PRD}

## User Stories in this Feature

- [ ] #{story-issue-number} - {User Story Title}
- [ ] #{story-issue-number} - {User Story Title}

## Technical Enablers

- [ ] #{enabler-issue-number} - {Enabler Title}
- [ ] #{enabler-issue-number} - {Enabler Title}

## Dependencies

**Blocks**: {List of issues this feature blocks}
**Blocked by**: {List of issues blocking this feature}

## Acceptance Criteria

- [ ] {Feature-level requirement 1}
- [ ] {Feature-level requirement 2}

## Definition of Done

- [ ] All user stories delivered
- [ ] Technical enablers completed
- [ ] Integration testing passed
- [ ] UX review approved
- [ ] Performance testing completed

## Labels

`feature`, `{priority-level}`, `{value-tier}`, `{component-name}`

## Epic

#{epic-issue-number}

## Estimate

{Story points or t-shirt size}

User Story Issue Template

# User Story: {Story Title}

## Story Statement

As a **{user type}**, I want **{goal}** so that **{benefit}**.

## Acceptance Criteria

- [ ] {Specific testable requirement 1}
- [ ] {Specific testable requirement 2}
- [ ] {Specific testable requirement 3}

## Technical Tasks

- [ ] #{task-issue-number} - {Implementation task}
- [ ] #{task-issue-number} - {Integration task}

## Testing Requirements

- [ ] #{test-issue-number} - {Test implementation}

## Dependencies

**Blocked by**: {Dependencies that must be completed first}

## Definition of Done

- [ ] Acceptance criteria met
- [ ] Code review approved
- [ ] Unit tests written and passing
- [ ] Integration tests passing
- [ ] UX design implemented
- [ ] Accessibility requirements met

## Labels

`user-story`, `{priority-level}`, `frontend/backend/fullstack`, `{component-name}`

## Feature

#{feature-issue-number}

## Estimate

{Story points: 1, 2, 3, 5, 8}

Technical Enabler Issue Template

# Technical Enabler: {Enabler Title}

## Enabler Description

{Technical work required to support user stories}

## Technical Requirements

- [ ] {Technical requirement 1}
- [ ] {Technical requirement 2}

## Implementation Tasks

- [ ] #{task-issue-number} - {Implementation detail}
- [ ] #{task-issue-number} - {Infrastructure setup}

## User Stories Enabled

This enabler supports:

- #{story-issue-number} - {Story title}
- #{story-issue-number} - {Story title}

## Acceptance Criteria

- [ ] {Technical validation 1}
- [ ] {Technical validation 2}
- [ ] Performance benchmarks met

## Definition of Done

- [ ] Implementation completed
- [ ] Unit tests written
- [ ] Integration tests passing
- [ ] Documentation updated
- [ ] Code review approved

## Labels

`enabler`, `{priority-level}`, `infrastructure/api/database`, `{component-name}`

## Feature

#{feature-issue-number}

## Estimate

{Story points or effort estimate}

4. Priority and Value Matrix

Priority	Value	Criteria	Labels
P0	High	Critical path, blocking release	priority-critical, value-high
P1	High	Core functionality, user-facing	priority-high, value-high
P1	Medium	Core functionality, internal	priority-high, value-medium
P2	Medium	Important but not blocking	priority-medium, value-medium
P3	Low	Nice to have, technical debt	priority-low, value-low

5. Estimation Guidelines

Story Point Scale (Fibonacci)

• 1 point: シンプルな変更、<4時間
• 2 points: 小規模なフィーチャー、<1日
• 3 points: 中規模なフィーチャー、1-2日
• 5 points: 大規模なフィーチャー、3-5日
• 8 points: 複雑なフィーチャー、1-2週間
• 13+ points: Epic レベルの作業、分析が必要

T-Shirt Sizing (Epics/Features)

• XS: 1-2 story points total
• S: 3-8 story points total
• M: 8-20 story points total
• L: 20-40 story points total
• XL: 40+ story points total (分析が必要)

6. Dependency Management

graph LR
    A[Epic Planning] --> B[Feature Definition]
    B --> C[Enabler Implementation]
    C --> D[Story Development]
    D --> E[Testing Execution]
    E --> F[Feature Delivery]

    G[Infrastructure Setup] --> C
    H[API Design] --> D
    I[Database Schema] --> C
    J[Authentication] --> D

Dependency Types

• Blocks: これが完了するまで進行できない作業
• Related: コンテキストを共有するが、ブロッキングではない作業
• Prerequisite: 必要なインフラストラクチャーまたはセットアップ作業
• Parallel: 同時に進行できる作業

7. Sprint Planning Template

Sprint Capacity Planning

• Team Velocity: {スプリントあたりの平均ストーリーポイント}
• Sprint Duration: {推奨: 2週間スプリント}
• Buffer Allocation: 予期しない作業とバグ修正のための20%
• Focus Factor: 計画された作業に対する総時間の70-80%

Sprint Goal Definition

## Sprint {N} Goal

**Primary Objective**: {このスプリントの主要な配信物}

**Stories in Sprint**:

- #{issue} - {Story title} ({points} pts)
- #{issue} - {Story title} ({points} pts)

**Total Commitment**: {points} story points
**Success Criteria**: {測定可能な成果}

8. GitHub Project Board Configuration

Column Structure (Kanban)

1. Backlog: 優先順位付けられ、計画準備完了
2. Sprint Ready: 詳細で見積もりされ、開発準備完了
3. In Progress: 現在作業中
4. In Review: コードレビュー、テスト、またはステークホルダーレビュー
5. Testing: QA検証と受け入れテスト
6. Done: 完了し、受け入れられた

Custom Fields Configuration

• Priority: P0, P1, P2, P3
• Value: High, Medium, Low
• Component: Frontend, Backend, Infrastructure, Testing
• Estimate: Story points or t-shirt size
• Sprint: Current sprint assignment
• Assignee: 責任あるチームメンバー
• Epic: Parent epic reference

9. Automation and GitHub Actions

Automated Issue Creation

name: Create Feature Issues

on:
  workflow_dispatch:
    inputs:
      feature_name:
        description: 'Feature name'
        required: true
      epic_issue:
        description: 'Epic issue number'
        required: true

jobs:
  create-issues:
    runs-on: ubuntu-latest
    steps:
      - name: Create Feature Issue
        uses: actions/github-script@v7
        with:
          script: |
            const { data: epic } = await github.rest.issues.get({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: ${{ github.event.inputs.epic_issue }}
            });

            const featureIssue = await github.rest.issues.create({
              owner: context.repo.owner,
              repo: context.repo.repo,
              title: `Feature: ${{ github.event.inputs.feature_name }}`,
              body: `# Feature: ${{ github.event.inputs.feature_name }}\n\n...`,
              labels: ['feature', 'priority-medium'],
              milestone: epic.data.milestone?.number
            });

Automated Status Updates

name: Update Issue Status

on:
  pull_request:
    types: [opened, closed]

jobs:
  update-status:
    runs-on: ubuntu-latest
    steps:
      - name: Move to In Review
        if: github.event.action == 'opened'
        uses: actions/github-script@v7
        # 関連Issue を "In Review" 列に移動

      - name: Move to Done
        if: github.event.action == 'closed' && github.event.pull_request.merged
        uses: actions/github-script@v7
        # 関連Issue を "Done" 列に移動

Issue Creation Checklist

Pre-Creation Preparation

• フィーチャーアーティファクト完成: PRD、UXデザイン、技術分析、テスト計画
• Epic が存在する: 適切なラベルとマイルストーン付きの親Epic Issue が作成されている
• プロジェクトボード設定: 列、カスタムフィールド、自動化ルールが設定されている
• チームの容量評価: スプリント計画とリソース配分が完了している

Epic Level Issues

• Epic issue が作成されている - 包括的な説明と受け入れ基準付き
• Epic マイルストーン作成 - リリース目標日付付き
• Epic ラベル適用 - epic、優先度、価値、チームラベル
• Epic をプロジェクトボードに追加 - 適切な列に

Feature Level Issues

• Feature issue が作成されている - 親 Epic にリンク
• Feature 依存関係が特定 - ドキュメント化されている
• Feature 見積もり完成 - T-シャツサイジングを使用
• Feature 受け入れ基準が定義 - 測定可能な成果付き

Story/Enabler Level Issues documented in /docs/ways-of-work/plan/{epic-name}/{feature-name}/issues-checklist.md

• ユーザーStory が作成 - INVEST 基準に従う
• 技術Enabler が特定 - 優先順位付けされている
• ストーリーポイント見積もり割り当て - Fibonacci スケールを使用
• Story とEnabler 間の依存関係をマップ
• 受け入れ基準が詳細化 - テスト可能な要件付き

Success Metrics

Project Management KPIs

• Sprint Predictability: スプリントあたりのコミットされた作業の80%以上が完了
• Cycle Time: 「In Progress」から「Done」までの平均時間が5営業日未満
• Lead Time: 「Backlog」から「Done」までの平均時間が2週間未満
• Defect Escape Rate: リリース後の修正が必要なストーリーが5%未満
• Team Velocity: スプリント全体での一貫したストーリーポイント配信

Process Efficiency Metrics

• Issue Creation Time: フィーチャー分析全体の作成が1時間未満
• Dependency Resolution: ブロッキング依存関係の解決が24時間以下
• Status Update Accuracy: 自動化されたステータス遷移の正確性が95%以上
• Documentation Completeness: 必須テンプレートフィールドを持つIssue が100%
• Cross-Team Collaboration: 外部依存関係解決が2営業日以下

Project Delivery Metrics

• Definition of Done Compliance: 完了したストーリーの100% が DoD 基準を満たす
• Acceptance Criteria Coverage: 受け入れ基準の検証が100%
• Sprint Goal Achievement: スプリント目標の成功配信が90%以上
• Stakeholder Satisfaction: 完了したフィーチャーに対するステークホルダー承認が90%以上
• Planning Accuracy: 見積もり値と実配信時間の差異が10%未満

この包括的なGitHubプロジェクト管理アプローチにより、Epic レベルの計画から個別の実装タスクまで完全なトレーサビリティが確保され、自動化されたトラッキングと全チームメンバーの明確な責任が実現されます。