santanna-research-fork

An adapted fork of pedrohcgs/claude-code-my-workflow for producing formal LaTeX research reports with a companion HTML site, data analysis, and visualization. Ships with opinionated .claude/ rules, skills, hooks, and templates.

Primary output is a PDF report via pdflatex + BibTeX; secondary output is a Gwern-styled HTML companion built with Pandoc.

What you get

• A new-project.sh scaffolder that creates an isolated project folder per research topic
• A rule-driven Claude Code workflow: plan-first, contractor-mode orchestration, session logging, quality gates, verification protocol
• Slash-command skills: /new-project, /compile-report, /build-html, /compile-tikz, /lit-review, /data-analysis, /proofread, /validate-bib, /commit, and more (see CLAUDE.md)
• Seven hooks wired into .claude/settings.json for desktop notifications, file protection, context monitoring, and pre/post-compaction state capture
• A LaTeX report template with BibTeX, hyperref, cleveref, and standard academic packages
• A TikZ compile pipeline (PDF + SVG for LaTeX and HTML respectively)
• A Pandoc HTML pipeline with sidebar TOC, citation popovers, and MathJax

Prerequisites

Install these before first run. Commands shown for macOS (Homebrew) and Debian/Ubuntu.

Quickstart

Then in your Claude Code session, scaffold your first project with the /new-project slash command: