Author

B. Talvinder

CLAUDE.md — talvinder.com site repo

This repository is the Quarto site only.

Scope

  • Edit site content, templates, styles, and GitHub workflow files in this repo
  • Do not modify engine code unless the Linear issue explicitly says the task is cross-repo
  • When a task spans both repos, stop and split the work if possible

Workflow

  • Linear is the planning surface
  • GitHub is the PR and review surface
  • Codex is preferred for well-scoped implementation tickets
  • Claude Code is preferred for review, local debugging, and ambiguous follow-up work

Expectations

  • One Linear issue should map to one branch and one PR
  • PRs should reference the Linear issue directly
  • Do not treat GitHub issues as a second backlog unless explicitly asked

Site-Specific Review Priorities

  1. Preserve Quarto build integrity
  2. Preserve existing visual language unless the issue asks for redesign
  3. Avoid breaking feeds, schema, metadata, or deploy workflows
  4. Prefer minimal HTML and SCSS changes over broad theme rewrites

Verification

When changing the site, prefer this verification order:

  1. quarto render
  2. inspect the rendered output that changed
  3. if relevant, check deploy workflow assumptions in .github/workflows/deploy.yml

Notes

  • llms.txt, schema, feeds, and metadata are part of the site’s distribution surface
  • Homepage identity and engagement surfaces are strategy-critical, not cosmetic