@zigrivers/scaffold 3.29.0 → 3.30.0

package/content/guides/install/index.md

@@ -0,0 +1,186 @@
+---
+title: Install, Update & Adopt
+topic: install
+description: Installing via npm/Homebrew/plugin, keeping current, and adopting scaffold into a new or existing project
+category: reference
+order: 25
+---
+
+## Overview
+
+Scaffold ships as one tool with two install surfaces: the **`scaffold` CLI**
+(distributed on npm as `@zigrivers/scaffold` and via Homebrew) and an optional
+**Claude Code plugin** that auto-activates the runner and pipeline-reference
+skills. The CLI is the core; the plugin only adds interactive guidance on top of
+it. The published npm package exposes the single `scaffold` binary
+(:cite[package.json:37]) and bundles the compiled CLI plus the pipeline content,
+knowledge entries, and skills (:cite[package.json:27]).
+
+This guide is for **users** installing, updating, and bootstrapping projects.
+Maintainers releasing Scaffold itself follow a separate flow in
+`docs/architecture/operations-runbook.md` :cite[docs/architecture/operations-runbook.md:326]{mode=advisory}.
+
+:::callout{type=note}
+**Prerequisite — Node.js 18.17+.** The CLI requires Node.js `>=18.17.0`
+(:cite[package.json:34]). The Homebrew formula installs and manages Node as a
+dependency, so you don't install Node separately; the npm install uses your
+system Node.
+:::
+
+## Installing
+
+Pick one of the three surfaces below. The npm and Homebrew tabs install the CLI;
+the plugin tab adds the optional Claude Code skills on top.
+
+::::tabs
+:::tab{title=npm}
+```bash
+npm install -g @zigrivers/scaffold
+```
+Verify with `scaffold version`. This is the recommended path — it uses your
+system Node and updates with `npm update -g`.
+:::
+:::tab{title=Homebrew}
+```bash
+brew tap zigrivers/scaffold
+brew install scaffold
+```
+The formula installs and manages Node as a dependency, so no separate Node
+install is needed. Verify with `scaffold version`.
+:::
+:::tab{title=Claude Code plugin}
+Inside a Claude Code session:
+```text
+/plugin marketplace add zigrivers/scaffold
+/plugin install scaffold@zigrivers-scaffold
+```
+This is **optional** and complements the CLI — it auto-activates the Scaffold
+Runner and pipeline-reference skills for interactive guidance. Everything the
+plugin does is also reachable via `scaffold run <step>`. CLI-only users don't
+need it: `scaffold init` installs the skills automatically and later CLI
+commands keep them current.
+:::
+::::
+
+## Keeping current
+
+Check what you have and whether a newer release exists with `scaffold version`
+(or `scaffold update --check-only`); both query the npm registry for the latest
+`@zigrivers/scaffold` (:cite[src/cli/commands/version.ts:93]). `scaffold update`
+detects how you installed and prints the right upgrade command rather than
+running the install for you — Homebrew installs map to `brew upgrade scaffold`
+(:cite[src/cli/commands/update.ts:47]), npm-global installs to
+`npm update -g @zigrivers/scaffold` (:cite[src/cli/commands/update.ts:51]), and
+anything else falls back to `npx @zigrivers/scaffold@latest`
+(:cite[src/cli/commands/update.ts:55]).
+
+The Homebrew command it prints is exactly `brew upgrade scaffold` — it does
+**not** include the `brew update` prefix. Homebrew users must prepend it
+themselves and run `brew update && brew upgrade scaffold`, or the upgrade can
+silently no-op against a stale tap cache (see the danger callout below).
+
+Run the upgrade for your channel:
+
+::::tabs
+:::tab{title=npm}
+```bash
+npm update -g @zigrivers/scaffold
+```
+:::
+:::tab{title=Homebrew}
+```bash
+brew update && brew upgrade scaffold
+```
+:::
+:::tab{title=Claude Code plugin}
+```text
+/plugin marketplace update zigrivers-scaffold
+```
+:::
+::::
+
+:::callout{type=danger}
+**Homebrew: run `brew update` *before* `brew upgrade`.** `brew outdated` and
+`brew upgrade` both read from the local tap cache. Without a preceding
+`brew update`, the cache stays stale and a freshly-published release reports
+"already installed" / nothing-outdated even though a newer formula is live on
+GitHub. Always upgrade with `brew update && brew upgrade scaffold`
+:cite[docs/architecture/operations-runbook.md:326]{mode=advisory}.
+:::
+
+After upgrading the CLI, run `scaffold status` inside any existing project. The
+state manager auto-migrates old step keys, drops retired steps, and normalizes
+artifact paths — no manual editing of `.scaffold/state.json` is needed.
+
+## Starting fresh vs. adopting
+
+Both `scaffold init` and `scaffold adopt` operate on the current project
+directory. Use **`init`** to set up a project from scratch and **`adopt`** to
+bootstrap pipeline state from documentation you already have.
+
+```mermaid
+flowchart TD
+  A[New or existing project] --> B{Have matching docs<br/>PRD, tech-stack, etc.?}
+  B -->|No / brand new| C["scaffold init<br/>wizard + config + skills"]
+  B -->|Yes, already written| D["scaffold init, then<br/>scaffold adopt"]
+  C --> E[Run the pipeline]
+  D --> E
+```
+
+### `scaffold init`
+
+`scaffold init` initializes Scaffold for the current project
+(:cite[src/cli/commands/init.ts:152]): it runs a wizard, writes `.scaffold/`
+config and state, and installs the skills. The wizard detects whether the
+directory is brand new or already has code and suggests a methodology preset
+(`mvp`, `deep`, or `custom`) accordingly. To re-initialize a project that
+already has a `.scaffold/` directory, pass `--force` — it backs up the existing
+state before reinitializing (:cite[src/cli/commands/init.ts:157]).
+
+### `scaffold adopt`
+
+`scaffold adopt` adopts an existing project into Scaffold
+(:cite[src/cli/commands/adopt.ts:168]). It classifies the project as
+`greenfield`, `brownfield`, or `v1-migration`
+(:cite[src/project/adopt.ts:72]), discovers which pipeline outputs (PRD,
+tech-stack, coding-standards, etc.) you already have on disk, and marks the
+corresponding steps complete so you don't re-run work you've already done.
+Preview the changes first with `--dry-run`, which reports what it would do
+without writing anything (:cite[src/cli/commands/adopt.ts:173]).
+
+The usual sequence for an existing codebase: `scaffold init` (create the config
+and state), then `scaffold adopt` (backfill state from existing docs), then pick
+up the pipeline at the first incomplete step.
+
+## Troubleshooting
+
+:::callout{type=tip}
+**`scaffold: command not found` after npm install.** Your global npm `bin`
+directory isn't on `PATH`. Find it with `echo "$(npm prefix -g)/bin"` (the
+binaries live in the `bin` subdirectory of `npm prefix -g`) and add that
+directory to your shell `PATH`, or reinstall with a prefix that's already on
+`PATH`.
+:::
+
+- **Homebrew says "already installed" after a release.** You skipped
+  `brew update`. Run `brew update && brew upgrade scaffold` (see the danger
+  callout above).
+- **Wrong version reported.** Run `scaffold version` to see the installed
+  version, Node version, platform, and the latest registry version side by
+  side. If two installs collide (e.g. both npm-global and Homebrew), remove one.
+- **Node too old.** The CLI needs Node 18.17+ (:cite[package.json:34]). Upgrade
+  Node, or use the Homebrew install, which installs and manages Node as a
+  dependency.
+- **`scaffold update` only prints a command.** That's intentional — it never
+  runs installs for you. Copy the printed upgrade command for your channel and
+  run it yourself.
+- **Existing project behaves oddly after upgrade.** Run `scaffold status` to
+  trigger automatic state migration before anything else.
+
+## See also
+
+- [Pipeline reference](../pipeline/index.md){mode=advisory} — what the steps are
+  and the order they run in.
+- [CLI reference](../cli/index.md){mode=advisory} — every `scaffold` subcommand.
+- [Multi-agent workflow](../multi-agent/index.md){mode=advisory} — running the
+  pipeline across parallel worktrees.

