AIネイティブ開発フロー

ClassLabでは、AIを活用した開発フローを採用しています。
Asana / Slack / GitHubとMCP連携し、要件定義から実装・PRまでを効率化します。

AI駆動 MCP連携 Salesforce 自動化 Claude Code Asana統合
3
フェーズ
9
コマンド
8
テンプレート
3
MCP統合
🤖
AIネイティブ開発とは: Claude Codeを活用し、要件定義・設計・実装の各フェーズをスラッシュコマンドで自動化する開発手法です。
✅
前提条件: Asana、Slack、GitHubの各MCPが設定済みであること。CLAUDE.mdと.ai/instructionsが配置済みであること。
⚠️
注意: 各コマンドの実行にはClaude Codeの適切な権限設定が必要です。.claude/settings.jsonを確認してください。
🚨
重要: 設計書は必ずレビュー・承認フローを経てから構築フェーズに進んでください。未承認の設計書での実装は禁止です。
🔄

3つのフェーズ

要件定義 / 設計 / 構築

📋

要件定義

/requirement コマンド

🏗️

設計

/design コマンド

🔨

構築

/build コマンド

🔗

MCP連携

Asana / Slack / GitHub

⌨️

コマンド一覧

全9コマンド

🔄 1. 3つのフェーズ

AIネイティブ開発は、要件定義・設計・構築の3フェーズで構成されます。各フェーズはスラッシュコマンドで起動し、MCPを通じてAsana・Slack・GitHubと連携します。

フェーズ コマンド 概要 出力物
A. 要件定義 /requirement 情報収集 → requirement.md doc_draft/requirement/[依頼名]/requirement.md
B. 設計 /design 設計書群 + タスク分解 doc_draft/basic-design/[依頼名]/
C. 構築 /build 実装 → ルールチェック → PR Apexクラス、LWC、テスト等

開発フロー全体図

Asanaタスク → /requirement
要件定義 → /design
設計 · 干渉チェック · PR · レビュー · /approve-design → /build
実装 · テスト · PR → マージ完了

Step 1: Asanaタスク起点

Asanaで作成された依頼タスクをURLまたはタスク名で指定して開発を開始します。

Step 2: 要件定義フェーズ

/requirementコマンドでAsana・Slack・GitHubからの情報を自動収集し、requirement.mdを生成します。

Step 3: 設計フェーズ

/designコマンドで設計書群を作成。干渉チェック後、PRを作成してレビューを受けます。

Step 4: 設計承認

/approve-designで設計書をdoc_draftからdocへ移動。正式な設計書として確定します。

Step 5: 構築フェーズ

/buildコマンドで実装を実行。コーディングルールチェックを通過後、PRを作成します。

📋 2. フェーズ A: 要件定義

コマンド
/requirement [Asanaタスク名またはURL]

処理フロー

フェーズ A: 要件定義フロー
1 初期確認 - Asanaタスクの内容を確認
↓
2 並列情報取得（Asana / Slack / GitHub MCP）
↓
3 requirement.md 生成
↓
4 確認ループ - 担当者と内容を確認・修正

出力先

出力パス
doc_draft/requirement/[Asana依頼名]/requirement.md

🏗️ 3. フェーズ B: 設計

コマンド
/design [Asana依頼名]

処理フロー

フェーズ B: 設計フロー
1 設計書作成 - テンプレートベースで各種設計書を生成
↓
2 干渉チェック - 入力規則・トリガー・フローとの競合確認
↓
3 タスク分解 - 実装タスクを細分化して工数入力
↓
4 PR作成 → Slack通知 → レビュー
↓
5 /approve-design で設計承認・正式化

出力ディレクトリ構造

doc_draft/
  basic-design/[依頼名]/
    readme.md ... 概要設計
    feature/
      01_[機能名].md ... 機能設計
    task-breakdown.md ... タスク分解
  detailed-design/
    apex/
      [クラス名].md
    trigger/
      [トリガー名].md
    lwc/
      [コンポーネント名].md
    flow/
      [フロー名].md

干渉チェック

チェック対象 確認内容
入力規則 新処理のDMLが既存入力規則に引っかからないか
トリガー 同一項目をBefore Triggerで上書きしないか
フロー Before Save Flowとの競合がないか
干渉チェックの詳細

干渉チェック（/impact-check）は、新しい実装が既存のSalesforce設定・コードと競合しないかを自動で検証します。

  • 入力規則チェック: DML操作対象のオブジェクトに設定されている入力規則を取得し、新処理のデータが規則に抵触しないか検証
  • トリガーチェック: 同一オブジェクトのBefore Triggerで同じ項目を更新していないか検証
  • フローチェック: Before Save Flowが同一オブジェクト・同一項目に対して動作していないか検証

🔨 4. フェーズ C: 構築

コマンド
/build [Asana依頼名]

処理フロー

フェーズ C: 構築フロー
1 タスク分解読み込み - task-breakdown.md を解析
↓
2 Asanaサブタスク作成 - 各実装タスクをサブタスク化
↓
3 ai-agent実行 - 設計書に基づいてコード自動生成
↓
4 ルールチェック - コーディング規約への準拠を検証
↓
5 PR作成 → レビュー → マージ

コーディングルールチェック

