Research Notebook
Structured research with sources, findings, and decisions.
Track investigations and capture knowledge.
[!TIP] LEARN stage of play-learn-lift. Where patterns emerge from exploration.
Structure
| Section | Purpose | |---------|---------| | Questions | What you're trying to learn | | Sources | Where you looked | | Findings | What you discovered | | Decisions | What you concluded |
Contents
| File | Purpose | |------|---------| | SKILL.md | Full protocol documentation | | NOTEBOOK.yml.tmpl | Notebook template | | SOURCES.yml.tmpl | Sources template |
Example
research:
topic: "LLM context management strategies"
questions:
- "How do other systems handle token budgets?"
- "What summarization approaches exist?"
sources:
- url: "paper-on-context.pdf"
relevance: "Direct answer to Q1"
findings:
- "Sliding window is most common"
- "Hierarchical summaries preserve more"
decisions:
- "Use tiered hot/cold approach"
The Intertwingularity
Research-notebook is the LEARN stage of play-learn-lift โ find patterns.
graph LR
RN[๐ research-notebook] -->|LEARN stage of| PLL[๐ฎ๐๐ play-learn-lift]
RN -->|distills to| SUM[๐ summarize]
RN -->|sources from| SL[๐ session-log]
RN -->|informs| SS[๐ฏ sister-script]
DB[๐ง debugging] -->|uses| RN
AP[โ๏ธ adventure] -->|evidence in| RN
Dovetails With
Sister Skills
| Skill | Relationship | |-------|--------------| | play-learn-lift/ | Research IS the LEARN stage | | session-log/ | Source material from PLAY | | summarize/ | Compress findings | | sister-script/ | Research feeds automation | | debugging/ | Research supports hypothesis tracking | | adventure/ | Evidence collection | | adversarial-committee/ | Multiple perspectives on research questions | | rubric/ | Criteria for evaluating sources and findings |
Protocol Symbols
| Symbol | Link |
|--------|------|
| PLAY-LEARN-LIFT | PROTOCOLS.yml |
| PRESERVE-JOURNEY | PROTOCOLS.yml |
Navigation
| Direction | Destination | |-----------|-------------| | โฌ๏ธ Up | skills/ | | โฌ๏ธโฌ๏ธ Root | Project Root | | ๐ฎ Sister | play-learn-lift/ | | ๐ Sister | summarize/ |