This space documents the systems behind machinebehavior.io, tychat.io and uncovertechtalent.com: how each site is built, the conformity gate that every push passes before it serves readers, the deploy job, the crawler that draws the map of the work, the Inside front page and this documentation tree.
Three static sites, one gate. Each site is static files on GitHub Pages. Each deploy runs the same conformity checks first; a failed check stops the deploy and the previous build stays live.
Systems
| System | What it does | Source | Page |
|---|---|---|---|
| machinebehavior.io | Research site: claims, experiments, case files, Inside, the map, these docs | uncovertechtalent/machinebehavior.io | Site architecture |
| Conformity gate | Checks every page on every push, weekly and by hand; blocks the deploy on a failed check | .github/actions/conformity/run.py | Conformity gate |
| Deploy job | Refreshes the map, uploads the site, deploys to Pages | .github/workflows/conformity.yml | Deploy pipeline |
| Map crawler | Crawls the three sites and Substack into one graph | scripts/crawl_map.py | Map crawler |
| Inside | Front page with live status, deploys, experiments and dashboards | inside/index.html | Inside portal |
| Docs tree | This documentation, from markdown and the knowledge vault | scripts/build_docs.py | Docs tree |
| Service catalog | Every service with owner, tier, lifecycle, SLOs, dashboard and runbooks | services/*.yml, scripts/build_inside.py | Service catalog |
| Access model | What is public in the demo, and how access works in production (single sign-on, spaces by class, per user and device) | scripts/site_chrome.py (banner) | Access model |
| Status page | State per service from the published records, and the incident history | incidents/*.yml, scripts/build_inside.py, inside/status/status.js | Status page |
| Site navigation | One navigation source for every page: top bar, breadcrumbs, sidebars, footer; orphan and sitemap checks | site/nav.yml, scripts/site_chrome.py | Site navigation and chrome |
| Top bar and search | One bar on every page and one search index | scripts/site_chrome.py, scripts/build_search.py | Top bar and search |
| Ticket board | Work items from GitHub Issues in columns | scripts/board_snapshot.py, inside/board/index.html | Ticket board |
| Founder tour | Six stops through the platform with screenshots of the live pages, for a founder with five minutes | inside/tour/index.html, scripts/tour_shots.js | Five-minute tour, ADR-0020 |
| Observability | Prometheus, Loki and Grafana behind the public dashboards | agent-observability | Observability space |
Where to start
- Five minutes to see the whole platform: the founder tour.
- New to the setup: read Site architecture, then Deploy pipeline.
- Adding a page: follow Add a page to machinebehavior.io.
- A deploy did not go out: start at Runbooks.
- Why something is the way it is: the Decision records, numbered ADR-0001 onward.
- Which SRE principles the platform applies, and where it falls short: Principles in practice in the SRE Handbook.
- What changed and when: the Changelog.