Comms documentation push — vision spec, architecture explainer, and prompts that travel with the project
Why Care?
The hardest moment in a project's life is when somebody new wants to help and
nothing exists to read before they get to the code. The Tanuj-shaped starter
was running, but the why was still in our heads. This drop wrote it down.
The headline artifact is the "Augment-It Monorepo Vision Specification" —
the longest of the documents — which states what the workshop is for
(augmenting structured data with AI in human-supervised loops), why a
module-federated shell is the chosen shape, and how the apps relate to each
other in pipeline order.
Alongside it: a Docker-with-module-federation spec, a workflow document that
walks through what a single record's journey looks like across the
microfrontends, and a fully-portable monorepo-setup prompt that doesn't
assume any particular language or framework — so the same shape can be
reused on a future Lossless project that picks a different stack.
What's New?
Augment-It Monorepo Vision Specification.md— the long-form statement of intent.Module-Federation-with-Docker.md— operational spec for how the federation manifest interacts with the container topology.Data Augmentation Workflow with Microfrontends.md— narrative walkthrough ofrecord → prompt → request → response → highlight → insightbefore any of those pages existed in code.Full Prompt for Monorepo Setup (Stack Agnostic).md— a portable prompt that emits a monorepo skeleton in whichever stack you point it at.
These all migrated into
Specs/ and Prompts/ under the
content/projects/Augment-It/ tree shortly after, where they currently live.Backfilled from git history on 2026-05-12. Commit:
b2a6941.