marketing-shibata50/mergegate
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
mergegate/docs/PREPARATION_OPS.md
林 駿甫 (Shunsuke Hayashi) 29c72fee83 refactor: rename project surface to mergegate
2026-04-10 14:50:57 +09:00

7 KiB
Raw Permalink Blame History

Preparation Operations - MergeGate

Purpose: Sprint 1開始前の準備作業チェックリスト Target Date: 2025-11-25 (Sprint 1 Start)

📋 Pre-Sprint Checklist

1. Environment Setup

1.1 Development Environment

  • Rust toolchain

    rustup update stable
rustup component add clippy rustfmt
cargo --version  # 1.75+

  • GitHub CLI

    gh --version
gh auth status

  • Miyabi CLI

    /Users/shunsuke/Dev/01-miyabi/_core/miyabi-private/target/release/miyabi --version

1.2 API Keys

  • GitHub Token

    # .env に設定
echo "GITHUB_TOKEN=ghp_xxx" >> .env

# 必要なスコープ: repo, workflow
gh auth refresh -s repo,workflow

  • Anthropic API Key

    echo "ANTHROPIC_API_KEY=sk-ant-xxx" >> .env

# テスト
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'

1.3 Project Dependencies

  • Node.js dependencies

    npm install

  • Cargo dependencies (初回ビルドで取得)

    cargo fetch

2. Repository Setup

2.1 Labels Verification

  • 必要なラベル確認

    gh label list --repo ShunsukeHayashi/mergegate | wc -l
# Expected: 45+ labels

  • 不足ラベル追加

    # 必要に応じて
gh label create "🔥 urgent" --color "d73a4a" --description "Urgent issue"

2.2 Milestones Verification

  • マイルストーン確認

    gh api repos/ShunsukeHayashi/mergegate/milestones | jq '.[].title'

    Expected:

    • v0.2.0 - Advanced Text Rendering
    • v0.3.0 - Chat Composer
    • v0.4.0 - Approval & Navigation
    • v1.0.0 - Production Ready

2.3 Issues Verification

  • Issue一覧確認

    gh issue list --repo ShunsukeHayashi/mergegate --state all | wc -l
# Expected: 28 issues

  • Sprint 1タスク確認

    gh issue list --milestone "v0.2.0 - Advanced Text Rendering" --label "📊 priority:P0-Critical"

3. Codebase Preparation

3.1 Directory Structure

  • 必要ディレクトリ作成 
    mkdir -p crates/miyabi-cli/src
mkdir -p crates/miyabi-core/src
mkdir -p crates/miyabi-tui/src
mkdir -p tests

3.2 Cargo.toml Setup

  • ワークスペース設定確認

    cat Cargo.toml | grep "members"

  • 各crateのCargo.toml確認

    ls crates/*/Cargo.toml

3.3 Initial Build Test

  • ビルドテスト 
    cargo build
cargo test
cargo clippy

4. CI/CD Setup

4.1 GitHub Actions

  • ワークフロー確認

    ls .github/workflows/

  • CI設定 (create if not exists)

    # .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - run: cargo build --all
      - run: cargo test --all
      - run: cargo clippy --all -- -D warnings

4.2 Branch Protection

  • main ブランチ保護
    • Require PR reviews
    • Require status checks
    • Require linear history

5. Documentation

5.1 Required Documents

  • README.md
  • CLAUDE.md
  • GOALS.md
  • docs/WBS.md
  • docs/SPRINT_PLANNING.md
  • docs/OPERATION_PLAN.md
  • docs/PRODUCT_SPEC.md
  • docs/PREPARATION_OPS.md (this file)

5.2 PlantUML Diagrams

  • docs/wbs-diagram.puml
  • docs/gantt-chart.puml

6. Reference Materials

6.1 Codex CLI Reference

  • Clone Codex CLI

    git clone https://github.com/openai/codex.git /tmp/codex-reference

  • 主要ファイル確認

    ls /tmp/codex-reference/codex-rs/tui/src/

  • 参照用ブックマーク

    • markdown_stream.rs
    • diff_render.rs
    • chat_composer.rs
    • textarea.rs

6.2 Miyabi Private Reference

  • Agent実装参照 
    ls /Users/shunsuke/Dev/01-miyabi/_core/miyabi-private/crates/

7. Team Communication

7.1 Notification Setup

  • Slack/Discord通知 (if applicable)

  • GitHub通知設定

    • Watch repository
    • Enable PR notifications

7.2 Daily Standup Schedule

  • Standup時間設定
    • Time: 毎朝 9:00
    • Duration: 10分
    • Format: miyabi status確認

8. Monitoring Setup

8.1 Miyabi Monitoring

  • ログディレクトリ確認

    mkdir -p logs
mkdir -p reports

  • ログローテーション設定

    # 30日以上のログを削除
find logs -mtime +30 -delete

8.2 GitHub Insights

  • Pulse確認 
    https://github.com/ShunsukeHayashi/mergegate/pulse

9. Sprint 1 Kickoff Preparation

9.1 First Tasks Ready

  • Issue #10 (MarkdownStream core)

    gh issue view 10 --repo ShunsukeHayashi/mergegate

  • Issue #15 (DiffRender core)

    gh issue view 15

  • Issue #19 (API client)

    gh issue view 19

  • Issue #24 (Tool trait)

    gh issue view 24

9.2 Agent Configuration

  • Miyabi設定確認

    cat .miyabi.yml

  • .claude設定確認

    ls .claude/
ls .claude/agents/specs/

🚀 Kickoff Commands

Sprint 1 Day 1 (2025-11-25)

# 1. 環境確認
cd /Users/shunsuke/Dev/mergegate
miyabi status

# 2. Critical Path 開始
miyabi agent run coordinator --issue 19  # API Client (CRITICAL)

# 3. Parallel tasks 開始
miyabi agent run coordinator --issue 10  # Markdown Core
miyabi agent run coordinator --issue 15  # Diff Core
miyabi agent run coordinator --issue 24  # Tool Trait

# 4. 進捗監視
watch -n 60 'gh issue list --label "🏗️ state:implementing"'

✅ Final Checklist

Must Have (Sprint開始前)

  • Rust toolchain ready
  • API keys configured
  • GitHub labels/milestones set
  • Initial crate structure
  • CI workflow active

Should Have

  • Codex CLI reference cloned
  • PlantUML diagrams reviewed
  • All documentation in place

Nice to Have

  • Notification integrations
  • Performance baselines

📞 Emergency Contacts

Issue Action
API Key invalid Regenerate at console.anthropic.com
GitHub rate limit Wait 1 hour or use different token
Build failure Check Cargo.toml, dependencies
Agent stuck Check logs, reset issue state

📝 Sign-off

Item Status Date Notes
Environment ⬜
Repository ⬜
Codebase ⬜
CI/CD ⬜
Documentation ✅ 2025-11-22 Complete
References ⬜
Monitoring ⬜

Ready for Sprint 1? Let's go! 🚀