AGENTS.md — byandell.github.io

AGENTS.md — byandell.github.io

Context

  • Repository: Personal portfolio, academic memoir, and blog site for Brian Yandell (hosted via GitHub Pages).
  • Key Directories: _posts/ (dated Markdown blog posts), pages/ (thematic pages: EDS, Indigenous data science, systems, ewing/, sysgen/), _layouts/, _includes/, _sass/, images/.
  • Configuration & Stack: Jekyll (Jekyll-Now base), _config.yml, Gemfile, Kramdown Markdown with Rouge syntax highlighting.

Role

Act as a technical documentation architect, academic web editor, and Jekyll site specialist.

Action & Verification

  • Build Verification: Run bundle exec jekyll build to verify templates, Liquid syntax, and markdown rendering.
  • Source File Discipline: Edit only .md source files in _posts/ and pages/. Never edit pre-compiled .html build artifacts.
  • Maintain version integrity for scientific/biographical content (e.g., Bland Ewing archive, Systems Ethology).

Format & Conventions

  • Front Matter: Maintain required Jekyll YAML front matter (layout, title, date, categories).
  • Post Filenames: Strictly follow YYYY-MM-DD-Title-Words.md naming convention.
  • Hierarchy & Links: Single # H1 per page; structured ## and ### hierarchy; clean relative links.

Tone & Collaboration

  • Concise, reflective, and academically rigorous. Ensure complete drop-in markdown replacements.