oll.am · engineering record · 2026-07-10

Public portfolio refactor — change log

Narrowing the public site to a landing plus two shared engineering documents (Architecture & CI/CD), and curating the diagram set. An internal record of exactly which files changed and why.

What this refactor did

the shape, in one paragraph

The public surface was collapsed to three pages — the landing plus oll-am-architecture.html and oll-am-cicd-design.html — which link only to each other. Every other artifact (operations, maturity, strategy, live state, the whole build log) moved into a developer scope reachable by direct URL through the build log, and appears in no navigation bar. The navigation was simplified to a single bar: oll.am · Architecture · CI/CD. The architecture document was trimmed of product-roadmap sprawl and then re-grown with the specific diagrams that evidence the platform, RAG and agentic claims.

Substantive changes

4 files where content actually changed
FileChangeWhat & why
scripts/render_nav.py editNav generatorCollapsed to one employer-only bar (oll.am · Architecture · CI/CD) injected on every page. Build log / operations / maturity / strategy / live no longer appear in any nav.
site/index.html editLandingKept the product vision primary; dropped scarcity copy and the redundant second header; the only outbound doc links are Architecture & CI/CD.
site/oll-am-architecture.html editPrimary employer docTrimmed product/roadmap sprawl + internal jargon (~1160→~640 lines), added a standalone masthead, then restored/added diagrams (see ledger below). Standalone and CV-shareable.
site/oll-am-cicd-design.html editSecond employer docLight touch — de-internalized two asides (removed franc/backlog/PR references) and cleaned the footer. All three diagrams untouched.
deleted  site/oll-am-operations.html — an Operations write-up created earlier in this effort, removed on request. The pre-existing oll-am-devops-assessment.html (Maturity) was not deleted; it predates this work and now simply sits in the developer scope, unlinked from any nav.

Architecture diagram ledger

what was removed, kept, restored and added
DiagramStatusNote
System architecture (C4)keptcore platform view
Component-level (enriched)keptcore platform view
Deployment view (VPS)kept + enrichednow lists the concrete services running on the VPS
Agent-seam sequence (MCP)restoredbacks the agentic / MCP claim — proven call sequence
Career-agent sequencerestoredthe flagship agent flow — one swipe fans out to all spines
RAG retrieval pipelinerestoredbacks the RAG claim — grounded retrieval, real citations, optional generation
Extension-layer containerretiredproduct-specific; superseded by the restored sequence + RAG diagrams
Platform 2.0 constellationretiredmixed live + planned; replaced by the honest VPS service list
Full IDE file treeretiredreplaced by a compact repo topology

Net: the architecture document carries 5 SVG diagrams plus the HTML deployment view — every one backing a real claim, none carrying product-roadmap cruft.

Everything else — mechanical only

~68 pages, no content change

The remaining pages in the diff (each showing a ±14-line change) were touched by one automated step only: the navigation bar was regenerated from render_nav.py. No prose, structure or diagrams changed on those pages. They remain the developer-scope corpus, reachable through the build log.

The two scopes

what a visitor sees vs. what the maker keeps
Generated as an internal engineering record. Not linked from the public navigation. · Samuel Alemu · oll.am