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

• python .codex/skills/idea-brief/scripts/run.py --workspace <workspace_dir>

All Options

• --workspace <dir>
• --unit-id <id>
• --inputs <a;b;...>
• --outputs <a;b;...>
• --checkpoint <C*>

Examples

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