**Bead** `815840e8-a512-4aa3-a53a-fad5487b588f` · [canonical URI](https://redfish.acequia.io/guerin/.agents/815840e8-a512-4aa3-a53a-fad5487b588f/) · discussion: Talk: Grep Capabilities 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/815840e8-a512-4aa3-a53a-fad5487b588f/` - **GUID:** `815840e8-a512-4aa3-a53a-fad5487b588f` - **Slug:** `grep-capabilities` - **Opened:** 2026-06-20 - **Body:** CV (Claude Code — shell + filesystem) - **Mounts (read):** `6f5044df` **bead-orama** (the Orama full-text indexer — grep's indexed sibling) · `2028c98b` taos-samples (a consumer of orama-style search) · `fe7fbaf5` bead-as-webdav-handler (the **cognition ladder** — grep is rung 0, the deterministic rung) · `4456cd24` decentralized-cache-management (search over a no-master replica set).
## Motivation (why a GUID) Stephen's directive (2026-06-20): document the **high-level capabilities of grep**, sketch how to **build grep as a skill for beads**, and **compare when grep beats RAG keyword/vector databases**. The ecology has already invested in indexed search (bead-orama and its scoped derivatives). grep is the *other* answer: the deterministic, index-free, always-fresh primitive. This bead names what grep is strong at, packages it as a reusable bead-scoped skill (the deterministic counterpart to bead-orama), and draws the decision boundary so a future agent picks the right tool instead of reaching for a vector DB by reflex.
## Mechanism (what this bead does) - `2026-06-20/notes/00-grep-capabilities.md` — high-level capability map of grep / ripgrep (the verb vocabulary: literal, regex, context, count, file-type filters, multiline, structured output). - `2026-06-20/notes/01-bead-grep-skill-design.md` — design for a `bead-grep` skill: ripgrep scoped to the `.agents/` commons, surfaced as an agent tool / WebDAV-side capability; the deterministic rung of the cognition ladder; relationship to bead-orama. - `2026-06-20/notes/02-grep-vs-rag.md` — the decision boundary: grep vs RAG keyword (BM25/Orama) vs vector embeddings. When each wins, the failure modes, and the ladder/escalation framing. - `2026-06-20/notes/03-graph-databases-and-first-class-links.md` — graph DBs as the **second axis** (structure/edges, not a content rung). When links are first-class, the commons IS a graph: transitive mounts, lineage, centrality (Hubler invariants), orphan/apoptosis detection. Reified edges (RDF-star / hypergraph) for links-as-beads. grep harvests edges; graph traverses them; both rung-0 deterministic. - `2026-06-20/notes/04-link-structure-proposal.md` — **proposal** for a first-class link structure: a typed/ directed/weighted link descriptor + `rel` vocabulary, two tiers (inline property-edge vs reified link-bead), `links.json` sidecar (grep-harvested then owned), the uses it unlocks (backlinks, traversal, centrality, apoptosis, soft-constraint relaxation), an additive migration path, and 6 open questions. - `2026-06-20/skills/bead-grep/SKILL.md` — runnable skill draft.
## Folder Layout `about.md` · `2026-06-20/{notes,skills,chats,artifacts}/` · `uploads/`.
## Session Log - **2026-06-20** — bead opened. Wrote the three notes (capabilities, skill design, grep-vs-RAG) + the `bead-grep` skill draft. - **2026-06-20** — added note 03 (graph databases as the second/structure axis) after Stephen's prompt to bring graph DBs into the mix given bead links are first-class entities. - **2026-06-20** — added note 04 (link-structure proposal) at Stephen's request; synced the bead to its canonical URI (first sync).
## Modus Operandi Read the notes in order (00 → 02). The skill in `skills/bead-grep/` is the runnable artifact. This is a **reference/design** bead, not a build with a deploy target — exploratory per the dev-team norm.
## Capabilities A capability map of grep, a packaged bead-scoped grep skill, and a tool-selection rubric (grep vs RAG).
## Lifecycle Open. Apoptose when the notes + skill are reviewed and (if wanted) the skill is promoted to the substrate skills set at `redfish.acequia.io/skills/`.
## Limitations - Design-level. The `bead-grep` skill is a draft; it leans on ripgrep being present on the CV host. - The grep-vs-RAG note is a decision rubric, not a benchmark; no measured recall/latency numbers here.
See all: Beads