/gaia-editorial-structure

user-facing
Category:
Documentation & Editorial
Lifecycle phase:
Any
Arguments:
[target-doc-path]

What it does

/gaia-editorial-structure performs a structural review on a document, evaluating information architecture, section ordering, balance, redundancy, depth, and navigation. It proposes specific reorganization moves (cuts, merges, splits, reorders) with a priority ranking so you can apply the highest-impact changes first.

When to use it

  • A document feels disorganized and you want concrete restructuring recommendations.
  • You want to verify that a document has all expected sections for its type (PRD, architecture, story).

Prerequisites

  • A target document must exist. If not provided, the command asks.

How to invoke

/gaia-editorial-structure .gaia/artifacts/planning-artifacts/architecture.md

What it does step by step

  1. Load document Reads the target and maps every heading with line numbers and section lengths.
  2. Analyze structure Evaluates information architecture, ordering, balance, redundancy, missing sections, nesting depth, and navigation.
  3. Generate report Produces a report with the current structure, proposed structure, numbered moves, and priority ranking.

Inputs

InputSourceDescription
target-doc-pathCommand argumentPath to the document to review.

Outputs

OutputLocationDescription
Structure reportConsole output (display-only by default)Current vs. proposed structure, recommended moves, and priority ranking.

Example session

> /gaia-editorial-structure .gaia/artifacts/planning-artifacts/architecture.md

## Current Structure
  ## System Overview (48 lines)
  ## Components (312 lines)
  ## Data Architecture (67 lines)

## Recommended Moves
1. [split] Split S2 Components (312 lines) into S2 Backend Components and S3 Frontend Components -- 312-line section is disproportionately long.
2. [add] Add a Risks and Mitigations section -- expected for architecture documents.

## Priority
1. Split Components (highest reader-comprehension uplift)
2. Add Risks section

What to run next

  • Apply the recommended moves manually and re-run to verify improvement.
  • For prose quality, run /gaia-editorial-prose.

Troubleshooting

Doc-type unknown

If the document type cannot be inferred, the missing-sections check is skipped. All other structural checks still run.