AGENTS.md@src/tools agentsA
AGENTS.md@src/tools is agent-read markdown (agents) from ginlix-ai/langalpha.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Agent-facing tool docstrings A tool's docstring is not documentation. It is the tool's **prompt description**: the model reads it at call time, before any result exists, and it is the only thing the model knows about the tool. This file is the contract for every agent-facing tool in the repo. | Surface | Lives in | Read by | |---|---|---| | **Direct tools** | `src/tools/`, `src/ptc_agent/agent/tools/` | The model, as a LangChain tool description | | **MCP server tools** | `plugins/*/` | The model (via `tool_summary` and the generated sandbox wrappers) **and** agent-written Python that indexes the result | Envelope shape, published schemas, error arms and lock mechanics for the MCP surface are in `mcp_servers/AGENT_CONTRACT.md`. This file governs the docstring itself, on both surfaces. ## The rule **Every sentence must change a decision the model makes at call time**: whether to call this tool rather than another one, what to pass, or what to do with the result. A sentence that changes none of the three is prompt cost with no return, paid on every turn of every conversation. ## Three sections, three jobs ``` <What the tool is, and when to use it. 1-2 lines.> …
Read the whole file at its exact version.
How to install
mdr add ginlix-ai/langalpha/src/tools/AGENTS.md@git:20260901.8f22df9mdr add ginlix-ai/langalpha/src/tools/AGENTS.md@sha256:7804e6ee540636a7Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_oet5vsx6n6blrbsr)
1 badge views in 30 days
Versions
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (9862 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
ginlix-ai/langalpha · 1,774 stars · license Apache-2.0 · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_oet5vsx6n6blrbsr GET https://markdownregistry.com/api/v1/resolve?ref=ginlix-ai/langalpha/src/tools/AGENTS.md GET https://markdownregistry.com/api/v1/blob/7804e6ee540636a728bcf4fbafed3e351164de8dcc2d84650dfcb750e714423d
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
More from ginlix-ai/langalpha
Every file in ginlix-ai/langalpha