~ / rigs / lucabrag / clo-author-template

lucabrag/clo-author-template

Claude Code workflow template for academic research papers. 18 agents, 10 skills, simulated peer review, R&R cycle, 30+ journal profiles.

↗ GitHub ★ 0 no license updated 4mo ago project Claude Code
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~3.8k tokens
Moderate · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details

Copy this rig

# review before running: this installs third-party code
$ npx degit lucabrag/clo-author-template/.claude ./rig-clo-author-template  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ npx degit lucabrag/clo-author-template/.agents/skills/analyze .claude/skills/analyze
$ npx degit lucabrag/clo-author-template/.agents/skills/discover .claude/skills/discover
$ npx degit lucabrag/clo-author-template/.agents/skills/edit .claude/skills/edit
$ npx degit lucabrag/clo-author-template/.agents/skills/new-project .claude/skills/new-project
$ npx degit lucabrag/clo-author-template/.agents/skills/review .claude/skills/review
$ npx degit lucabrag/clo-author-template/.agents/skills/revise .claude/skills/revise
$ npx degit lucabrag/clo-author-template/.agents/skills/strategize .claude/skills/strategize
$ npx degit lucabrag/clo-author-template/.agents/skills/submit .claude/skills/submit
$ npx degit lucabrag/clo-author-template/.agents/skills/talk .claude/skills/talk
$ npx degit lucabrag/clo-author-template/.agents/skills/tools .claude/skills/tools
$ npx degit lucabrag/clo-author-template/.agents/skills/write .claude/skills/write
$ npx degit lucabrag/clo-author-template/.claude/skills/careful .claude/skills/careful
$ npx degit lucabrag/clo-author-template/.claude/skills/checkpoint .claude/skills/checkpoint
$ npx degit lucabrag/clo-author-template/.claude/skills/dashboard .claude/skills/dashboard
$ npx degit lucabrag/clo-author-template/.claude/skills/freeze .claude/skills/freeze
$ curl -fsSL --create-dirs -o .claude/agents/coder-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/coder-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/coder.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/coder.md
$ curl -fsSL --create-dirs -o .claude/agents/data-engineer.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/data-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/domain-referee.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/domain-referee.md
$ curl -fsSL --create-dirs -o .claude/agents/editor.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/editor.md
$ curl -fsSL --create-dirs -o .claude/agents/explorer-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/explorer-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/explorer.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/explorer.md
$ curl -fsSL --create-dirs -o .claude/agents/guide-writer.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/guide-writer.md
$ curl -fsSL --create-dirs -o .claude/agents/librarian-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/librarian-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/librarian.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/librarian.md
$ curl -fsSL --create-dirs -o .claude/agents/methods-referee.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/methods-referee.md
$ curl -fsSL --create-dirs -o .claude/agents/orchestrator.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/orchestrator.md
$ curl -fsSL --create-dirs -o .claude/agents/prose-editor.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/prose-editor.md
$ curl -fsSL --create-dirs -o .claude/agents/storyteller-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/storyteller-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/storyteller.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/storyteller.md
$ curl -fsSL --create-dirs -o .claude/agents/strategist-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/strategist-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/strategist.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/strategist.md
$ curl -fsSL --create-dirs -o .claude/agents/theorist-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/theorist-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/theorist.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/theorist.md
$ curl -fsSL --create-dirs -o .claude/agents/verifier.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/verifier.md
$ curl -fsSL --create-dirs -o .claude/agents/writer-critic.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/writer-critic.md
$ curl -fsSL --create-dirs -o .claude/agents/writer.md https://raw.githubusercontent.com/lucabrag/clo-author-template/main/.claude/agents/writer.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
          }
        ]
      },
      {
        "matcher": "Edit|Write|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-guard.py"
          }
        ]
      }
    ]
  }
}

Skills (15)

Subagents (22)

