PhilLit: Instructions file for Claude Code

CLAUDE.md

PhilLit CLAUDE.md is an instructions file for Claude Code from AI-4-Phi/PhilLit. It costs 6,808 tokens per session, scanned A, original, Apache-2.0.

Developer instructions for PhilLit, a Claude Code plugin that uses multiple agents to write philosophy literature reviews and improve its review workflow.

In plain words
What is it for?
Use them when developing or testing PhilLit, or when running its six-phase literature-review process with verified academic references.
Why use it?
They clarify how the plugin operates in production and development, including which workflow to start and where its instructions live.

Instructions file for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: reads .claude/ paths; mentions .claude-plugin; mentions CLAUDE.md.

This is AI-4-Phi/PhilLit's own configuration. It tells Claude Code how to work on PhilLit itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything PhilLit configures →

Runs only inside a plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else, and the catalogue could not identify which plugin ships it.

Reuse

Borrowing it

Nothing to install: this file belongs to AI-4-Phi/PhilLit. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/AI-4-Phi/PhilLit/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/AI-4-Phi/PhilLit

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for PhilLit CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ai-4-phi/phillit/claude-md/github.svg)](https://agentmods.dev/instructions/ai-4-phi/phillit/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/ai-4-phi/phillit/claude-md"><img src="https://agentmods.dev/badge/instructions/ai-4-phi/phillit/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for PhilLit CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/ai-4-phi/phillit/claude-md"><img src="https://agentmods.dev/badge/instructions/ai-4-phi/phillit/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 6,808 This file is loaded in full into every session.
When invoked 6,808 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.06808 $0.06808
Opus 5.5 $0.02723 $0.02723
Sonnet 5.5 $0.01362 $0.01362
Haiku 4.5 $0.00681 $0.00681

Measured 11d ago against content hash 39effea8325a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

PhilLit CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 196 lines

How it starts

The opening of the file, as written. The whole thing — 196 lines — stays where its author put it; the contents beside it link to each section on GitHub.

PhilLit is a multi-agent system to (a) author academic literature reviews for philosophy research, and (b) improve these agents. It is packaged as a distributable Claude Code plugin.

This CLAUDE.md is for plugin developers working in this repository. It does not load when PhilLit runs as an installed plugin from a user's own directory — runtime guidance lives in the skills (skills/*/SKILL.md) and agents (agents/*.md).

Mode

Production mode (default): When the user asks for a literature review, invoke the /phillit:literature-review skill to begin the 6-phase workflow. Skills and agents register only when the plugin is loaded — a bare dev clone registers none of them. To run a review against your checkout, launch claude --plugin-dir /path/to/PhilLit from a scratch directory (see CONTRIBUTING.md, Getting Started).

Development mode: Only if user explicitly asks to develop, improve, or test agents/skills. Work on definitions in agents/ and skills/.

Objectives

Main objective, above every other concern: build the best tooling to advance the norms in philosophy around using AI, and to show the AI-curious what AI can do for philosophy research. PhilLit and phillit-service are not a public professional product: practically nobody uses the service, and any users will be friends and acquaintances experimenting together.

Priority order for literature reviews (and agent development):

  1. Accurate — Only cite verified papers; never fabricate references
  2. Comprehensive — Cover all major positions and key debates
  3. Rigorous and concise — Analytical depth, tight prose; balanced presentation of positions
  4. Reproducible — Structured workflow, standard BibTeX output, Chicago author-date citations

NOT priorities:

  • ❌ Speed — Quality over fast completion
  • ❌ Context efficiency — Use full context as needed; don't optimize for token savings
  • ❌ Professional-grade legal caution — exacting legal standards fit a real professional product, not this project (see the main objective). On copyright and licensing be very scrappy: never block, narrow or gate a feature for legal exposure only a public professional product would carry. For example, one user's uploaded PDF serves other users' reviews.

Read the full file on GitHub · 196 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago Changed · +37 tokens per session 39effea8325a
  2. 14d ago Changed · +3 lines · +284 tokens per session f8715f479e0e
  3. 15d ago Changed · +1 lines · +209 tokens per session 778621557d1b
  4. 16d ago Changed · +98 tokens per session 494e2ffb7c11
  5. 1mo ago Changed · +261 tokens per session 90be06267cfd
  6. 1mo ago Changed · -10 lines · -71 tokens per session a161cda1fb22
  7. 1mo ago Changed · +10 lines · +328 tokens per session c9acd433ad77
  8. 1mo ago Changed · +6 lines · -1,162 tokens per session 3c56135af437
  9. 1mo ago Changed · +481 tokens per session f3c9737fcca0
  10. 1mo ago First seen · 186 lines · 6,343 tokens per session scan A fa65201cde61

Subscribe to this mod's changes

PhilLit CLAUDE.md is an instructions file published in the GitHub repository AI-4-Phi/PhilLit (45 stars, last pushed 12d ago), licensed Apache-2.0. It adds 6,808 tokens to every session, about $0.0272 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

PhilLit CLAUDE.md compared with instructions from other repositories

PhilLit CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
PhilLit CLAUDE.mdAI-4-Phi/PhilLitInstructions file4512d agoApache-2.0A6,808Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode