---
name: willoscar/idea-brief
source: https://app.decimal.ai/s/willoscar-idea-brief@1/SKILL.md
source_sha256: ab8a4e0bd465
---

# 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>`