Idea Brief

---
name: idea-brief
description: |
  Lock an ideation run into a single-source-of-truth brainstorm brief (`output/trace/IDEA_BRIEF.md`) and a replayable multi-query plan (`queries.md`).
  **Trigger**: idea brief, ideation brief, research ideas, brainstorm, 找 idea, 选题, 点子, 找方向.
  **Use when**: the user wants research ideas and their input is long / multi-turn; you need to clarify topic + constraints before retrieval.
  **Skip if**: the goal is to write a survey draft directly (use `arxiv-survey*` pipelines instead).
  **Network**: none.
  **Guardrail**: do not invent papers/citations; do not start retrieval here; keep the brief structured (no long prose).
---

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