What is kodama AGENTS.md?

Repository guidance for Kodama, a pack of specialised AI-agent configurations and reusable workflow instructions. It explains the agent roster, file layout, conventions, and installation lifecycle.

Adding or updating agents and skills, customising the pack for a project, and maintaining its setup and uninstall process.

It helps agents preserve the pack’s naming, architecture, tracked-file, backup, and installation rules when making changes.

kodama AGENTS.md — Instructions file for Codex and OpenCode by amergrgic: Repository guidance for Kodama, a pack of specialised AI-agent…

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/amergrgic/kodama/agents-md

Clone the repo

git clone --depth 1 https://github.com/amergrgic/kodama

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/amergrgic/kodama/agents-md.svg)](https://agentmods.dev/instructions/amergrgic/kodama/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/amergrgic/kodama/agents-md"><img src="https://agentmods.dev/badge/instructions/amergrgic/kodama/agents-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 536 This file is loaded in full into every session.

When invoked 536 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.

Model	Per session	Once invoked
Fable 5	$0.00536	$0.00536
Opus 5	$0.00268	$0.00268
Sonnet 5	$0.00107	$0.00107
Haiku 4.5	$0.00054	$0.00054

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

Security

Grade A, and why

kodama 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 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.

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 · 50 lines

How it starts

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

Agents

This is the kodama agent pack repository. Kodama is the entrypoint; the kodama- prefixed agents are specialists it delegates to.

Architecture

agents/ — self-contained Kiro JSON configs with inline prompts. Each file's name field must match its filename stem.
skills/ — reusable workflow playbooks (Markdown with YAML frontmatter). Referenced by agents via skill:// resource URIs.
setup.sh — lifecycle manager: validates, stages, backs up, installs, and uninstalls. All installed files are tracked in a manifest with SHA-256 hashes.
examples/project-customization/ — shows end users how to extend the pack per-repo.

Agent roster

Agent	Delegates to	Purpose
kodama	all specialists	Plans, delegates, reconciles, verifies
kodama-scout	—	Read-only codebase reconnaissance
kodama-scholar	—	External docs and API research
kodama-sage	—	Architecture, debugging, tradeoffs
kodama-artist	—	UI, UX, accessibility implementation
kodama-smith	—	Bounded implementation and tests
kodama-critic	—	Independent diff review
kodama-forge	—	Infrastructure, CI/CD, deployment
kodama-scribe	—	Documentation and technical writing

Conventions

Agents use model: "auto" — no provider lock-in.
allowedTools must be a subset of tools. Tools outside allowedTools require user approval.
Resource paths use __KODAMA_SKILLS_DIR__ as a placeholder; the installer resolves it at install time.
Skills use YAML frontmatter with name (must match directory) and description.
The pack never modifies files outside its own manifest (no global MCP, no other agents).

Validation

Run before committing:

./scripts/validate.sh

Checks: installer lifecycle, project-customization tests, shell syntax, agent JSON schema, and skill metadata.

Adding an agent

Create agents/<name>.json with name, description, prompt, model, tools, allowedTools, and resources.
Add the name to AGENT_NAMES in setup.sh.
Reference any skills via skill://__KODAMA_SKILLS_DIR__/<skill>/SKILL.md.
Run ./scripts/validate.sh.

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

4d ago First seen · 50 lines · 536 tokens per session scan A a89659a48841

Subscribe to this mod's changes

kodama AGENTS.md is an instructions file published in the GitHub repository amergrgic/kodama (6 stars, last pushed 25d ago), licensed MIT. It adds 536 tokens to every session, about $0.0027 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-31.

agent agent-skill agent-skills agentic agents kiro

akidevrule GEMINI.md

Instructions for lacvietanh/akidevrule, covering gemini.md — ag rules bootstrap, 1. single source of truth and 2. separation of concerns.

lacvietanh/akidevrule · 311 tokens

growmos AGENTS.md

Instructions for codician-team/growmos: This repository keeps a knowledge graph in .growmos/ (entities, typed relations, provenance, profiles, a journal). It is the shared world model that survives context windows. Treat it as memory you read at the start of work and write to as you develop. Zero-config commands.

codician-team/growmos · 606 tokens

kodama AGENTS.md