cli: Instructions file for Claude Code

AGENTS.md

cli AGENTS.md is an instructions file for Claude Code, Codex, OpenCode from archcore-ai/cli. It costs 3,615 tokens per session, scanned A, original, Apache-2.0.

A set of repository instructions for the Archcore CLI, MCP server, host integrations and document templates. It defines how technical documentation should identify subjects, constraints and required actions.

In plain words
What is it for?
It is for work on repository instructions, README files, documentation, templates and Markdown embedded in source code.
Why use it?
It helps people and coding agents understand project rules without guessing, while directing them to the central documentation policy.

Instructions file for Claude CodeCodexOpenCode

Written for Claude Code and Codex and OpenCode: SessionStart hook event, but also the file is AGENTS.md. Also seen: mentions CLAUDE.md; mentions Claude Code; mentions Codex.

This is archcore-ai/cli's own configuration. It tells Claude Code, Codex and OpenCode how to work on cli itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything cli configures →

Reuse

Borrowing it

Nothing to install: this file belongs to archcore-ai/cli. 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/archcore-ai/cli/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/archcore-ai/cli

Made for: Claude Code, 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.

agentmods badge for cli AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/archcore-ai/cli/agents-md/github.svg)](https://agentmods.dev/instructions/archcore-ai/cli/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/archcore-ai/cli/agents-md"><img src="https://agentmods.dev/badge/instructions/archcore-ai/cli/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.

agentmods 80×15 button for cli AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/archcore-ai/cli/agents-md"><img src="https://agentmods.dev/badge/instructions/archcore-ai/cli/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 3,615 This file is loaded in full into every session.
When invoked 3,615 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.03615 $0.03615
Opus 5.5 $0.01446 $0.01446
Sonnet 5.5 $0.00723 $0.00723
Haiku 4.5 $0.00362 $0.00362

Measured 1mo ago against content hash 17d567198df1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cli 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 1mo 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 · 378 lines

How it starts

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

Repository Agent Instructions

Archcore — project context for this repo

This repo's architecture, decisions, rules, specs and patterns live in .archcore/, reachable through the Archcore MCP tools. Consult them even on code you think you know — a decision or rule may already constrain it.

  • Touching this repo's real code or behavior → search first; read only what matches.
  • A decision was made ("we'll use X", "from now on Y") → record it.
  • A module / API / system has no doc — or a search comes back empty → capture it.
  • Planning a feature or refactor → scope it against what's already decided.

A .archcore/ may also mount read-only global sources — shared, org-wide context not shown in the session-start list. list_documents / search_documents surface them alongside local docs, tagged source_kind: "global". When present, treat them as defaults a local doc can override — never edit or relate to one.

The search is cheap — lean on it. Skip it only for turns this repo would have no opinion on: syntax trivia, throwaway snippets, pure mechanics.

Archcore + Serena

Applies when the session lists any Serena tool, including a deferred tool that shows only its name.

Session start:

  1. Before the first code read, search Archcore for accepted decisions, specifications, and rules on the affected area.
  2. Treat accepted Archcore records as constraints on the change.
  3. If an accepted Archcore record conflicts with the request, report the conflict to the user.
  4. Make no code edit until the user resolves the Archcore conflict.
  5. If the host shows Serena tools by name only, load their schemas through tool search before the first code read.
  6. Before the first code read, call Serena initial_instructions once per session.
  7. If no Serena project is active, call activate_project for the current repository.

Tool choice:

  1. To find where a symbol is used, call find_referencing_symbols instead of text search.
  2. To find where a symbol is defined, call find_symbol instead of text search.
  3. To inspect a code file, call get_symbols_overview before reading the whole file.
  4. To read one symbol, call find_symbol with include_body.
  5. To rename a symbol, call rename_symbol.
  6. To delete a symbol, call safe_delete_symbol when the toolset has it.
  7. To find a string, JSON key, configuration key, path, or prose phrase, use text search.
  8. To find a project decision, call Archcore search_documents instead of reading Serena memory.

Read the full file on GitHub · 378 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. 1mo ago Changed · +54 lines · +730 tokens per session 17d567198df1
  2. 1mo ago Changed · +18 lines · +201 tokens per session 16301706eb60
  3. 1mo ago First seen · 306 lines · 2,684 tokens per session scan A e563a15642fa

Subscribe to this mod's changes

cli AGENTS.md is an instructions file published in the GitHub repository archcore-ai/cli (66 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 3,615 tokens to every session, about $0.0145 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-30.

Related

Other instructions, from other repositories