# Alembic Complete Source Analysis - Resources

High-trust resources for the line-by-line study of the Alembic agentic distillation engine. Prioritized by proximity to source truth.

## Primary (must read in Fase 0-1)
- [HANDOFF.md](/Users/acf/Documents/Projects/appfy/alembic/HANDOFF.md) — exhaustive agent handoff with full architecture, 6-layer model, ETL funnel details, and session history.
- [docs/alembic-launch-academy-v2/source-map.html](/Users/acf/Documents/Projects/appfy/alembic/docs/alembic-launch-academy-v2/source-map.html) — existing hot path trace (CLI → harness → council → marketing bridge).
- [docs/alembic-launch-academy-v2/launch-playbook.html](/Users/acf/Documents/Projects/appfy/alembic/docs/alembic-launch-academy-v2/launch-playbook.html) — fact/inference/hypothesis discipline + launch claims.
- [docs/learn-alembic-source-first/alembic-source-first-studio.html](/Users/acf/Documents/Projects/appfy/alembic/docs/learn-alembic-source-first/alembic-source-first-studio.html) — interactive source-first studio (pattern library for our new artifacts).
- [docs/architecture.html](/Users/acf/Documents/Projects/appfy/alembic/docs/architecture.html) and [docs/factory.html](/Users/acf/Documents/Projects/appfy/alembic/docs/factory.html)

## Secondary (reference during deep dives)
- All HTML in `docs/alembic-launch-academy-v2/lectures/` and `projects/` (visual teaching patterns).
- `.factory/CODING_STANDARDS.md` + all `*-prompt.md` (the exact instructions given to planner/implementer/reviewer).
- `packages/contracts/src/` (the single source of truth for every domain type).
- Visual Teach Studio internals (loaded before any HTML generation):
  - `/Users/acf/.codex/plugins/visual-teach-studio/skills/visual-teach-studio/SKILL.md`
  - `internal/visual-docs/references/{design-system.md, report-templates.md, svg-diagrams.md, interactive-patterns.md}`
  - `references/OUTPUT-BLUEPRINT.md` and `HTML-EFFECTIVENESS-DIDACTIC.md`
  - html-effectiveness demos 01-20 (especially 04-code-understanding, 13-flowchart-diagram, 16-implementation-plan).

## Validation & Tooling
- `pnpm typecheck && pnpm build && pnpm -w test && pnpm detect` (mandatory gate before any claim about the source).
- Validator: `python3 /Users/acf/.codex/plugins/visual-teach-studio/skills/visual-teach-studio/scripts/validate_visual_teach_output.py <output-dir>`
- Impeccable for docs/ quality.

## External (use only when needed for context, never as source of truth for code behavior)
- Original blueprints that were clean-room reimplemented (mentioned in HANDOFF: council-runtime, tac/Agentic Development Workflow, sandcastle parallel planner). Always verify against current TS source.

Add new high-trust resources only after they have been used to explain or correct a specific part of the source in a learning record.