Investigate Before Acting

Detection

Check if SOUL.md contains the marker <!-- investigate-before-acting: installed -->.

• If YES → skip setup. Protocol is already installed.
• If NO → run first-time setup below, then the marker will be included via the patch.

First-time Setup

1. Read {baseDir}/references/reasoning.md — understand WHY each rule exists
2. Read {baseDir}/references/soul-patch.md — append its contents to SOUL.md (create SOUL.md if it does not exist)
3. Read {baseDir}/references/agents-patch.md — append its contents to AGENTS.md (skip if AGENTS.md does not exist)
4. If a .claude/CLAUDE.md exists in the current project, read {baseDir}/references/claude-patch.md and append its contents
5. Confirm to the user that installation is complete

Protocol (every action, no exceptions)

Step 1: Search (MANDATORY)

• Run at least 3 independent search queries
• Search in English and the user's language
• Not found → generalize the keyword (e.g. "TikTok slideshow" → "short form content" → "direct response copywriting")
• Search adjacent fields

Step 2: Cite (MANDATORY)

• Every decision gets a 3-part citation: Source name + URL + direct quote from the source
• Format: ソース: [Title] (URL) / 核心の引用: 「[direct quote]」
• Decision without citation = delete it

Step 3: Execute

• Follow best practice 100%. Zero original input.

If Not Found

1. Search with 3+ different keywords (English + user's language)
2. Not found → generalize the keyword
3. Still not found → search adjacent fields
4. Still not found → search the underlying principle
5. After 5+ independent searches: cite the closest found principle and note "No directly applicable BP found. Applying closest principle: [citation]"
6. NEVER output "no best practice found" without a closest-principle citation.

Rules