Idea Shortlist Curator

Load Order

Always read:

• references/overview.md

Read by task:

• references/ranking_rubric.md when customizing risk notes or deferral reasons
• assets/rationale_templates.json when changing deterministic shortlist rationale wording or rule order

Script Boundary

Use scripts/run.py only for:

• diversity-aware greedy selection from screened rows
• deterministic ranking record assembly and JSONL/Markdown output

Do not treat run.py as the place for:

• domain-specific risk narratives that should be inspectable from references
• reader-facing prose templates for the final memo (those belong in idea-memo-writer)

Goal: turn a direction pool into a small shortlist that is:

• explicitly ranked with a real why-#1>#2>#3 argument,
• diverse in program shape rather than just cluster labels,
• specific about why deferred directions are not in the lead set,

and remains:

• academically interesting,
• distinct enough to compare,
• grounded enough to discuss,
• and not yet overfrozen into project plans.

Script

Quick Start

• python .codex/skills/idea-shortlist-curator/scripts/run.py --workspace workspaces/<ws>

All Options

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

Examples

• Curate a shortlist for a brainstorm workspace:
  • python .codex/skills/idea-shortlist-curator/scripts/run.py --workspace workspaces/brainstorm-llm-agents