カテゴリ チェック内容
命名規則 PascalCase（クラス名）、camelCase（メソッド・変数名）
ドキュメンテーション Javadoc、@description、@param、@return
セキュリティ SOQLインジェクション、XSS、with sharing、CRUD/FLS
コーディングルール例 (Apex)
/**
 * @description 取引先に関連する処理を行うサービスクラス
 */
public with sharing class AccountService {

    /**
     * @description 取引先名で検索する
     * @param searchName 検索する取引先名
     * @return 一致する取引先のリスト
     */
    public static List<Account> findByName(String searchName) {
        // SOQLインジェクション対策: バインド変数を使用
        return [
            SELECT Id, Name, Industry
            FROM Account
            WHERE Name = :searchName
            WITH SECURITY_ENFORCED
        ];
    }
}
ルールチェックの実行方法

/lint-rulesコマンドで個別にルールチェックを実行することも可能です。

コマンド
/lint-rules

チェック対象:

  • .ai/rules/ 配下のルール定義ファイル
  • .ai/instructions/code-generation.md のコード生成規約

🔗 5. MCP連携

各フェーズでAsana・Slack・GitHub MCPを活用し、情報の自動収集と連携を行います。

MCP /requirement /design /build
Asana ✓ ✓ ✓
Slack ✓ ✓ ✓
GitHub ✓ ✓ ✓
Asana MCP
タスク情報取得 / サブタスク作成 / ステータス更新 / 工数記録
↓ 情報連携
Claude Code (AIエージェント)
入力: Asanaタスク + Slackスレッド + GitHub既存コード
処理: 要件定義 / 設計書生成 / コード実装 / ルールチェック
出力: requirement.md / 設計書群 / Apex・LWC / PR
↓ 成果物出力
Slack MCP
スレッド情報取得 / 通知送信
GitHub MCP
コード参照 / PR作成 / Issue管理

📄 6. 設計書テンプレート

設計書は標準テンプレートに基づいて自動生成されます。テンプレートは .ai/templates/ ディレクトリに配置されています。

テンプレート 用途
domain_overview.template.md ドメイン概要設計
feature.template.md 機能設計
apex_class.template.md Apexクラス詳細設計
apex_trigger.template.md トリガー詳細設計
apex_batch.template.md バッチ詳細設計
lwc.template.md LWC詳細設計
flow.template.md フロー詳細設計
visualforce.template.md VisualForce詳細設計
テンプレートの使い方

テンプレートは/designコマンド実行時に自動的に適用されます。手動で使用する場合は、対応するテンプレートファイルをコピーして内容を記入してください。

テンプレート配置場所
.ai/templates/
  domain_overview.template.md
  feature.template.md
  apex_class.template.md
  apex_trigger.template.md
  apex_batch.template.md
  lwc.template.md
  flow.template.md
  visualforce.template.md

📝 7. 設計書の更新履歴管理

各設計書には改訂履歴セクションを必ず含めます。変更の追跡性を確保し、レビュー時の差分確認を容易にします。

改訂履歴セクション例
## 改訂履歴
| 版数 | 日付 | 変更者 | 変更内容 |
|------|------|--------|----------|
| 1.0  | 2026-02-10 | 担当者名 | 初版作成 |
| 1.1  | 2026-02-12 | 担当者名 | レビュー指摘反映 |

✅ 8. 設計書承認フロー

/approve-designコマンドにより、設計書をドラフト（doc_draft）から正式版（doc）へ移動します。

移動元（doc_draft/） 移動先（doc/）
basic-design/[依頼名]/ → domains/[依頼名]/
detailed-design/apex/ → detailed-design/apex/
detailed-design/trigger/ → detailed-design/trigger/
detailed-design/lwc/ → detailed-design/lwc/
detailed-design/flow/ → detailed-design/flow/
承認フロー
1 設計書PR作成（doc_draft/ 配下）
↓
2 レビュー & 修正
↓
3 PRマージ
↓
4 /approve-design で doc/ へ移動・正式化

⌨️ 9. Claude Codeのスラッシュコマンド一覧

コマンド 用途
/requirement 要件定義書の生成
/design 設計書群の生成
/build 実装の実行
/approve-design 設計書の承認
/impact-check 干渉チェック
/lint-rules コーディングルールチェック
/investigate Salesforce仕様調査
/release-note リリースノート作成
/task-estimate 工数集計
コマンドの使い分けガイド

メインの開発フロー（/requirement → /design → /build）に加えて、補助コマンドを適宜活用してください。

  • /impact-check: 設計フェーズで自動実行されますが、個別に実行して確認することも可能
  • /lint-rules: 構築フェーズで自動実行されますが、個別チェックにも対応
  • /investigate: 不明なSalesforce仕様を調査したい場合に使用
  • /release-note: デプロイ前にリリースノートを自動生成
  • /task-estimate: タスク分解後の工数を集計・レポート

📁 10. 関連ファイル

パス 内容
.ai/instructions/main.md プロジェクト全体の指示書
.ai/instructions/code-generation.md コード生成規約
.ai/templates/ 設計書テンプレート群
.ai/rules/ コーディングルール
CLAUDE.md Claude Code設定
doc/manual/DEVELOPMENT-GUIDE.md 開発ガイド