**Bead** `2028c98b-6fae-4d97-8fd9-3c7e4afba988` · [canonical URI](https://redfish.acequia.io/guerin/.agents/2028c98b-6fae-4d97-8fd9-3c7e4afba988/) · discussion: Talk: Taos Samples This page is the wiki facet of a [bead](https://redfish.acequia.io/guerin/.agents/); the bead is the source of truth.
## Identity - **URI:** `https://redfish.acequia.io/guerin/.agents/2028c98b-6fae-4d97-8fd9-3c7e4afba988/` - **GUID:** `2028c98b-6fae-4d97-8fd9-3c7e4afba988` - **Slug:** `taos-samples` - **Opened:** 2026-06-15 - **Body:** CV (Claude Code — shell + filesystem) - **Mounts (read):** `c66cbd1d` taos-engine + the **taos-orama** repo index (`c66cbd1d/2026-06-14/skills/taos-orama/`) · `6f5044df` **bead-orama** core (the reusable Orama indexer) · `b6fcda63` ants-in-taos (sibling; the first consumer of this catalog) · `221f3fe2` taos-tooling (the substrate skills + the `taos-api` MCP).
## Motivation (why a GUID) Stephen's directive (2026-06-15): the TaosEngine clone ships **~100 runnable samples** (`Documents/src/taos-engine/samples/*.{html,ts}`) — the richest "how do I do X in taos" corpus there is, but it's too big to load and undocumented as a set. This bead makes the sample library **discoverable**: a **catalog** (one entry per sample: what it shows + key API), a **samples-scoped Orama index** (search "which sample demonstrates Y"), and **skills** distilled from the highest-value reusable samples — so a future agent building a taos app knows exactly where to look. Sibling to a possible `taos-recipes` bead (NetLogo-`code-examples`-style small nuggets: `in-cone`, `link-walkers`, etc. — patterns, not full models).
## Mechanism (what this bead does) - `2026-06-15/notes/samples-catalog.md` — the catalog (grouped by area: geo, terrain, rendering, post-fx, fluid, splats, primitives), one row per sample with file · what-it-demonstrates · key modules/API · "use when". - `2026-06-15/skills/` — a samples-scoped Orama build/query skill (reuses the bead-orama core) + distilled how-to skills for the top reusable sample patterns. - Index is a **projection** of the clone (ground truth = the repo); regenerable.
## Folder Layout `about.md` · `README.md` · `bead-bind-startup.md` · `2026-06-15/{notes,skills,chats,artifacts}/` · `uploads/`.
## Session Log - **2026-06-15** — bead opened (autonomous, alongside the ants-in-taos / fire-in-taos build). Cataloging in progress (background agent over the ~100 samples).
## Modus Operandi Read `bead-bind-startup.md`. The catalog + index point AT the clone (`Documents/src/taos-engine/samples/`), which is the authority; open the named file. Query the samples index for capability lookups.
## Capabilities A samples-scoped full-text index (ask "which sample shows projector / fluid / google 3d tiles / …") + the curated catalog (the menu) + distilled skills (the common how-tos).
## Lifecycle Open. Apoptose when the catalog + index + core skills are complete and synced.
## Limitations - Per-sample **skills** are distilled for the high-value reusable samples first; the **catalog** is the exhaustive per-sample reference (a skill per sample can be expanded on demand). - Not the engine API index (that's taos-orama over the whole repo); this is the **samples** lens.
See all: Beads