What is organon AGENTS.md?

Project instructions for Organon, a Go monorepo, meaning one repository containing several related tools, that builds command-line programs for AI agents.

Use them when working on Organon's source-editing, skill-discovery, token-counting, project-management, or goal-management tools, including formatting, testing, building, and CI.

They give an agent the project's architecture, important commands, package scopes, and development expectations in one place.

How tta-lab/organon configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to tta-lab/organon. 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/tta-lab/organon/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/tta-lab/organon

Made for: Codex, OpenCode.

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/tta-lab/organon/agents-md/github.svg)](https://agentmods.dev/instructions/tta-lab/organon/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/tta-lab/organon/agents-md"><img src="https://agentmods.dev/badge/instructions/tta-lab/organon/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/tta-lab/organon/agents-md"><img src="https://agentmods.dev/badge/instructions/tta-lab/organon/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 2,241 This file is loaded in full into every session.

When invoked 2,241 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.

Model	Per session	Once invoked
Fable 5.1	$0.02241	$0.02241
Opus 5.5	$0.00896	$0.00896
Sonnet 5.5	$0.00448	$0.00448
Haiku 4.5	$0.00224	$0.00224

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

Security

Grade A, and why

organon AGENTS.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 3d 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.

AGENTS.md · 179 lines

How it starts

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

CLAUDE.md

Project Overview

Organon is a Go monorepo producing CLI tools for AI agents: src (tree-sitter source editing), skill (filesystem-based skill discovery), token (LLM token counting), og (project discovery and guarded forge workflows), and goal (Lenos session goal file management).

Essential Commands

make all          # fmt, vet, tidy, build
make test         # CGO_ENABLED=0 go test -v ./...
make build        # CGO_ENABLED=0 go build ./cmd/...
make install      # CGO_ENABLED=0 go install ./cmd/...
make ci           # fmt, vet, lint, test, build
make ci-scope SCOPE_CMD=og SCOPE_PACKAGES='./cmd/og ./internal/og ./internal/project ./internal/config'
                  # scoped format check, vet, lint, test, and binary build

Local Impri

Use /home/neil/code/projects/birdmanmandbir/impri for Impri changes. Its Kubernetes deployment configuration and just impri-* operations are in /home/neil/code/projects/tta-lab/kosmos.

Architecture

Binaries

cmd/src/ — tree-sitter symbol-aware file reading/editing with local path resolution and --json output for Pi extension adapters
cmd/skill/ — filesystem-based skill discovery plus read-only MCP
cmd/token/ — LLM token counting using tiktoken-go with cl100k_base tokenizer (Claude / GPT-4)
cmd/og/ — registered-project discovery, read-only source MCP adapters, and guarded Git, forge, and issue workflows
cmd/goal/ — Lenos session goal file CLI: add/update/append/get/status via $LENOS_GOAL

Shared Packages

internal/id/ — base62 ID generation and collision resolution
internal/tree/ — generic box-drawing tree renderer
internal/indent/ — file indent-style detection (layered: hardcoded table for opinionated languages, per-file majority scan for open languages) and reindent transform
internal/skill/ — filesystem-based skill discovery, frontmatter parsing, and shared CLI/MCP search behavior
internal/token/ — LLM token counting with tiktoken-go; sync.OnceValues lazy init, regex fallback
internal/srcview/ — source outlines and bounded read windows shared by CLI/Pi and og MCP, plus project-contained file access and lexical search for og MCP
internal/truncate/ — Pi-equivalent head truncation (2,000 lines / 50 KB) for CLI JSON output

Read the full file on GitHub · 179 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.

3d ago Changed · +6 lines · +70 tokens per session fa8b4b5ff811
1mo ago Changed · +13 lines · +188 tokens per session 1384641aa05f
1mo ago Changed · +14 tokens per session bf8cc86e5b01
1mo ago Changed · +2 lines · +77 tokens per session 03c2bffc4691
2mo ago Changed · +6 lines · +56 tokens per session 0e2b4b35a634
2mo ago Changed · +37 lines · +545 tokens per session c37b050da6fd
2mo ago First seen · 115 lines · 1,291 tokens per session scan A 15ae2ef0f324

Subscribe to this mod's changes

organon AGENTS.md is an instructions file published in the GitHub repository tta-lab/organon (5 stars, last pushed 4d ago), licensed MIT. It adds 2,241 tokens to every session, about $0.0090 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-31.

dsh-plugin mcp-server pi-extension

organon AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
organon AGENTS.mdtta-lab/organon	Instructions file	5	4d ago	MIT	A	2,241	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

organon: Instructions file for Codex