claude code for research

CLAUDE.md

Research Repository

Purpose

This repository is for research purposes only. No code should be added here.

Structure

Each research topic should have its own directory at the root level.

Required Subdirectory Structure

Every topic folder MUST contain a ./cl subdirectory with the following files:

IMPORTANT: Before starting new research, check if plan_*.md files already exist in the ./cl directory. If they do, review them to determine if they're relevant to the current request. You may be continuing existing research rather than starting from scratch.

File Naming Convention

All plan files must include the Claude session ID in their filename:

• plan_SESSION_ID.md
• plan_progress_SESSION_ID.md
• plan_context_SESSION_ID.md

This allows multiple research sessions to coexist and be tracked independently.

./cl/plan_SESSION_ID.md

• Full plan of how to conduct the research
• Detailed methodology for gathering information
• Outline of what files will be created with the research findings
• Clear objectives and deliverables

./cl/plan_progress_SESSION_ID.md

• Live tracking document - update this as research progresses
• Mark completed items and current status
• Commit and push regularly as progress is made
• Shows what's done, what's in progress, and what's remaining

./cl/plan_context_SESSION_ID.md

• Critical context for resuming work
• Document blockers and obstacles encountered
• Note surprising findings or unexpected discoveries
• List unanswered questions that need further investigation
• Capture important context needed for an LLM to continue the research seamlessly
• Record problems and their resolutions

Workflow

1. Create a new directory for each research topic (or navigate to an existing one)
2. Check the ./cl directory for existing plan_*.md files - if they exist, review them to see if the current request is related to ongoing research
3. Set up the ./cl folder structure with all three required files using the session ID naming convention
4. Plan your research in plan_SESSION_ID.md
5. Execute the research, updating plan_progress_SESSION_ID.md frequently
6. Keep plan_context_SESSION_ID.md current with relevant context and issues
7. Commit and push changes regularly throughout the research process

Important Notes

• Keep research organized and well-documented
• Regular commits help track progress and enable easy resumption of work
• The ./cl folder provides structure for AI assistants to understand and continue research effectively