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