generator CLAUDE.md

A project instruction file for Context Generator, a PHP tool that builds documentation about codebases for use with language models. It records the project overview, commands, testing steps, and code-quality checks for Claude Code.

In plain words
What is it for?
Use it when installing dependencies, generating context files, starting the tool's MCP server, creating configuration schemas, running PHPUnit tests, checking code style, or running static analysis.
Why use it?
It gives the coding agent the project context and the correct commands to use. This reduces guesswork when developing, testing, or checking the repository.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/context-hub/generator/claude-md
Clone the repo
git clone --depth 1 https://github.com/context-hub/generator
Per session 1,585 This file is loaded in full into every session.
When invoked 1,585 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.01585 $0.01585
Opus 5 $0.00792 $0.00792
Sonnet 5 $0.00317 $0.00317
Haiku 4.5 $0.00159 $0.00159

Measured 2d ago against content hash 3e47ef4198fd, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

generator 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 2d 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 · 171 lines

How it starts

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

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is CTX (Context Generator), a PHP 8.3+ tool for generating contextual documentation from codebases for use with LLMs. It allows developers to create structured context files from various sources including local files, Git repositories, GitHub/GitLab repos, web pages, and MCP servers.

Development Commands

Primary Commands

  • composer install - Install dependencies
  • php ctx or ./ctx - Run the context generator (main entry point)
  • php ctx init - Initialize a new context.yaml configuration file
  • php ctx generate - Generate context files from configuration (alias: build, compile)
  • php ctx server - Start the MCP server for Claude AI integration
  • php ctx schema - Generate JSON schema for configuration validation

Development & Testing

  • composer test - Run PHPUnit tests
  • composer test:cc - Run tests with coverage report
  • composer cs-check - Check code style with PHP-CS-Fixer (dry run)
  • composer cs-fix - Fix code style issues
  • composer psalm - Run Psalm static analysis
  • composer psalm:ci - Run Psalm with CI formatting
  • composer refactor - Run Rector for automated refactoring
  • composer refactor:ci - Run Rector in dry-run mode

Build Commands

The project uses Box to create PHAR executables:

  • Build output goes to .build/phar/ctx.phar
  • Configuration in box.json

Architecture Overview

Core Application Structure

  • Spiral Framework: Built on Spiral PHP framework using dependency injection
  • Console Commands: Located in src/Console/ extending BaseCommand
  • Bootloaders: Application services bootstrapped via bootloaders in src/Application/Bootloader/
  • Entry Point: ctx script → app.php → Spiral application kernel

Key Components

Configuration System (src/Config/)
  • YAML-based configuration with JSON schema validation
  • Import system supports importing from URLs and local paths
  • Environment variables supported throughout configuration
  • Modular parsing with plugin system for extensibility

Read the full file on GitHub · 171 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. 2d ago First seen · 171 lines · 1,585 tokens per session scan A 3e47ef4198fd

Subscribe to this mod's changes

generator CLAUDE.md is an instructions file published in the GitHub repository context-hub/generator (341 stars, last pushed 5mo ago), licensed MIT. It adds 1,585 tokens to every session, about $0.0079 per session on Opus 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.