Idea writing

This skill provides guidance for brainstorming, exploring, refining, and documenting ideas. It includes progressively-disclosed references on idea document structure, exploration patterns, expansion techniques, critique methods, and synthesis approaches for effective ideation.

About idea documents

Idea documents capture concepts at various stages of development, from initial seeds to crystallized insights. They follow a structured lifecycle (seed, exploring, refining, crystallized, archived) that supports iterative development and connection discovery between related ideas.

Storage location: All ideas are stored in .oaps/docs/ideas/ (hidden directory at project root).

ID format: YYYYMMDD-HHmmss-slug (e.g., 20251218-164449-worktree-management)

Critical: Always use CLI commands

NEVER search for idea files manually using Glob, Grep, or find. ALWAYS use these CLI commands:

Steps

MANDATORY STEPS FOR ALL IDEA WRITING TASKS

1. Gather context - Run oaps skill orient idea-writing to see available references and workflows

2. Identify relevant references - Review the references table from step 1 and select those matching your task

3. Load dynamic context and references - Run oaps skill context idea-writing --references <names...>

4. Review loaded references and commands - Read through the guidance. The Allowed commands table at the end of the output is authoritative for what commands can be run.

5. Follow the workflow - Adhere to the selected workflow's steps for capturing, exploring, refining, or crystallizing ideas.