Borrowing it
Nothing to install: this file belongs to plasma-ai/fractal. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/plasma-ai/fractal/main/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/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.
<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="Reviewed on agentmods" width="80" 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.1 | $0.07082 | $0.07082 |
| Opus 5.5 | $0.02833 | $0.02833 |
| Sonnet 5.5 | $0.01416 | $0.01416 |
| Haiku 4.5 | $0.00708 | $0.00708 |
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 12d 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 — 552 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).
- Choose solutions that generalize. Define the requirement before choosing an approach. Consider alternatives and base each choice on the problem and known constraints. Do not choose an approach for convenience or overfit it to the cases tried during development (Principled Solutions).
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.
- 12d ago Changed · +28 lines · +396 tokens per session 6edff62466b5
- 1mo ago Changed · +32 lines · +407 tokens per session a9ddb66afc09
- 2mo 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 (788 stars, last pushed 2d ago), licensed Apache-2.0. It adds 7,082 tokens to every session, about $0.0283 per session on Opus 5.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.
fractal AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| fractal AGENTS.mdplasma-ai/fractal | Instructions file | 788 | 2d ago | Apache-2.0 | A | 7,082 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |