🧠 Context-engineered essays on cognitive load, ADHD, software engineering, and systems-level thinking.
This repository contains the canonical source for all Ego Hygiene essays.
Articles are written in Markdown, converted to HTML via GitHub Actions, and deployed automatically to:
👉 https://articles.egohygiene.io
Medium is used for distribution.
GitHub Pages is the canonical source.
articles/
YYYY-MM-slug/
published.md ← canonical content
draft.md
references.md
assets/
templates/
article-template.html
article.css
site/
index.html
article.css
articles/... ← generated
- Write in
published.md - Push to
main - GitHub Action:
- Converts Markdown → HTML via Pandoc
- Injects into template
- Regenerates index
- Deploys to GitHub Pages
- Publish to Medium with canonical link
- Markdown is source of truth.
- HTML is generated.
- Do not manually edit files in
/site/articles. - Do not embed styling in Markdown.
Infrastructure should never slow idea expression.
- Cognitive Load Is the Missing Layer in Developer Experience
MIT