Entropy Exchange — Claude Code Instructions

Entropy Exchange is the Synaptiq tech blog (Quarto + GitHub Pages / Cloudflare Pages). See AGENTS.md for the full project reference (prerequisites, content types, directory layout, filter pipeline, freeze behavior, etc.).

Quick Commands

just bootstrap        # Install system prerequisites (Quarto, uv, just)
just install          # Install project deps + pre-commit hooks
just preview          # Local dev server with hot reload
just render           # Render with default profile
just render-public    # Render public site (drafts excluded)
just render-internal  # Render internal site (all content)
just post <slug>      # Scaffold a new blog post
just lint             # Run pre-commit hooks on all files
just status           # Show draft and playbook inventory
just clean            # Remove _site and _site-internal
just test             # Run Docker integration tests

Rules

  • Always set draft: true on new posts
  • Put post images in the post’s own directory, not in static/images/
  • Post-specific Python deps go in the post’s own pyproject.toml, not the root one
  • Don’t modify Lua filters without doing a full just render to verify
  • Don’t add dependencies to the root pyproject.toml unless they’re needed by filters or site build
  • Don’t commit large binary files — use .gitignore or external hosting
  • Don’t remove draft: true without explicit approval

Verification

Before considering work complete:

  1. just lint — pre-commit hooks pass
  2. just render-public — public build succeeds
  3. just render-internal — internal build succeeds
  4. just test — Docker integration tests pass (if Docker is available)