Grok Build for Alembic · Visual Course

Internalize the seam, not the whole machine

Eight interactive lessons grounded in the pinned Grok Build repository and the real Alembic provider—from architecture selection to proof and production boundaries.

Start →Reconnaissance: map before you import

Evidence & selection

Lesson 1

Reconnaissance: map before you import

See Grok Build as several surfaces—not one blob—then locate the single gap Alembic should own.

TUIheadlessACP

Lesson 2

The overlap matrix: adopt, already, defer, reject

Turn repository admiration into an ownership decision that Alembic can maintain.

fitoverlapproof

Integration mechanics

Lesson 3

Headless JSONL: reconstruct the answer honestly

Follow thought, text, end, and error events without inventing a final-result event.

stdinprocessJSONL

Lesson 4

AgentProvider: command, stdin, parser

Walk the clean-room TypeScript seam from prompt to parsed Factory result.

Factory runAgentProvideroptions

Honest operation

Lesson 5

Honesty rails: usage, errors, sessions, auth

Fail closed where the protocol is incomplete or Factory cannot preserve the state atomically.

input_tokenscache_readoutput_tokens

Lesson 6

Tests and the real Proof Gate

Separate contract tests from the host boundary that proves stdin, auth, streaming, and exact output.

Vitesttypecheckbuild

Lesson 7

Production boundaries: roster, Docker, credentials

Keep a successful opt-in provider from silently becoming an unproven production dependency.

providerexporthost

Roadmap

Lesson 8

Roadmap and operating playbook

Choose the next bounded unit by prerequisite and proof—not by upstream feature count.

phase oneproduct needprerequisite