Use this skill before authoring report files. Choose the closest template in reports/_template-* and then adjust only the section count, graph density, synthesis depth, and block mix needed for the topic.

Plan in this order:

Name the reader outcome and template in report.config.ts.
Draft sections with stable kebab-case ids and a recommended path.
Write orientation fields that route readers into Guided, Reference, Graph, and Synthesis when those modes have useful content.
Define a small KG scope: entities readers must understand, not every noun.
Define synthesis only for cross-section patterns, contrasts, takeaways, and open questions.

Source of truth:

Report shape: packages/engine/src/schemas/report-config.ts
Orientation: packages/engine/src/schemas/orientation.ts
Sections and blocks: packages/engine/src/schemas/section.ts, packages/engine/src/schemas/block.ts
UI examples: packages/storybook/stories/views/OrientationView.stories.tsx, packages/storybook/stories/views/GuidedView.stories.tsx

Más de este repositorio

mismo repositorio

component-library-usage

amhuppert/trellis

Which Trellis components and structured blocks to use, with Storybook paths and anti-patterns

2026-05-260

entity-modeling

amhuppert/trellis

Entity selection, aliases, primary sections, relationship types, and edge strength

2026-05-260

research-and-analysis

amhuppert/trellis

Source gathering, code tracing, fact versus inference separation, and evidence discipline

2026-05-260

synthesis

amhuppert/trellis

Common structure, contrast, takeaways, open questions, and references for Trellis synthesis

2026-05-260

teaching-order

amhuppert/trellis

Foundations before mechanisms, examples before abstractions, progressive detail

2026-05-260

teaching-tone

amhuppert/trellis

Calm, precise, explanatory voice for Trellis reports

2026-05-260

name	report-composition
description	How to compose a Trellis report: choose template, plan sections, orientation, synthesis, KG scope

Report Composition

Plan in this order:

Name the reader outcome and template in report.config.ts.
Draft sections with stable kebab-case ids and a recommended path.
Write orientation fields that route readers into Guided, Reference, Graph, and Synthesis when those modes have useful content.
Define a small KG scope: entities readers must understand, not every noun.
Define synthesis only for cross-section patterns, contrasts, takeaways, and open questions.

Source of truth:

Report shape: packages/engine/src/schemas/report-config.ts
Orientation: packages/engine/src/schemas/orientation.ts
Sections and blocks: packages/engine/src/schemas/section.ts, packages/engine/src/schemas/block.ts
UI examples: packages/storybook/stories/views/OrientationView.stories.tsx, packages/storybook/stories/views/GuidedView.stories.tsx