# Investigation

> Deep-dive investigation with documentation output. Use when this capability is needed.

- Skill: `tomevault-io/investigation` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/investigation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/investigation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/investigation

---


# Investigation

Conducts deep-dive investigations on specific topics and produces detailed documentation.

## Requirements

- Active session must exist (session path in working memory)
- If no active session: **STOP and ask user** for session path

## Execution

**Session path:** [SESSION_PATH from working memory]
**Topic:** $ARGUMENTS

### Steps

1. **Investigate thoroughly:**
   - Check project docs folder for related documents (if exists)
   - Explore the codebase to understand the topic
   - Identify key files, patterns, dependencies
   - Note potential issues or concerns

2. **Create documentation:**
   - File: `[SESSION_PATH]/[TIMESTAMP_FILE]-dive-[topic-slug].md`

   Structure:
   ```markdown
   # Deep Dive: [topic]
   Date: [TIMESTAMP_LOG]

   ## Summary
   [Brief overview of findings]

   ## Key Findings
   [Bullet points]

   ## Code Structure
   [Relevant files with brief explanations]

   ## Dependencies & Relationships
   [How components interact]

   ## Considerations
   [Issues, edge cases, concerns]

   ## Recommendations
   [Suggested next steps]
   ```

3. **Update session:**
   - Edit `[SESSION_PATH]/_overview.md`:
     - Add to Flow Log: `- [TIMESTAMP_ITERATION] Deep dive: [topic] -> [filename].md`
     - Add to Files: `- [filename].md - Deep dive: [topic]`
   - Commit (if git repo): `cd [SESSION_DIR] && git add . && git commit -m "Deep dive: [topic]"`

4. **Report back:** Provide concise summary of key findings with filename

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/yuvasee) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->