Antigravity AgentKit 2.0で受託案件を3倍速でこなす現場ワークフロー完全公開

# Project Agents
 
## 1. Requirement Agent（要件定義エージェント）
**Role**: クライアント要件をシステム設計に翻訳
**Responsibility**:
- Figmaデザインから画面フロー・UI仕様を抽出
- ビジネスロジック（予約ルール・キャンセル規則など）を明文化
- APIエンドポイント仕様書を自動生成
 
**Constraints**:
- クライアント提供資料（メール・仕様書・Figma）のみ入力源とする
- 自分で意思決定しない（不明点はImplementation Agentに質問）
 
**Tools**:
- File reading (Figma JSON export)
- Markdown editing (仕様書生成)
- API specification (OpenAPI format)
 
---
 
## 2. Frontend Agent（フロントエンド実装エージェント）
**Role**: Next.js + TailwindCSS でUI構築
**Responsibility**:
- 予約カレンダーコンポーネント（React hooks + Zustand）
- フォーム検証・エラーハンドリング
- 医療機関向けアクセシビリティ対応（WCAG 2.1 AA）
- E2Eテスト（Playwright）
 
**Constraints**:
- TailwindCSS のみ使用（UI frameworks 禁止）
- コンポーネント単位の分割（最大100行）
- 仕様外の技術判断をしない（Backend Agent と協調）
 
**Files**:
- src/components/
- src/pages/
- e2e/
 
---
 
## 3. Backend Agent（バックエンド実装エージェント）
**Role**: Node.js + Hono API 開発
**Responsibility**:
- 予約確保・キャンセルAPI（トランザクション保証）
- メール送信キューイング（Firebase Cloud Tasks or Bull）
- SQLServer レガシーDB との ETL（毎日夜間）
- Rate limiting & 認証（Supabase JWT）
 
**Constraints**:
- PostgreSQL (Supabase) を Single Source of Truth とする
- トランザクション必須（テスト時は自動ロールバック）
- ログ出力は日本語NG（英語で統一、ローカライズは client-side）
 
**Files**:
- src/api/
- src/db/
- tests/unit/
 
---
 
## 4. QA Agent（テスト・品質保証エージェント）
**Role**: 自動テスト生成 & 品質監視
**Responsibility**:
- ユニットテスト (Jest) → Coverage 80% 以上
- 統合テスト (Supertest) → API エンドポイント
- E2Eテスト (Playwright) → ユーザーフロー
- セキュリティ監査 → OWASPトップ10チェック
 
**Constraints**:
- テスト実行時間は 5分以下を目安
- Mocking はデータベース層のみ
- テストコードも本体と同じ品質基準
 
**Files**:
- tests/
 
---
 
## 5. Deployment Agent（デプロイメントエージェント）
**Role**: 本番環境へのリリース & モニタリング
**Responsibility**:
- Vercel への自動デプロイ (Next.js)
- Cloudflare Workers へのデプロイ (API)
- 環境変数・シークレット管理
- GitHub Actions CI/CD パイプライン構築
- デプロイ後のヘルスチェック
 
**Constraints**:
- 本番リリースは必ず dry-run を先行実行
- ロールバック手順を docs/ROLLBACK.md に記載
- デプロイ時間は 3分以下
 
---
 
## Agent Handoff Rules（エージェント間の引き継ぎルール）
 
1. **Requirement → Frontend/Backend**: 仕様書（Markdown + OpenAPI）でハンドオフ
2. **Frontend → QA**: PR を作成し、QA が自動テスト実装
3. **Backend → QA**: テストスイート実行、Coverage レポート確認
4. **QA → Deployment**: テスト全パス後に Deployment Agent へ通知
5. **Deployment → Client**: デプロイ完了通知 + 動作確認チェックリスト送付
 
---
 
## Success Metrics
- コード生成エラー率: < 5%
- テストカバレッジ: 80% 以上
- デプロイ失敗率: 0%
- 納期遵守率: 100%

// Frontend Agent: src/components/AppointmentCalendar.tsx
import { useState } from 'react'
import { supabase } from '@/lib/supabase'
 
