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.
npx agentmods add instructions/plasma-ai/fractal/agents-mdgit clone --depth 1 https://github.com/plasma-ai/fractalWrote 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.
[](https://agentmods.dev/instructions/plasma-ai/fractal/agents-md)<a href="https://agentmods.dev/instructions/plasma-ai/fractal/agents-md"><img src="https://agentmods.dev/badge/instructions/plasma-ai/fractal/agents-md.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.06279 | $0.06279 |
| Opus 5 | $0.03139 | $0.03139 |
| Sonnet 5 | $0.01256 | $0.01256 |
| Haiku 4.5 | $0.00628 | $0.00628 |
Grade A, and why
fractal AGENTS.md scanned grade A with 1 finding 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 4d 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.
Runs shell commandslowCapability
Expected in a hook, worth knowing in a rule or an instructions file.
`subprocess.run()`. The iteration loop is in-process Python: `start.sh` execs How it starts
The opening of the file, as written. The whole thing — 492 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS
This file provides guidance to coding agents (Claude Code, Codex) when working
with code in this repository. If you are not Claude Code (which already reads
parent directories), also check the parent directory for AGENTS.md.
Especially important points to keep in mind (each expanded in its section below):
- Questions are not edit requests. When a message asks a question without explicitly requesting a change, answer and stop (Communication).
- Write clear and concise English. Write clear, concise, plain English which can be quickly and easily parsed by the user - answer questions directly in short form unless elaboration is requested (Writing Style).
- Seek the best solution, not agreement. When you think the user is wrong, don't be afraid to say so — the right answer matters more than the path of least resistance (Pushing Back).
Overview
plasma-fractal is a standalone plugin providing the fractal skill.
The fractal/ package is organized into cli/ (typer app), core/ (business
logic), tui/ (Textual app), impl/ (provider backends), skills/ (the plugin
skill), util/ (shared utilities), and the node machinery seeds — _assets/,
_node/, and _scripts/ — with the pytest suite in tests/.
shim/ holds the metadata-only fractal pointer dist for PyPI: no code, just
an exact plasma-fractal==<version> pin that bumps in lockstep with every
release surface. The build workflow gates and builds it alongside the main
package, and the publish job uploads both dists — both PyPI projects must trust
that workflow (same repository, workflow file, and environment) as their
publisher.
Node delegates lifecycle operations to the _scripts/ shell scripts via
subprocess.run(). The iteration loop is in-process Python: start.sh execs
fractal node _loop inside the tmux session, and Loop
(fractal/core/loop.py) drives each iteration end to end — prompt assembly,
agent launches, run/iter/step row accounting through node.record, and the
work-product commit pipeline in fractal/core/commit.py.
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.
- 4d ago First seen · 492 lines · 6,279 tokens per session scan A bd8325f1f564
fractal AGENTS.md is an instructions file published in the GitHub repository plasma-ai/fractal (710 stars, last pushed 2d ago), licensed Apache-2.0. It adds 6,279 tokens to every session, about $0.0314 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
spec-kit AGENTS.md
AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
next.js AGENTS.md
Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.