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