Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/bright-relay-docs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@anarchitecture/ghost": patch
---

Update documentation to point generation-context workflows at `ghost relay gather`.
4 changes: 2 additions & 2 deletions docs/fingerprint-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ id: local

The raw layer files can be sparse. Missing files or sections normalize to empty
layers when Ghost assembles the internal `ghost.fingerprint/v1` document used
by checks, review packets, context bundles, compare, and stack merges.
by checks, review packets, Relay briefs, compare, and stack merges.

## Core Layers

Expand Down Expand Up @@ -251,7 +251,7 @@ ghost verify .ghost --root .
ghost check --base main --format json
ghost review --base main --include-memory
ghost emit review-command --path apps/checkout/review/page.tsx
ghost emit context-bundle
ghost relay gather apps/checkout/review/page.tsx
```

`ghost scan` reports readiness in the same three-layer vocabulary. Useful
Expand Down
6 changes: 5 additions & 1 deletion docs/generation-loop.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,11 @@ deterministic gates + advisory surface-composition findings

## Before Generation

Build a brief from the generation packet:
Build a brief from the resolved fingerprint stack:

```bash
ghost relay gather apps/checkout/review/page.tsx
```

1. Read `.ghost/fingerprint/prose.yml`, `.ghost/fingerprint/inventory.yml`, and
`.ghost/fingerprint/composition.yml`.
Expand Down
4 changes: 3 additions & 1 deletion docs/host-adapters.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@ Ghost provides:
- `ghost check --format json` as the stable `ghost.check-report/v1` contract.
- `ghost review --format json` for advisory packets grounded in the resolved
fingerprint stack.
- `ghost emit context-bundle` for a split generation packet.
- `ghost relay gather [target] --format json` as the `ghost.relay.gather/v1`
contract for generation context.
- `--memory-dir <relative-dir>` for wrappers that store Ghost package roots
somewhere other than `.ghost`.

Expand Down Expand Up @@ -62,6 +63,7 @@ at `fingerprint/`. Wrappers can use any safe relative package root:
```bash
ghost init --scope apps/checkout --memory-dir .design/memory
ghost stack apps/checkout/review/page.tsx --memory-dir .design/memory --format json
ghost relay gather apps/checkout/review/page.tsx --memory-dir .design/memory --format json
ghost check --base main --memory-dir .design/memory --format json
ghost review --base main --memory-dir .design/memory --format json
```
Expand Down
4 changes: 2 additions & 2 deletions docs/ideas/fingerprint-first-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ and flow.

That makes the fingerprint more like an upstream contract than a static
guideline or a downstream inspection report. Review, linting, comparison,
generation packets, authoring tools, marketing workflows, and vibe-coding
Relay briefs, authoring tools, marketing workflows, and vibe-coding
workflows can all use the same checked-in surface context. Their outputs differ,
but their source of truth is the fingerprint.

Expand All @@ -69,7 +69,7 @@ fingerprint lifecycle:
| --- | --- | --- |
| Capture | `init`, `inventory`, `scan` | Create the package, gather optional source material, and report layer readiness. |
| Validate | `lint`, `verify` | Check schema shape, refs, evidence, exemplars, and deterministic package quality. |
| Generate / apply | `emit context-bundle`, host agents, future generation consumers | Give agents the upstream surface-composition contract before they build or revise. |
| Generate / apply | `relay gather`, host agents, future generation consumers | Give agents the upstream surface-composition contract before they build or revise. |
| Govern | `check`, `review`, `ack`, `track`, `diverge` | Validate changed surfaces, produce advisory findings, and record stance toward divergence. |
| Compare | `compare`, fleet-style analysis | Understand distance, cohorts, reference relationships, and change across packages. |

Expand Down
Loading