package/content/guides/knowledge/.diagrams/diagram-0.svg

@@ -0,0 +1 @@
+<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 830.078px; background-color: transparent;" viewBox="0 0 830.078125 566.5999755859375" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#000000;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#666;stroke:#666;}#my-svg .marker.cross{stroke:#666;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#000000;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#000000;color:#000000;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#eee;stroke:#999;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#666!important;stroke-width:0;stroke:#666;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#666;stroke-width:1px;}#my-svg .flowchart-link{stroke:#666;fill:none;}#my-svg .edgeLabel{background-color:white;text-align:center;}#my-svg .edgeLabel p{background-color:white;}#my-svg .edgeLabel rect{opacity:0.5;background-color:white;fill:white;}#my-svg .labelBkg{background-color:rgba(255, 255, 255, 0.5);}#my-svg .cluster rect{fill:hsl(0, 0%, 98.9215686275%);stroke:#707070;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(-160, 0%, 93.3333333333%);border:1px solid #707070;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#000000;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:white;text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:white;padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:white;fill:white;}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg .node .neo-node{stroke:#999;}#my-svg [data-look="neo"].node rect,#my-svg [data-look="neo"].cluster rect,#my-svg [data-look="neo"].node polygon{stroke:url(#my-svg-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#my-svg [data-look="neo"].node path{stroke:url(#my-svg-gradient);stroke-width:1px;}#my-svg [data-look="neo"].node .outer-path{filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#my-svg [data-look="neo"].node .neo-line path{stroke:#999;filter:none;}#my-svg [data-look="neo"].node circle{stroke:url(#my-svg-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#my-svg [data-look="neo"].node circle .state-start{fill:#000000;}#my-svg [data-look="neo"].icon-shape .icon{fill:url(#my-svg-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#my-svg [data-look="neo"].icon-shape .icon-neo path{stroke:url(#my-svg-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="my-svg_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M129.453,92.2L129.453,96.367C129.453,100.533,129.453,108.867,156.34,117.64C183.227,126.413,237.002,135.626,263.889,140.232L290.776,144.839" id="my-svg-L_STEP_SELECT_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_STEP_SELECT_0" data-points="W3sieCI6MTI5LjQ1MzEyNSwieSI6OTIuMTk5OTk2OTQ4MjQyMTl9LHsieCI6MTI5LjQ1MzEyNSwieSI6MTE3LjE5OTk5Njk0ODI0MjE5fSx7IngiOjI5NC43MTg3NSwieSI6MTQ1LjUxNDM5MzE0MDk4NDZ9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M418.375,92.2L418.375,96.367C418.375,100.533,418.375,108.867,418.375,116.533C418.375,124.2,418.375,131.2,418.375,134.7L418.375,138.2" id="my-svg-L_OVERLAY_SELECT_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_OVERLAY_SELECT_0" data-points="W3sieCI6NDE4LjM3NSwieSI6OTIuMTk5OTk2OTQ4MjQyMTl9LHsieCI6NDE4LjM3NSwieSI6MTE3LjE5OTk5Njk0ODI0MjE5fSx7IngiOjQxOC4zNzUsInkiOjE0Mi4xOTk5OTY5NDgyNDIyfV0=" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M418.375,191.2L418.375,195.367C418.375,199.533,418.375,207.867,418.375,215.533C418.375,223.2,418.375,230.2,418.375,233.7L418.375,237.2" id="my-svg-L_SELECT_RENDER_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_SELECT_RENDER_0" data-points="W3sieCI6NDE4LjM3NSwieSI6MTkxLjE5OTk5Njk0ODI0MjJ9LHsieCI6NDE4LjM3NSwieSI6MjE2LjE5OTk5Njk0ODI0MjJ9LHsieCI6NDE4LjM3NSwieSI6MjQxLjE5OTk5Njk0ODI0MjJ9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M703.961,92.2L703.961,96.367C703.961,100.533,703.961,108.867,677.63,117.597C651.298,126.328,598.635,135.456,572.304,140.02L545.972,144.584" id="my-svg-L_INDEX_SELECT_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_INDEX_SELECT_0" data-points="W3sieCI6NzAzLjk2MDkzNzUsInkiOjkyLjE5OTk5Njk0ODI0MjE5fSx7IngiOjcwMy45NjA5Mzc1LCJ5IjoxMTcuMTk5OTk2OTQ4MjQyMTl9LHsieCI6NTQyLjAzMTI1LCJ5IjoxNDUuMjY2OTIzNDk3Mjc3OX1d" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M418.375,325.4L418.375,329.567C418.375,333.733,418.375,342.067,418.375,349.733C418.375,357.4,418.375,364.4,418.375,367.9L418.375,371.4" id="my-svg-L_RENDER_TAIL_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_RENDER_TAIL_0" data-points="W3sieCI6NDE4LjM3NSwieSI6MzI1LjM5OTk5Mzg5NjQ4NDR9LHsieCI6NDE4LjM3NSwieSI6MzUwLjM5OTk5Mzg5NjQ4NDR9LHsieCI6NDE4LjM3NSwieSI6Mzc1LjM5OTk5Mzg5NjQ4NDR9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M418.375,442L418.375,446.167C418.375,450.333,418.375,458.667,418.375,466.333C418.375,474,418.375,481,418.375,484.5L418.375,488" id="my-svg-L_TAIL_OUT_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_TAIL_OUT_0" data-points="W3sieCI6NDE4LjM3NSwieSI6NDQxLjk5OTk5MjM3MDYwNTQ3fSx7IngiOjQxOC4zNzUsInkiOjQ2Ni45OTk5OTIzNzA2MDU0N30seyJ4Ijo0MTguMzc1LCJ5Ijo0OTEuOTk5OTkyMzcwNjA1NDd9XQ==" data-look="classic" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_STEP_SELECT_0" transform="translate(0, 0)"><text y="-10.1" text-anchor="middle"><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em" text-anchor="middle"/></text></g></g><g><rect class="background" style="stroke: none"/></g><g class="edgeLabel"><g class="label" data-id="L_OVERLAY_SELECT_0" transform="translate(0, 0)"><text y="-10.1" text-anchor="middle"><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em" text-anchor="middle"/></text></g></g><g><rect class="background" style="stroke: none"/></g><g class="edgeLabel"><g class="label" data-id="L_SELECT_RENDER_0" transform="translate(0, 0)"><text y="-10.1" text-anchor="middle"><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em" text-anchor="middle"/></text></g></g><g><rect class="background" style="stroke: none"/></g><g class="edgeLabel"><g class="label" data-id="L_INDEX_SELECT_0" transform="translate(0, 0)"><text y="-10.1" text-anchor="middle"><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em" text-anchor="middle"/></text></g></g><g><rect class="background" style="stroke: none"/></g><g class="edgeLabel"><g class="label" data-id="L_RENDER_TAIL_0" transform="translate(0, 0)"><text y="-10.1" text-anchor="middle"><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em" text-anchor="middle"/></text></g></g><g><rect class="background" style="stroke: none"/></g><g class="edgeLabel"><g class="label" data-id="L_TAIL_OUT_0" transform="translate(0, 0)"><text y="-10.1" text-anchor="middle"><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em" text-anchor="middle"/></text></g></g><g><rect class="background" style="stroke: none"/></g></g><g class="nodes"><g class="node default" id="my-svg-flowchart-STEP-0" data-look="classic" transform="translate(129.453125, 50.099998474121094)"><rect class="basic label-container" style="" x="-121.453125" y="-42.099998474121094" width="242.90625" height="84.19999694824219"/><g class="label" style="" transform="translate(0, -27.099998474121094)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">pipeline</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> step</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">frontmatter:</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="2.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">knowledge-base:</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> [names]</tspan></tspan></text></g></g></g><g class="node default" id="my-svg-flowchart-SELECT-1" data-look="classic" transform="translate(418.375, 166.6999969482422)"><rect class="basic label-container" style="" x="-123.65625" y="-24.5" width="247.3125" height="49"/><g class="label" style="" transform="translate(0, -9.5)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">loadEntries(index,</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> names)</tspan></tspan></text></g></g></g><g class="node default" id="my-svg-flowchart-OVERLAY-2" data-look="classic" transform="translate(418.375, 50.099998474121094)"><rect class="basic label-container" style="" x="-117.46875" y="-42.099998474121094" width="234.9375" height="84.19999694824219"/><g class="label" style="" transform="translate(0, -27.099998474121094)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">resolved</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">overlay.knowledge[step]</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="2.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">(or</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> step</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> frontmatter)</tspan></tspan></text></g></g></g><g class="node default" id="my-svg-flowchart-RENDER-5" data-look="classic" transform="translate(418.375, 283.2999954223633)"><rect class="basic label-container" style="" x="-129.078125" y="-42.099998474121094" width="258.15625" height="84.19999694824219"/><g class="label" style="" transform="translate(0, -27.099998474121094)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">buildKnowledgeBaseSection</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">##</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> name:</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> description</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> +</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="2.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">body</tspan></tspan></text></g></g></g><g class="node default" id="my-svg-flowchart-INDEX-6" data-look="classic" transform="translate(703.9609375, 50.099998474121094)"><rect class="basic label-container" style="" x="-118.1171875" y="-42.099998474121094" width="236.234375" height="84.19999694824219"/><g class="label" style="" transform="translate(0, -27.099998474121094)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">buildIndexWithOverrides</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">global</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> +</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="2.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">.scaffold/knowledge</tspan></tspan></text></g></g></g><g class="node default" id="my-svg-flowchart-TAIL-9" data-look="classic" transform="translate(418.375, 408.6999931335449)"><rect class="basic label-container" style="" x="-101.4140625" y="-33.29999923706055" width="202.828125" height="66.5999984741211"/><g class="label" style="" transform="translate(0, -18.299999237060547)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">renderGapSignalTail</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">(unless</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> QUIET)</tspan></tspan></text></g></g></g><g class="node default" id="my-svg-flowchart-OUT-11" data-look="classic" transform="translate(418.375, 525.299991607666)"><rect class="basic label-container" style="" x="-119.25" y="-33.29999923706055" width="238.5" height="66.5999984741211"/><g class="label" style="" transform="translate(0, -18.299999237060547)"><rect/><g><rect class="background" style="stroke: none"/><text y="-10.1" style=""><tspan class="text-outer-tspan row" x="0" y="-0.1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">Knowledge</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> Base</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> section</tspan></tspan><tspan class="text-outer-tspan row" x="0" y="1em" dy="1.1em"><tspan font-style="normal" class="text-inner-tspan" font-weight="normal">in</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> the</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> assembled</tspan><tspan font-style="normal" class="text-inner-tspan" font-weight="normal"> prompt</tspan></tspan></text></g></g></g></g></g></g><defs><filter id="my-svg-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="my-svg-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><linearGradient id="my-svg-gradient" gradientUnits="objectBoundingBox" x1="0%" y1="0%" x2="100%" y2="0%"><stop offset="0%" stop-color="hsl(0, 0%, 83.3333333333%)" stop-opacity="1"/><stop offset="100%" stop-color="hsl(0, 0%, 88.9215686275%)" stop-opacity="1"/></linearGradient></svg>

package/content/guides/knowledge/.diagrams/manifest.json

@@ -0,0 +1,3 @@
+{
+  "diagram-0": "d7f684070c3963b3"
+}