Brief preflight
Turns a small structured request into one consistent editorial handoff before drafting starts.
Day 053 / n8n / Workflow Automation
Content Brief Generator
/ Overview
A dependency-free Python CLI that turns a bounded local JSON request into a deterministic Markdown or JSON content brief.
Small content workflows often begin with scattered notes, making the intended audience, single takeaway, evidence boundary and approval requirements easy to lose. A compact preflight tool needs to create a consistent handoff without writing the final copy or inventing claims.
/ Provided servicesClear thinking.
Clear thinking.
Practical delivery.
Deterministic structure
Organizes the same supplied facts into objective, problem, takeaway, sections, evidence and requirements.
Editorial guardrails
Keeps evidence limits, privacy checks and final human review visible without claiming the brief proves accuracy.
/ Solution
Content Brief Generator validates one bounded local JSON request and converts it into deterministic Markdown or structured JSON. It supports a small allowlist of goals and channels, normalizes whitespace, rejects undeclared fields and duplicate keys, and limits text and list sizes. The resulting brief records the objective, problem, one takeaway, section purposes, supplied evidence, inclusion and exclusion requirements, optional call to action, and three editorial checks. It does not research, generate final content, call an AI service or publish anything.
/ Impact
Markdown and structured JSON output
Six supported content channels
Five supported editorial goals
Single-takeaway structure
Evidence and requirement lists
Privacy and human-review checks
Bounded text, lists and file size
Eleven standard-library tests
Python standard library
Argparse, JSON, pathlib and regular expressions provide a dependency-free offline command-line tool.
Bounded input model
Allowlisted fields, goals and channels plus strict length and list limits keep requests small and predictable.
Unittest
Eleven tests cover normalization, optional sections, validation errors, duplicate keys and serializable output.