coder-critic
model: inherit
Code critic that reviews R/Python/Julia scripts for strategic alignment, code quality, numerical discipline, and reproducibility. Paper-type aware. Runs 16 check categories. Paired critic for the Code
coder
model: inherit
Implements empirical strategies in code. Paper-type aware -- reduced-form estimation, structural models, Monte Carlo simulations, and descriptive analysis. Enforces engineering discipline adapted from
data-engineer
model: inherit
Data cleaning, wrangling, and visualization specialist. Creates cleaning scripts, publication-quality figures, and data documentation. Paired with coder-critic for review.
domain-referee
model: inherit
Specialized blind peer reviewer focused on subject expertise. Evaluates contributions, literature positioning, substantive arguments, and external validity. Calibrated to the field via .claude/referen
editor
model: inherit
Journal editor who desk-reviews papers and synthesizes referee reports into independent editorial decisions. Selects referee dispositions based on journal culture. Exercises judgment -- not score aver
explorer-critic
model: inherit
Data quality critic. Reviews the Explorer's data assessment for measurement validity, sample selection, external validity, and identification compatibility. Scores data sources against a deduction rub
explorer
model: inherit
Data finder and evaluator. Searches for public, administrative, and survey datasets relevant to a research question. Evaluates coverage, access, variables, and fit. Produces ranked data source list wi
guide-writer
model: inherit
Writes documentation and guide pages in a pedagogical, tutorial style inspired by Thariq Shihipar's technical writing. Leads with claims, shows iterations, uses progressive disclosure. For guide site
librarian-critic
model: inherit
Literature quality critic. Reviews the Librarian's annotated bibliography for coverage gaps, journal quality, scope calibration, recency, and categorization quality. Paired critic for the Librarian.
librarian
model: inherit
Literature collector and organizer. Searches top-5 generals, NBER, field journals, SSRN/RePEc for related papers. Produces annotated bibliography, BibTeX entries, frontier map, and positioning recomme
methods-referee
model: inherit
Specialized blind peer reviewer focused on empirical methods. Paper-type aware — evaluates reduced-form identification, structural estimation, theory+empirics testing, and descriptive measurement. Dis
orchestrator
model: inherit
Manages phase transitions, agent dispatch, escalation routing, rule enforcement, referee synthesis, and journal selection across the research pipeline. Tracks the dependency graph, dispatches worker-c
prose-editor
model: inherit
Style editor for economics papers in Luca Braghieri's voice. Enforces RAP, top-down writing, economics intro structure, and classic-style voice. Supports suggest/direct modes, long-target triage, and
storyteller-critic
model: inherit
Talk critic. Reviews Beamer and Quarto RevealJS presentations for narrative flow, visual quality, content fidelity, format scope, and compilation. Paper-type aware. Paired critic for the Storyteller.
storyteller
model: inherit
Creates presentations from the paper in 4 formats (job market, seminar, short, lightning) and 2 output types (Beamer PDF, Quarto RevealJS). Paper-type aware — adapts narrative arc to reduced-form, str
strategist-critic
model: inherit
Empirical strategy critic and gatekeeper. Reviews strategy memos and papers through 4 sequential phases. Paper-type aware -- checks reduced-form designs (DiD, IV, RDD, SC, Event Study), structural est
strategist
model: inherit
Designs empirical strategies across paper types -- reduced-form causal inference, structural estimation, theory+empirics, and descriptive/measurement. Produces strategy memos with design-specific deta
theorist-critic
model: inherit
Theory critic. Reviews formal theoretical content -- assumptions, definitions, lemmas, theorems, proofs -- for logical validity, minimality of conditions, measurability/integrability care, notation co
theorist
model: inherit
Theoretical econometrician / mathematical statistician. Drafts assumptions, definitions, lemmas, propositions, theorems, and formal proofs. Handles identification results, asymptotic theory, influence
verifier
model: inherit
Infrastructure inspector with two modes. Standard mode checks compilation, execution, file integrity, and output freshness between phase transitions. Submission mode adds full AEA replication package
writer-critic
model: inherit
Manuscript critic that reviews paper drafts for structure, claims-evidence alignment, identification fidelity, writing quality, LaTeX format, compilation, voice fidelity, and claim-source traceability
writer
model: inherit
Drafts paper sections using paragraph-level argument moves. Each paragraph has one job — motivation, result, mechanism, qualification. Cleanup pass strips AI patterns after drafting. Use when drafting

Hooks (5)

eventmatcherruns
PreToolUseEdit|Write"$CLAUDE_PROJECT_DIR"/.claude/hooks/protect-files.sh
PreToolUseEdit|Write|Bashpython3 "$CLAUDE_PROJECT_DIR"/.claude/hooks/session-guard.py
PreCompact*python3 "$CLAUDE_PROJECT_DIR"/.claude/hooks/pre-compact.py
SessionStartcompact|resumepython3 "$CLAUDE_PROJECT_DIR"/.claude/hooks/post-compact-restore.py
PostToolUseEdit|Write"$CLAUDE_PROJECT_DIR"/.claude/hooks/post-edit-lint.sh

Permissions

deny (0)
—
ask (0)
—
allow (48)
Bash(git status *)
Bash(git diff *)
Bash(git log *)
Bash(git branch *)
Bash(git add *)
Bash(git commit *)
Bash(git push *)
Bash(git pull *)
Bash(git fetch *)
Bash(git checkout *)
Bash(git merge *)
Bash(git stash *)
Bash(gh pr *)
Bash(gh run *)
Bash(gh api *)
Bash(gh pr list *)
Bash(gh pr view *)
Bash(gh pr merge *)
Bash(gh pr create *)
Bash(gh repo *)
Bash(xelatex *)
Bash(TEXINPUTS=*)
Bash(BIBINPUTS=*)
Bash(latexmk *)
Bash(bibtex *)
Bash(biber *)
Bash(pdfinfo *)
Bash(pdf2svg *)
Bash(quarto render *)
Bash(Rscript *)
Bash(python3 *)
Bash(chmod *)
Bash(open *)
Bash(ls *)
Bash(wc *)
Bash(sort *)
Bash(for *)
Bash(gs *)
Bash(pdftk *)
Bash(mkdir *)
Bash(do if:*)
Bash(then echo:*)
Bash(fi)
Bash(find ~/Desktop -iname *ABDC* -o -iname *abdc*)
Edit(/.claude/skills/review/**)
Bash(mkdir -p .claude/references)
Bash(mv .claude/rules/journal-profiles.md .claude/references/journal-profiles.md)
Bash(echo "meta-governance.md: 252 -> 20 lines \(saved 232\)")

Similar rigs

copied ✓