Authoring docs for distributables (template, theme, plugin, preset-pack)

The docs ACs across SPEC-109, SPEC-111, and SPEC-116 — authoring guides for each distributable, each create-refrakt --type kind with a worked example.

claude/v0.25.0-workitems View source

Criteria completion

Tracking started Jun 23 — check back for trends.

Relationships

ID:SPEC-116Status:accepted

Authoring scaffolds for distributable extensions

ID:SPEC-109Status:accepted

Site template packages, manifest, and scaffolding

ID:SPEC-111Status:accepted

Decoupled preset packs with scope and compatibility metadata

ID:ADR-024Status:accepted

Themes are framework-agnostic by default; the framework component layer is opt-in

ID:ADR-023Status:accepted

Versioning and compatibility for distributed extensions

Date:2026-06-18

ID:WORK-449Status:done

create-refrakt plugin scaffold

Priority:mediumComplexity:moderateMilestone:v0.25.0

ID:WORK-450Status:done

Framework-agnostic theme scaffold default with --target opt-in

Priority:highComplexity:moderateMilestone:v0.25.0

ID:WORK-451Status:done

Template package format and template.json manifest type

Priority:highComplexity:moderateMilestone:v0.25.0

ID:WORK-456Status:done

Preset-pack format and presets.json manifest (capability not kind)

Priority:highComplexity:moderateMilestone:v0.25.0

claude/v0.25.0-workitems current ready

claude/milestone-v0-28-0-llvtfa done main done changeset-release/main done claude/v0.25.0-impl-3 done

Jun 23, 07:22 PMa6bdcba
Created (ready)by bjornolofandersson

Acceptance Criteria

A template-authoring guide covers the manifest, the framework × purpose model, scaffold-copy semantics, the asset: scheme, and bundling a sandbox
A theme-authoring update covers the framework-agnostic default + --target (ADR-024)
A plugin-authoring pointer + a preset-pack guide cover the scope vocabulary, the JSON carrier + $schema, the dual preset/tint role, and compatibility (tunedFor) semantics
Each create-refrakt --type kind is documented with a worked example, and the ADR-023 peerDeps/compat convention is explained

Approach

Extend site/content/extend/* (theme-authoring, plugin-authoring) and add a template-authoring + preset-pack-authoring guide. Land after the formats exist so examples are accurate.

Dependencies

WORK-449 — plugin scaffold
WORK-450 — theme scaffold default
WORK-451 — template format
WORK-456 — preset-pack format

References

SPEC-109; SPEC-111; SPEC-116; site/content/extend/*