Step 16 · Next steps · Next steps · Where to go next ENPT
Alembic Complete Visual Course

Where to go next

A handoff map of what to read, change, or teach depending on your goal.

Read the plain version, or open the technical layer on any section.
1

Choose your own path

You now have a map of the whole Alembic monorepo. The next step depends on your role:

  • Add a model → edit packages/contracts/src/registry.ts.
  • Add a new source → implement Collector in @alembic/ingestion.
  • Change a gate → look in @alembic/coda.
  • Improve the CLI → edit apps/cli/src/args.ts and commands.ts.
  • Teach → generate a course with generateCourse and publish via loop-engineering scripts.

Every change should be proven at the real boundary: run the command or test that exercises the modified path.

Think of it like… a subway map: you now know all the lines and can plan any route.

Under the hood

Key entry points for each package: @alembic/contracts/src/index.ts, @alembic/adapters/src/index.ts, @alembic/etl/src/index.ts, @alembic/ingestion/src/index.ts, @alembic/swarm/src/index.ts, @alembic/mission/src/index.ts, @alembic/vm/src/index.ts, @alembic/forge/src/index.ts, @alembic/coda/src/index.ts, @alembic/harness/src/index.ts, @alembic/web/src/index.ts, @alembic/tui/src/index.ts, @alembic/marketing-factory/src/index.ts, @alembic/factory/src/index.ts, @alembic/infra/src/index.ts, apps/cli/src/index.ts.

2

In one picture

Alembic Engine CLI / Web / TUI Harness Forge / Planf3 Swarm / VM Council / Coda Mission Adapters Contracts ETL / Ingestion LLM Providers
Return to the architecture map whenever you need to reorient.
3

In the code

# run the full test suite
pnpm -r typecheck && pnpm -r build && pnpm -w test

# run just the CLI tests
pnpm --filter @alembic/cli test

Implementation notes

The canonial verification command is pnpm -r typecheck && pnpm -r build && pnpm -w test. It checks every package, builds dist, and runs the full Vitest suite. The CI workflow runs the same steps plus alembic doctor --json and impeccable detect.

4

Try it

Pick one package and read its src/index.ts. Identify its three most important exports and how the CLI uses them.

Commit: What is the first change you want to make, and which gate will prove it works?
5

Quick check

Which package should you edit to add a new LLM model?