analysis-design

/analysis-design — Analysis Design Builder

Guides Claude through creating a lightweight analysis design document using insight-blueprint MCP tools. Follows the hypothesis-driven EDA workflow.

When to Use

• Starting a new exploratory analysis (user wants to formalize a hypothesis)
• Deriving a sub-hypothesis after a parent hypothesis is rejected
• Reviewing or listing existing analysis designs

When NOT to Use

• Browsing the data catalog (future: /data-explorer skill)
• General EDA discussion without intent to persist a design document

Workflow

Step 0: User Confirmation Gate

Before proceeding, confirm with the user:

• Ask: "分析設計を新規作成しますか？"
• If the user declines, exit gracefully with a brief message and do not proceed
• If the user confirms, continue to Step 1

Step 1: Check Current State

Call list_analysis_designs() to understand existing designs:

• Note existing theme IDs (e.g., "FP", "TX")
• Check if a parent_id should be referenced

Step 1.5: Check for Framing Brief

Check the conversation context for a ## Framing Brief from analysis-framing.

Detection rules (all must be satisfied):

1. ## Framing Brief heading exists in conversation
2. ### テーマ subsection exists under Framing Brief
3. ### 推奨方向 subsection exists under Framing Brief
4. theme_id: field exists within the 推奨方向 section
5. If multiple Framing Briefs exist, use the last (most recent) one

If valid Framing Brief found:

Map Brief sections to analysis-design fields as draft values:

Framing Brief セクション	analysis-design フィールド	マッピング
テーマ	title	テーマの1行要約を title の候補として提示
利用可能データ	explanatory, metrics	データソース・カラムから explanatory/metrics の候補を生成
既存分析	parent_id	関連デザイン ID を parent_id の候補として提示
ギャップ	hypothesis_background	ギャップ情報を仮説の背景・動機の下書きに活用
推奨方向.仮説の方向性	title, hypothesis_background	方向性から title 候補を生成し、背景の下書きに活用
推奨方向.theme_id	theme_id	デフォルト値として設定
推奨方向.parent_id	parent_id	デフォルト値として設定
推奨方向.analysis_intent	analysis_intent	デフォルト値として設定
推奨方向.推奨手法	methodology	{method: "推奨手法の値", reason: "Framing Brief の推奨"} としてデフォルト設定