workflow-feature

機能開発ワークフロー

設計からデプロイまで、新機能を開発するための完全なワークフローです。

フェーズ

1. アーキテクチャ設計

定義する項目：

• コンポーネント構成
• データモデル
• API コントラクト
• 統合ポイント
• 依存関係

成果物： アーキテクチャ図、コンポーネント一覧、API 仕様

エージェント： 複雑な機能には architect-review

2. 実装計画

以下に細分化します：

• 個別のタスク（各 2 時間未満）
• タスク間の依存関係
• 並行して進める作業の流れ

成果物： 見積もり付きのタスクリスト

3. 実装

ガイドライン：

• コードと並行してテストを作成します（TDD は任意ですが役立ちます）
• こまめにコミットします（アトミックなコミット）
• コードベースの既存パターンに従います
• 作業しながらドキュメントを整備します

並行して進める作業の流れ：

• コア機能の実装
• テスト
• ドキュメント

4. コードレビュー

チェックリスト：

• コードがプロジェクトの規約に従っている
• 明らかなバグや見落とされたエッジケースがない
• パフォーマンスに問題がない
• エラー処理が網羅されている
• テストが有意義である（カバレッジを満たすだけではない）

エージェント： code-reviewer

5. セキュリティレビュー

確認項目：

• 入力の検証
• 新しいエンドポイントの認証／認可
• 機密データの取り扱い
• コードにシークレットが含まれていないこと

エージェント： 認証関連の場合は security-auditor

6. テスト

必須項目：

• 単体テスト（新規コードのカバレッジ 80% 以上）
• API エンドポイントの統合テスト
• 重要な処理経路の E2E テスト

エージェント： test-automator または debugger

7. パフォーマンスチェック

確認項目：

• 応答時間が許容範囲内である
• メモリーリークがない
• バンドルサイズへの影響（フロントエンド）

エージェント： パフォーマンスが重要な場合は performance-engineer

8. ドキュメント

更新する項目：

• API ドキュメント（OpenAPI/Swagger）
• ユーザーガイド（ユーザー向けの場合）
• 変更履歴の項目
• 必要に応じて README

9. デプロイ準備

チェックリスト：

• バージョンを更新済み
• 変更履歴を更新済み
• マイグレーションスクリプト（DB の変更がある場合）
• ロールバック計画を文書化済み
• フィーチャーフラグ（段階的にロールアウトする場合）

成功基準

• すべてのテストに合格している
• セキュリティレビューに問題がない
• パフォーマンスが制限内である
• ドキュメントが完成している
• コードのレビューと承認が完了している

レビューゲート

# Run before marking complete
cortex review -c feature

クイックスタートテンプレート

## Feature: [Name]

### Requirements
- [ ] Requirement 1
- [ ] Requirement 2

### Tasks
- [ ] Task 1
- [ ] Task 2
- [ ] Tests
- [ ] Docs

### API Changes
- `POST /api/v1/resource` - Create resource
- `GET /api/v1/resource/:id` - Get resource

### Rollback Plan
1. Revert commit
2. Run down migration
3. Clear cache