export const AppointmentCalendar = () => {
  const [selectedDate, setSelectedDate] = useState<Date | null>(null)
  const [selectedTime, setSelectedTime] = useState<string | null>(null)
 
  const handleConfirm = async () => {
    if (!selectedDate || !selectedTime) return
 
    const { data, error } = await supabase
      .from('appointments')
      .insert([
        {
          patient_id: 'YOUR_PATIENT_ID',
          appointment_date: selectedDate.toISOString(),
          appointment_time: selectedTime,
        },
      ])
 
    if (error) console.error('Booking failed:', error)
    else console.log('Booking confirmed:', data)
  }
 
  return (
    <div className="space-y-4">
      {/* Calendar picker UI */}
      <button onClick={handleConfirm}>予約を確定する</button>
    </div>
  )
}

// Backend Agent: src/api/appointments.ts
import { Hono } from 'hono'
import { postgres } from '@/db'
 
const app = new Hono()
 
app.post('/appointments', async (c) => {
  const body = await c.req.json()
  const { patient_id, appointment_date, appointment_time } = body
 
  // Transaction: check availability + insert
  const client = await postgres.connect()
  try {
    await client.query('BEGIN')
 
    const existing = await client.query(
      'SELECT * FROM appointments WHERE appointment_date = $1 AND appointment_time = $2 AND status = $3',
      [appointment_date, appointment_time, 'confirmed']
    )
 
    if (existing.rows.length > 0) {
      await client.query('ROLLBACK')
      return c.json({ error: 'Time slot unavailable' }, 409)
    }
 
    await client.query(
      'INSERT INTO appointments (patient_id, appointment_date, appointment_time, status) VALUES ($1, $2, $3, $4)',
      [patient_id, appointment_date, appointment_time, 'confirmed']
    )
 
    await client.query('COMMIT')
    return c.json({ success: true })
  } catch (err) {
    await client.query('ROLLBACK')
    return c.json({ error: 'Database error' }, 500)
  }
})
 
export default app

// QA Agent: tests/unit/appointments.test.ts
import { describe, it, expect, beforeEach } from 'vitest'
import { supabase } from '@/lib/supabase'
 
describe('Appointments API', () => {
  beforeEach(async () => {
    // Clear test data
    await supabase.from('appointments').delete().neq('id', -1)
  })
 
  it('should confirm appointment when slot is available', async () => {
    const response = await fetch('/api/appointments', {
      method: 'POST',
      body: JSON.stringify({
        patient_id: 'test-patient-1',
        appointment_date: '2026-04-10',
        appointment_time: '14:00',
      }),
    })
 
    expect(response.status).toBe(200)
    const data = await response.json()
    expect(data.success).toBe(true)
  })
 
  it('should reject booking when slot is taken', async () => {
    // Insert existing appointment
    await supabase.from('appointments').insert([
      {
        patient_id: 'test-patient-2',
        appointment_date: '2026-04-10',
        appointment_time: '14:00',
        status: 'confirmed',
      },
    ])
 
    const response = await fetch('/api/appointments', {
      method: 'POST',
      body: JSON.stringify({
        patient_id: 'test-patient-3',
        appointment_date: '2026-04-10',
        appointment_time: '14:00',
      }),
    })
 
    expect(response.status).toBe(409)
  })
})

npm test -- --coverage

# .github/workflows/deploy.yml
name: Deploy to Production
 
on:
  workflow_dispatch:  # 手動トリガーのみ（自動デプロイ禁止）
 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - run: npm test
      - run: npm run test:e2e
 
  deploy:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Deploy to Vercel
        env:
          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
        run: npx vercel deploy --prod --token $VERCEL_TOKEN
      - name: Deploy API to Cloudflare
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
        run: npm run deploy:workers
 
  notify:
    needs: deploy
    runs-on: ubuntu-latest
    steps:
      - name: Send Slack notification
        run: |
          curl -X POST ${{ secrets.SLACK_WEBHOOK }} \
            -d '{"text":"✅ Production deployment successful"}'

# 本日の進捗レポート（2026-04-02）
 
## 完了したタスク
- [x] 患者情報管理画面 UI 実装（3コンポーネント）
- [x] 予約 API エンドポイント実装（POST /appointments）
- [x] ユニットテスト追加（カバレッジ +8%）
 
## 進行中のタスク
- [ ] 予約キャンセル API（明日完了予定）
- [ ] メール送信機能（テスト中）
 
## ブロッキングイシュー
なし
 
## 次営業日の予定
- バックエンド実装完了
- 統合テスト開始