research-notebook
Structured research with sources, findings, and decisions.
When & Why to Use This Skill
The Research Notebook skill provides a structured framework for conducting deep investigations and managing institutional knowledge. It enables users to transform raw information into actionable insights by systematically tracking research questions, verifying sources, documenting findings, and recording final decisions. This skill is essential for maintaining a transparent 'paper trail' of logic, reducing hallucinations in AI workflows, and ensuring that all conclusions are backed by verifiable evidence.
Use Cases
- Technical Feasibility Studies: Evaluating new software libraries or architectural patterns by documenting requirements, comparing sources, and recording the final selection logic.
- Complex Debugging and Troubleshooting: Tracking hypotheses and evidence gathered from logs or documentation to reach a definitive and documented resolution for system issues.
- Market and Competitive Analysis: Organizing data points from various industry reports and web sources to synthesize market trends and support strategic business decisions.
- Academic and Literature Review: Managing a collection of papers and articles to extract key findings and maintain a structured bibliography for research projects.
- Product Discovery: Documenting user interview insights and feature experiments to inform product roadmap decisions with a clear history of 'why' certain paths were chosen.
| name | research-notebook |
|---|---|
| description | "Structured research with sources, findings, and decisions." |
| license | MIT |
| tier | 1 |
| related | [play-learn-lift, summarize, memory-palace, debugging, scratchpad, session-log, sister-script] |
| tags | [moollm, research, investigation, sources, findings] |
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/ |