augment-it/blueprints
- Path
- blueprints/index.md
blueprints
- Augment-It as Working App and Architecture Demonstration - Augment-it is a working product and a live architecture showcase at once; every decision answers to both lenses so neither quietly wins.
- Auth Patterns — Following Astro Knots Conventions in a Rsbuild + Module-Federation Shell - Astro Knots auth rules translated to Rsbuild + NATS: the middleware gate becomes a WS token check, and silent bypass is the shared risk.
- Connecting To And Using SurrealDB - The one place that codifies how augment-it talks to SurrealDB Cloud — the five env vars, the connect → signin → use dance, the client-tagging write contract, and the dev-only-credentials posture that a proxy service eventually replaces.
- Module Federation + Rsbuild — Dev Loop Gotchas - Five Rsbuild + Module Federation gotchas, cross-origin HMR first: none block adoption, all cost time if you don’t see them coming.
- Original and Enhanced Record Instances — the Record-Instance Model - No mutation, no derived set per run: one immutable original plus one mutable enhanced instance per round, promoted to seed the next.
- Packs and Bundles — The Two-Tier Pattern for Entity-Profile Augmentation (and Beyond) - Two tiers: a pack is one source, one remote, one schema; a bundle is a named composition of packs fired by a single chat verb.
- Response–Row Identity Across Promote — Why Responses Outlive Their Rows, and the
record_uuid-on-Response Fix - Promote deletes parent rows, leaving responses pointed at deadrow_ids; carryingrecord_uuidon the response resolves them by identity. - Spec-Kit and Context-V Coexistence — How They Work Together in Augment-It - context-v holds the project’s living memory; spec-kit drives per-feature implementation flow. Complementary, not competing.
- Webhook as Wake-Up, Not as Truth — relaying platform events into CI without trusting them - Polling gets throttled and push payloads are unsigned. Forward the interrupt, not the claim, and both problems stop mattering at once.
- Why Response Reviewer and Highlight Collector Exist — The Verbose-Prose-to-Tabular Bridge - CRM cells are terse and LLM answers are prose; no structured-output regime removes the human integrity check that bridges them.