sign-tools AGENTS.md

Repository instructions for Sign Tools, a collection of independently maintained tools and shared code for the SIGN-LANG project. A monorepo is one repository that contains multiple related projects.

In plain words
What is it for?
Orienting an agent in the repository, onboarding a new tool, following shared coding policies and adding tool-specific tests and documentation.
Why use it?
They show contributors where to find the project’s rules and how to add a new tool consistently while keeping its tests and documentation separate.

Instructions file for CodexOpenCode

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/sign-protocol/sign-tools/agents-md
Clone the repo
git clone --depth 1 https://github.com/sign-protocol/sign-tools

Made for: Codex, OpenCode.

Per session 686 This file is loaded in full into every session.
When invoked 686 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.

ModelPer sessionOnce invoked
Fable 5 $0.00686 $0.00686
Opus 5 $0.00343 $0.00343
Sonnet 5 $0.00137 $0.00137
Haiku 4.5 $0.00069 $0.00069

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

Security

Grade A, and why

sign-tools 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 2d 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 · 73 lines

How it starts

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

AGENTS.md — Sign Tools Toolbox

This repository is a monorepo for tools supporting the SIGN-LANG project. It uses an agentic development operating system to enable AI-assisted implementation while maintaining human control over strategy and risk.

Repository Purpose

Sign Tools is a curated collection of reference implementations for the SIGN-LANG ecosystem:

  • Document converters (sign-ingest)
  • Utilities and integrations (TBD)
  • Shared code and schemas

Each tool is independently versioned, tested, and documented but shares repo-wide coordination.

Start Here

Read these files in order:

  1. README.md - Repository overview
  2. .agent/SOUL.md - Engineering posture
  3. .agent/policies/approvals.md - Approval boundaries
  4. .agent/policies/agent-coding-standards.md - Code standards
  5. .agent/operating-system/README.md - Operating system
  6. .agent/operating-system/product/README.md - Current mission

Tool Onboarding

For tool authors adding a new tool to the toolbox:

  1. Create packages/<tool-name>/ directory
  2. Create tool-specific README and SPECIFICATION
  3. Follow repo-wide coding standards
  4. Implement tool-specific tests and validation
  5. Document in root README.md

For contributors to existing tools:

  1. Find the tool in packages/
  2. Follow its README and SPECIFICATION
  3. Refer to repo-wide policies for standards and approvals
  4. Create tool-specific plans if needed in .agent/operating-system/plans/

Core Workflow

  1. Understand the request, constraints, and risk tier
  2. Check .agent/operating-system/product/README.md for repo intent
  3. Create or update a plan in .agent/operating-system/plans/ for material work
  4. Request approval before any approval-boundary action
  5. Implement in small, verifiable increments
  6. Keep decisions and documentation synchronized with implementation
  7. Store durable evidence when work benefits from traceability

Mandatory Artifacts

  • ADRs live in .agent/operating-system/decisions/
  • Plans live in .agent/operating-system/plans/active, backlog, or historical
  • Durable repo-wide standards live under .agent/policies/
  • Tool-specific decisions go in packages/<tool>/decisions/ (optional)

Read the full file on GitHub · 73 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. 2d ago First seen · 73 lines · 686 tokens per session scan A e53e485c1003

Subscribe to this mod's changes

sign-tools AGENTS.md is an instructions file published in the GitHub repository sign-protocol/sign-tools (10 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 686 tokens to every session, about $0.0034 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.

Related

Other instructions, from other repositories

m_flow AGENTS.md

AGENTS.md instructions for FlowElement-xinliuyuansu/m_flow, covering m-flow — developer & agent reference, 1. repository map, extension points, 2. local development and python backend (requires python 3.10 – 3.13).

FlowElement-xinliuyuansu/m_flow · 1,075 tokens

open-ontologies CLAUDE.md

Instructions for fabio-rovai/open-ontologies, covering open ontologies, ontology engineering workflow, generate, validate and load and reason.

fabio-rovai/open-ontologies · 5,098 tokens

engraphis CLAUDE.md

Instructions for Coding-Dev-Tools/engraphis, covering claude.md, the one rule that prevents most mistakes, before you say "done" — run the canonical gate, slash commands available here and working style in this repo.

Coding-Dev-Tools/engraphis · 1,082 tokens

kglite CLAUDE.md

Instructions for kkollsga/kglite, covering kglite — claude code conventions, build & test, architecture, the boundary principle (wrappers vs core) — summary and in-memory is the core product.

kkollsga/kglite · 12,909 tokens

tpu_performance_autoresearch_wiki GEMINI.md

Instructions for vlasenkoalexey/tpu_performance_autoresearch_wiki, covering gemini/antigravity operating rules, platform adaptation (claude code → gemini/antigravity), 1. skills — native, no emulation, 2. never-stop hook & retrospectives and 3. session and transcript resolution.

vlasenkoalexey/tpu_performance_autoresearch_wiki · 986 tokens

tpu_performance_autoresearch_wiki AGENTS.md

Instructions for vlasenkoalexey/tpu_performance_autoresearch_wiki, covering codex instructions, compatibility, operating rules and codex translation notes.

vlasenkoalexey/tpu_performance_autoresearch_wiki · 436 tokens