research-plan

Writes and revises research-project PLAN.md documents with decision logs, novelty gates, and execution orders.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/mnazaal/dotfiles --skill research-plan-mnazaal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-plan
Source: https://github.com/mnazaal/dotfiles/tree/main/.agents/skills/research-plan
Command: npx skills add https://github.com/mnazaal/dotfiles --skill research-plan-mnazaal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research projects lose decisions, rationale, and execution order between sessions, forcing later work to reconstruct why choices were made or which plan is still live. This Skill produces a single PLAN.md that records decisions with rationale, pins dependency APIs, gates novelty claims, and stays unambiguous across pivots. ## Core Features & Use Cases - Structured plan authoring: Enforces a fixed section shape from framing through decision log, with pinned API surfaces, baselines, and a step-0 novelty literature-search gate. - Revision gate: Detects competing forward-looking plan sections by status marker rather than headings, ensuring exactly one live execution order survives any pivot. - Append-only decision log: Records hard-to-reverse decisions with rejected alternatives, parked/superseded statuses, and revisit conditions. - Use Case: After choosing a research direction, draft a PLAN.md that a future session can execute cold, then revise it in place when an experiment kills a branch, moving the dead branch's verdict to LOG.md. ## Quick Start Write a PLAN.md for my research project covering framing, decisions, pinned dependencies, experiments, execution order, and risks, starting with the step-0 novelty literature-search gate.

Frequently Asked Questions about research-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a research project plan that survives across sessions?▼

Structure the plan as framing, decisions with rationale, pinned API surfaces, baselines and experiments, execution order, risks, and an append-only decision log. Record each hard-to-reverse decision with rejected alternatives so a later session can start cold from the document.

How do I revise a research plan after a pivot without creating duplicates?▼

Rewrite the affected single-valued sections in place and append one decision-log entry describing what changed and why. Never append a second dated copy of the plan; scan for unmarked forward-looking sections and ensure exactly one live execution order remains.

What is a novelty literature-search gate in a research plan?▼

It is a mandatory step-0 literature search that verifies the claimed novelty before building the method. Until it runs, novelty is marked UNVERIFIED under risks, and pivot options are listed in case the gate fails.

When should I not use a research plan document?▼

Do not write the plan while the pursue/park/kill direction is still open or decisions remain unresolved. Route direction questions to a research-session process and unresolved decisions to a plan-interview step first.

How should a decision log entry handle parked or superseded decisions?▼

A parked entry needs a Revisit-when line naming an observable condition that would reopen it, such as a result landing or a baseline being beaten. Superseding edits the old entry's status and appends a new entry without rewriting the original rationale.