Planning artifacts

exec-brief-cli shows the planning-artifact pattern in writing form: rough notes become one stable brief that can travel upward cleanly.

This guide exists because a lot of strategy or product writing fails on shape before it fails on ideas. The repo stays close to one repeated problem: turning raw notes into a short leadership brief without dragging in a whole writing system.

Why this repo carries the track

A short site-side guide before the proof layer on GitHub.

What it proves

A small writing utility can matter when it imposes one durable section shape on messy material and makes the next handoff easier.

Why it matters in this track

It belongs in the planning-artifact track because the artifact is the one-page brief itself: concise enough to travel, stable enough to review, and narrow enough to rerun.

What survives the first run

The generated brief is the artifact. It turns scattered notes into a leadership-ready shape without asking the user to rebuild the structure manually.

What the first useful success looks like

exec-brief-cli as a first useful success, not only a demo.

The first useful run is a one-page brief that already has the thesis, key points, risks, and ask in the right order. That lets the next review focus on the argument instead of the shape.

Use this when rough notes should become a short leadership brief, a product-direction one-pager, or a cleaner internal narrative before the material spreads into slides and comment threads.

Quick run

python3 brief_builder.py sample_brief.json

Sample output shape

# Why We Should Simplify Serverless Onboarding

**Audience:** Product and field leadership

## Thesis
Developer adoption is being slowed more by setup friction than by missing advanced capabilities.

## Key Points
- The clearest recurring customer ask is a simpler code-first packaging path.

Where it routes next

Turns rough notes into a one-page leadership brief with a stable section shape.