Personal academic website built with Franklin.jl. Hosted on GitHub Pages.
Pulled from ~/.claude/CLAUDE.md — applies as-is unless overridden below.
Local CLAUDE.md required for every project; new rules go to .claude/rules/<name>.md as separate files (kebab-case names).
CLAUDE.md stays lean (<100 lines) — it's a config index, not docs.
Visual docs in docs/architecture.md — diagrams, color conventions (#0969DA global, #1A7F37 local, #CF222E mandatory, #8250DF architecture, #BF8700 conventions).
Branch discipline — stay on the current branch; never create or switch branches without explicit user approval; always merge with --no-ff.
Commits — no AI attribution (no Co-Authored-By: Claude, no emoji/robot footers). Same applies to PR descriptions and squash merges.
Golden/baseline files — never modify/regenerate snapshot, golden, baseline, or status files without explicit approval. Test input fixtures are not auto-blocked but still ask before changing.
Verify before claiming — never invent library types, function names, or version constraints. Cite source (doc URL, file line, registry) for any "X requires Y" claim.
Scope discipline — no refactor/abstractions beyond what was asked; prefer the simplest working approach first.
Shell — bash is default; PowerShell only when bash fails on Windows (e.g. permission-locked deletes).
Julia sysimage (~/.julia/sysimages/makie_glmakie_0_13.dll) — only use -J<sysimage> when project depends on GLMakie 0.13.x. Not applicable to this project (no GLMakie dep).
JuliaHub channels (dyad, etc.) — use channel binary from ~/.julia/juliaup-depots/. Not applicable here (plain juliaup Julia is fine for Franklin).
See ~/.claude/CLAUDE.md and ~/.claude/rules/ for full text.
See .claude/rules/:
franklin-serve.md — how to launch the local dev server
cv-edits.md — CV is Word-exported HTML; editing conventions
content-structure.md — Franklin layout, where pages and assets live
| Want to… | Do this |
|---|---|
| Preview locally | julia --project=. -e 'using Franklin; serve()' → http://localhost:8000 |
| Edit a page | Edit the .md file at repo root (CV.md, Blog.md, etc.) |
| Edit CV body | Edit _layout/htmls_for_pages/CV/CV.html (Word-exported HTML — preserve structure) |
| Change site config | config.md |
| Add a layout helper | utils.jl (Julia) |
| Add CSS | _css/ |