/meta — CLEAR META Decision Framework
TL;DR: Strategic decision analysis. Get structured recommendation with scored options.
Quick Start
code
/meta <question> # Auto-selects depth /meta --depth=quick <question> # Force quick (~30s) /meta --depth=deep <question> # Force deep analysis /meta --plan "<criteria>" # Exit criteria → task plan
When to Use
| Use for | Skip for |
|---|---|
| Architecture decisions | Trivial choices |
| Technology selection | Information lookup |
| Strategic trade-offs | Already-decided directions |
CLEAR Phases
| Phase | Purpose | Output |
|---|---|---|
| C | Gather context | Situation map |
| L | Tag claims with confidence | L-labeled claims (fact/model/hypothesis/heuristic/belief) |
| E | Define "done when" | Exit criteria |
| A | Generate tactics, score | Recommendation with MetaScore |
| R | Capture learnings | /retro when significant |
Formula: C-L-E (reflection) → A (action) → R (review)
Output Format
markdown
## CLEAR: [Title] **C** — [Context summary] **E** — [Exit criterion] **Key Claims** (L-labeled): - [claim] *(fact)* - [claim] *(hypothesis)* **Options**: | Option | Score | Pros | Cons | |--------|-------|------|------| | A | 78% | ... | ... | | B | 65% | ... | ... | **→ Recommendation: [Option A]** (MetaScore: 78%) ⚡ DO THIS NOW: [immediate action] 📋 CLEAR: C✓ L✓ E✓ A✓ R○ | Next: [action]
Depth Selection
| Signals | Depth |
|---|---|
| Simple, reversible | Quick |
| "compare", "vs", options defined | Comparative |
| "critical", "important", irreversible | Deep |
| Obvious answer | Skip |
Flags
| Flag | Description |
|---|---|
--depth=quick|deep|comparative | Force depth |
--plan | Convert exit criteria to task plan |
--persist | Create Beads issues (with --plan) |
CLEAR Check (Required Exit)
Every invocation ends with:
code
📋 CLEAR: C✓ L✓ E✓ A✓ R○ | Next: [action]
R○ pending is normal — R✓ requires /retro invocation.
State block (for agent continuity):
code
<!-- meta:state
depth: quick
recommendation: "Option A"
clear: {C: done, L: done, E: done, A: done, R: pending}
next: "implement recommendation"
/meta:state -->
References
- •Methodology:
references/methodology.md - •Agent architecture:
references/agents.md(for --depth=deep)