agent-rules-kit is a local diagnostic CLI for AI agent instruction files.
It is not a security scanner, provides no security guarantees, and must not be described as making a repository secure.
v0.2.0 is published as a GitHub Release.
Current main contains unreleased post-v0.2.0 fixes intended for a future patch release.
The project is still maintained on a best-effort basis. There is no commercial SLA, no guaranteed response time, and no guarantee that every security-relevant issue will be found or fixed.
| Version | Status |
|---|---|
| 0.2.x | Current GitHub Release line / best-effort security fixes |
| 0.1.x | Historical pre-release line / not supported |
| < 0.1 | Not supported |
This project is not published to PyPI yet. Do not claim PyPI availability until a separate release phase verifies and publishes it.
The project must preserve these boundaries:
- read-only by default;
- no network access in runtime behavior;
- no LLM dependency in runtime behavior;
- no execution of commands from analyzed repositories;
- no unsupported security claims;
- no printing of raw secrets;
- no file modification during
check; - no file modification during
init --dry-run; - file modification only through explicit
init --writeuser intent; - existing root
AGENTS.mdmust be backed up before replacement.
Potential secrets must be redacted before being shown in console, JSON, Markdown, logs, or tests.
Do not commit real secrets, tokens, credentials, cookies, private keys, private URLs, or customer data.
Use fake examples only.
Private vulnerability reporting has been checked and is currently verified as disabled.
Do not claim private vulnerability reporting is enabled.
If a sensitive issue cannot be reported privately through GitHub, do not publish secrets, exploit details, private URLs, customer data, or sensitive repository contents. Open only a minimal public issue requesting a private contact path.
For non-sensitive security boundary issues, open a GitHub issue with a minimal reproduction.
agent-rules-kit does not aim to:
- prove that a repository is secure;
- replace human security review;
- scan dependencies for vulnerabilities;
- validate CI/CD supply chain security;
- execute repository commands to confirm behavior;
- inspect private services, credentials, or infrastructure;
- provide complete secret scanning.
Security response is best-effort for the current 0.2.x GitHub Release line.
There is no commercial SLA or guaranteed response time.
Before any broader public distribution, the maintainer should re-check and document:
- supported versions;
- expected response time;
- disclosure handling;
- whether GitHub Security Advisories or private vulnerability reporting are enabled;
- whether PyPI publication changes the support policy.
Contributors and AI assistants must follow AGENTS.md.
Any change that touches secret detection, redaction, file traversal, write behavior, symlink handling, or command execution boundaries must be treated as security-sensitive and reviewed carefully.
If a change could expose secrets, execute untrusted code, write outside the intended project root, or make exaggerated security claims, stop and escalate before implementation.