idea-brieflisted
Install: claude install-skill WILLOSCAR/research-units-pipeline-skills
# Idea Brief
Turn a fuzzy ideation request into an auditable brainstorm contract for the later ideation stack.
This skill does **not** retrieve papers.
It only locks topic, audience, constraints, exclusions, rubric, query buckets, and target artifact shape into:
- `output/trace/IDEA_BRIEF.md`
- `queries.md`
- `DECISIONS.md`
## Inputs
- `GOAL.md`
- `DECISIONS.md`
- `queries.md`
## Outputs
- `output/trace/IDEA_BRIEF.md`
- `queries.md`
- `DECISIONS.md`
## Execution notes
This skill starts from `GOAL.md`, then refines the topic/constraints into `output/trace/IDEA_BRIEF.md`, updates `queries.md`, and records blockers or approvals in `DECISIONS.md`.
Read `references/overview.md` before changing the package shape or the brief contract.
`assets/brief_contract.json` is the machine-readable source for:
- required brief sections
- goal / audience framing
- rubric rows
- query bucket templates
- default exclusions
- focus placeholder
- shared table/open-question text
- decisions bootstrap text
## Script
### Quick Start
- `uv run python .codex/skills/idea-brief/scripts/run.py --workspace <workspace>`
### All Options
- `--workspace <dir>`
- `--unit-id <id>`
- `--inputs <a;b;...>`
- `--outputs <a;b;...>`
- `--checkpoint <C*>`
### Examples
- `uv run python .codex/skills/idea-brief/scripts/run.py --workspace <workspace>`