agentlocks AGENTS.md

A repository instruction file for Agentlocks, a standalone command-line tool for advisory locking that coordinates work between agents. It sets product maturity, commit, branch, dependency, and default-behavior rules.

In plain words
What is it for?
Use it when changing the Bun/TypeScript codebase, deciding whether to add defaults or compatibility layers, coordinating shared worktrees, and running checks before commits.
Why use it?
It tells contributors which compatibility behavior is intentionally out of scope and how changes must be checked and committed. This reduces accidental legacy support and untested changes.

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

Made for: Codex, OpenCode.

Per session 1,031 This file is loaded in full into every session.
When invoked 1,031 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.01031 $0.01031
Opus 5 $0.00515 $0.00515
Sonnet 5 $0.00206 $0.00206
Haiku 4.5 $0.00103 $0.00103

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

Security

Grade A, and why

agentlocks 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 · 100 lines

How it starts

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

Repository instructions for agents

Agentlocks is a standalone advisory locking CLI (Bun/TypeScript dev stack, shipped as one Node bundle — a CLI, not a library). Keep defaults generic: do not add prompt-optimization behavior, command aliases, or repository-specific defaults.

Product maturity policy

Agentlocks is not live yet. Do not add compatibility layers, migration paths, deprecated aliases, or fallback behavior for previous internal layouts, schemas, CLI flags, actor outputs, or report formats. When a contract changes, update the implementation, tests, docs, skill instructions, and wiki in place to the new contract.

Commit policy

Make a commit every time a chunk of logic is implemented and unit tested. Do this whether you are working on a branch or inside a worktree: each passing unit-tested chunk gets its own commit before moving on to the next.

Branch and merge policy

Prefer trunk-based development: commit straight to main. agentlocks exists so multiple agents can share one worktree without clobbering, so branching for isolation is usually unnecessary. Coordinate with file locks, run bun run check before each commit, and push small green commits to main (see Commit policy). No branch means no merge, so no history is ever collapsed or lost.

Branch only when a change must be gated before it reaches main (risky or large work needing CI or review first), is a throwaway experiment, or comes from an outside contributor.

When you do merge a branch, preserve every commit. Never squash.

  • git merge --no-ff <branch> keeps every commit and the branch topology. Simplest, always safe.
  • Or rebase the branch onto main and fast-forward for a linear history that still keeps every commit; use this only when each branch commit is green.
  • Keep main bisect-safe: every commit, branch or not, must build and pass on its own (the Commit policy guarantees this, which is what makes preserving all commits safe).
  • Durable narrative (decisions, rejected approaches, lessons) lives in CHANGELOG.md and the task ledger, not commit history.
  • Delete the branch after merge; its commits already live on main.

Read the full file on GitHub · 100 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 · 100 lines · 1,031 tokens per session scan A 1b43cdca5dbb

Subscribe to this mod's changes

agentlocks AGENTS.md is an instructions file published in the GitHub repository simke9445/agentlocks (11 stars, last pushed 9d ago), licensed MIT. It adds 1,031 tokens to every session, about $0.0052 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-30.