Research

Level

Research files live in one of two locations:

Level	Path	When
user	`~/.claude/research/`	Default — general learnings, cross-project
project	`.claude/research/`	Only when user explicitly says "project level"

Default is user level. Use --project flag to override:

# User level (default)
~/.claude/skills/research/research.sh new <topic>

# Project level (only when explicitly requested)
~/.claude/skills/research/research.sh --project new <topic>

Trigger phrases for project level: "project level", "project research", "in this project's research" — anything else defaults to user level.

Write

Manage research files — creation, naming, archival.

CRITICAL

NEVER write directly to the research directory. All research file creation MUST go through this skill to ensure:

Correct naming convention
Compact formatting applied (via markdown skill, operation 3)
Proper integration with existing research

Every write operation (create, import, move) MUST complete the full pipeline:

Script — research.sh handles mechanical parts (move, rename, gh-links)
Claude — YOU handle Claude-only parts (compact formatting via markdown skill)

The script is NOT the complete solution. You are the orchestrator.

Authorship	Operations	Compact formatting
Claude writes	flush, save, create	Apply inline (no preview)
External	import, move	Preview-iterate-apply pass

Skipping compact formatting entirely is a failure.

Operations

Create new file
```
~/.claude/skills/research/research.sh new <topic>
```
Then: write content in compact format directly (invoke markdown skill operation 3 — you're the author)
Import existing file
```
~/.claude/skills/research/research.sh import <file> [topic]
```
Script auto-enriches GH links. Then: invoke markdown skill operation 3 with preview-iterate-apply (external content)

Archive old files

~/.claude/skills/research/research.sh cleanup

List files

~/.claude/skills/research/research.sh list

Enrich GitHub links

~/.claude/skills/research/research.sh format-gh-links <target>
# Targets: current, all, diff, all-including-old, <file>...

File Format

<YYYY-MM-DD>-<HHMM>-<topic>.md

Date/time — UTC
Topic — kebab-case

Notes

All timestamps UTC (date -u)
30-day auto-archive keeps recent files manageable

Subcommands

Prune — remove conversational artifacts, distill knowledge
Format — enrich GH links, apply compact formatting
Flush CC Thread — extract learnings before context loss