# pi-wishcraft documentation

The README is the public landing page (`banner.png` only). Everything below lives here.

## Guides

- [Commands & interactivity](./commands.md) — `/powerline`, `/tps`, `/usage`, `/queue`, `/idea`, placement, presets, keybinds, and the navigable overlay.
- [Configuration](./configuration.md) — custom items, hooks, repairs, token budget, labels, templates, layout, cost alert, and display formats.
- [Bash mode](./bash-mode.md) — sticky shell, ghost suggestions, and shell config.
- [Stash & shortcuts](./stash-and-shortcuts.md) — editor stash, prompt history, clipboard/navigation shortcuts, and shortcut config.
- [Skill manager](./skill-manager.md) — browsing, inserting, `/skills doctor`, and `/skills new` templates.
- [Working vibes](./working-vibes.md) — themed loading messages, modes, and configuration.
- [Segments & theming](./segments.md) — segment reference, separators, thinking/path/git options, and theme overrides.

## Design System & vNext Specifications

- [vNext Stacked PR Release Plan](./design/vnext-release-plan.md) — The comprehensive implementation roadmap covering PR0 through PR8.
- [vNext Architecture & Overview](./design/vnext-overview.md) — Product vision, five pillars, and architectural boundaries.
- [Semantic Tokens & Theme Contract](./design/theme-contract.md) — `WishcraftTokens` schema and backward compatibility mappings.
- [Ten Structural Presets](./design/presets.md) — Full catalog of signature structural presets (*Lanternwake*, *Threadbound*, *Scryglass*, etc.).
- [Semantic Motion Engine](./design/motion-system.md) — Event-driven motion specifications, 0 FPS idle guarantee, channel matrix, and cadences.
- [Signal — Animated Powerline](./design/signal.md) — 3-lane powerline architecture, live sweeps, and fault-isolated segments.
- [Wishcraft Deck Layout](./design/deck-layout.md) — Continuous outer surface design, route catalog, deep links, and navigation ergonomics.
- [Motion Gallery & Composer](./design/motion-gallery.md) — Animation catalog categories and real-time motion authoring specifications.
- [Accessibility & Fallbacks](./design/accessibility.md) — Motion sensitivity levels, `NO_COLOR` compliance, and universal ASCII degradation.
- [Responsive Layouts](./design/responsive.md) — Viewport width breakpoints and dynamic height constraints.
- [Regression Testing](./design/regression-testing.md) — Pure-function unit test strategies, golden ANSI snapshots, and quality gates.

## Core Skills

- [Wishcraft TUI Skill](../skills/wishcraft-tui/SKILL.md) — Engineering guide and design rules for building Wishcraft components.

## Planning

- [ROADMAP.md](../ROADMAP.md) — Release campaigns, remaining maturity gaps, and vNext stacked PR roadmap.