mergegate/docs/PREPARATION_OPS.md

Preparation Operations - miyabi-cli-standalone

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/miyabi-cli-standalone | wc -l
  # Expected: 45+ labels
  

• 不足ラベル追加

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

2.2 Milestones Verification

• マイルストーン確認

  gh api repos/ShunsukeHayashi/miyabi-cli-standalone/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/miyabi-cli-standalone --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/miyabi-cli-standalone/pulse
  

---

9. Sprint 1 Kickoff Preparation

9.1 First Tasks Ready

• Issue #10 (MarkdownStream core)

  gh issue view 10 --repo ShunsukeHayashi/miyabi-cli-standalone
  

• 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/miyabi-cli-standalone
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! 🚀