wize-shard-doc git:20260613.a8c0f41A

Immutable. This exact content is served forever at /api/v1/blob/32e40f89577d28b6.

---
description: "core skill: Shard Doc"
globs:
alwaysApply: false
---

# Shard Doc

# Shard Doc

Splits large markdown (PRD, architecture, etc.) into addressable shards under `{doc-name}.shards/`.

## Why
Agents quote shards by id (`prd.shards/AC-5.md`) instead of pulling the whole document.

## Behavior
- Splits at headings (`##` by default; configurable).
- Each shard gets `id` from heading slug + frontmatter.
- Original doc becomes the index.