research-harness-plan

Generate an executable analysis_plan.md from study_spec.md, audit reports, and cleaned data.

39|46|Updated May 29, 2026
One-click install
npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill research-harness-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-harness-plan
Source: https://github.com/maxwell2732/claudecode-research-harness-workflow/tree/main/skills/research-harness-plan
Command: npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill research-harness-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates an executable empirical analysis plan from the approved study specification, audit findings, and the cleaned data structure, producing analysis_plan.md to guide subsequent analysis steps.

Core Features & Use Cases

  • Automated plan synthesis: From study_spec.md, data_audit_report.md, and data_cleaning_report.md to a concrete, task-level plan.
  • Feasibility and data checks: Validates which study variables exist in the cleaned data and flags missing ones as unknown to avoid impossible tasks.
  • Defined outputs and DoD: Produces a complete analysis_plan.md containing tasks, scripts, logs, and outputs, with clear definition of done.
  • Use Case: A researcher runs the plan generator after data cleaning to obtain a ready-to-execute plan for descriptive stats, main models, robustness checks, and figures.

Quick Start

Run /research-harness-plan to generate a fresh analysis plan from study_spec.md and reports.

Frequently Asked Questions about research-harness-plan

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

FAQPage Schema
How do I generate an executable analysis plan from a study specification?

To generate an executable analysis plan from a study specification, you need to synthesize study_spec.md, data_audit_report.md, and data_cleaning_report.md into a concrete, task-level analysis_plan.md with defined inputs, outputs, and definition of done.

What is a reproducible research workflow plan and why do I need it before running analysis scripts?

A reproducible research workflow plan ensures traceable, audit-ready task definitions before analysis scripts run. It validates study variables against cleaned data, flags missing variables as unknown, and prevents impossible analysis tasks.

How do I validate which study variables exist in cleaned data before running empirical models?

Validating which study variables exist in cleaned data requires feasibility and data checks that cross-reference the approved study specification with the data cleaning report, automatically flagging any missing variables as unknown to avoid impossible tasks.

Can I use an automated plan synthesis tool for robustness checks and descriptive statistics?

Yes, automated plan synthesis can produce a ready-to-execute analysis plan covering descriptive statistics, main models, robustness checks, and figures by mapping approved study specifications and audit findings to concrete task-level scripts and outputs.

What is the best way to define the definition of done for empirical analysis tasks?

Defining the definition of done for empirical analysis tasks involves generating an analysis_plan.md that specifies complete task lists, required scripts, expected logs, defined outputs, and pre-flight checks for each analysis stage.

What happens if my approved study specification includes variables missing from the cleaned data structure?

If the approved study specification includes variables missing from the cleaned data structure, the plan generator flags those missing variables as unknown during feasibility checks to prevent generating impossible analysis tasks.