idea-memo-writer

Synthesize the shortlist into a discussion-ready research idea brainstorm memo, writing `output/REPORT.md`, `output/APPENDIX.md`, and `output/REPORT.json`. **Trigger**: idea memo, brainstorm memo, research direction memo, report md, 研究备忘录, brainstorm report. **Use when**: the shortlist exists and you want the final reader-facing brainstorm deliverable for PI / PhD discussion. **Skip if**: you only need an internal shortlist and do not want a final memo. **Network**: none. **Guardrail**: do not invent papers; all final directions must remain anchored to the shortlist and core set.

Stars 377

Forks 25

Install this agent skill to your Project

npx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/idea-memo-writer

SKILL.md

Idea Memo Writer

Goal: turn the shortlist into a discussion-ready memo.

Load Order

Always read:

references/overview.md
references/report_structure.md

Script Boundary

Use scripts/run.py only for:

deterministic assembly of the report from trace artifacts
calling tooling/ideation.py library functions for rendering

Do not treat run.py as the place for:

ideation heuristics or scoring logic
hardcoded report prose templates

The final memo should feel like:

an advisor-ready discussion memo rather than workflow notes,
paper-specific in its evidence hooks and appendix reading guide,
explicit about rank logic and quick kill criteria,

and still feel like:

a strong brainstorming artifact,
grounded in the literature,
rich enough for PI/PhD discussion,
but not frozen into a rigid project execution spec.

Script

Quick Start

python .codex/skills/idea-memo-writer/scripts/run.py --workspace workspaces/<ws>

All Options

--workspace <dir> (required)
--unit-id <U###>
--inputs <semicolon-separated>
--outputs <semicolon-separated>
--checkpoint <C#>

Examples

Assemble the brainstorm memo for a workspace:
- python .codex/skills/idea-memo-writer/scripts/run.py --workspace workspaces/brainstorm-llm-agents