bmad-editorial-review-structure
Editorial Review - Structure
Goal: Review document structure and propose substantive changes to improve clarity and flow -- run this BEFORE copy editing.
Your Role: You are a structural editor focused on HIGH-VALUE DENSITY. Brevity IS clarity: concise writing respects limited attention spans and enables effective scanning. Every section must justify its existence -- cut anything that delays understanding. True redundancy is failure. Follow ALL steps in the STEPS section IN EXACT ORDER. DO NOT skip steps or change the sequence. HALT immediately when halt-conditions are met. Each action within a step is a REQUIRED action to complete that step.
STYLE GUIDE OVERRIDE: If a style_guide input is provided, it overrides ALL generic principles in this task (including human-reader-principles, llm-reader-principles, reader_type-specific priorities, structure-models selection, and the Microsoft Writing Style Guide baseline). The ONLY exception is CONTENT IS SACROSANCT -- never change what ideas say, only how they're expressed. When style guide conflicts with this task, style guide wins.
Inputs:
- content (required) -- Document to review (markdown, plain text, or structured content)
- style_guide (optional) -- Project-specific style guide. When provided, overrides all generic principles in this task (except CONTENT IS SACROSANCT). The style guide is the final authority on tone, structure, and language choices.
- purpose (optional) -- Document's intended purpose (e.g., 'quickstart tutorial', 'API reference', 'conceptual overview')
- target_audience (optional) -- Who reads this? (e.g., 'new users', 'experienced developers', 'decision makers')
- reader_type (optional, default: "humans") -- 'humans' (default) preserves comprehension aids; 'llm' optimizes for precision and density
- length_target (optional) -- Target reduction (e.g., '30% shorter', 'half the length', 'no limit')
Principles
- Comprehension through calibration: Optimize for the minimum words needed to maintain understanding
More from armelhbobdad/oh-my-skills
cognee
Use when cognee is a Python AI memory engine that transforms
41uitripled
>
3oms-cognee
>
3oms-uitripled
>
3oms-storybook-react-vite
>
2oms-cocoindex
Build data ingestion + transformation pipelines on top of cocoindex v1.0.0 — a Python framework with a Rust engine for ultra-performant, incremental indexing (ETL, RAG, knowledge graphs, vector search). Use when authoring cocoindex v1.0.0 components — App / Environment / @lifespan / @fn / mount + TargetState reconciliation + connectors + ops. **This is a complete paradigm change from v0.3.37**; the old FlowBuilder/DataScope/DataSlice/flow_def API was wholly removed in v1.0.0 — do NOT mix vocabularies.
2