{"id":50150670,"url":"https://github.com/yooh-an/agent-rules-auditor","last_synced_at":"2026-05-24T08:02:24.254Z","repository":{"id":359901826,"uuid":"1247944068","full_name":"Yooh-an/agent-rules-auditor","owner":"Yooh-an","description":"Audit AI agent instruction files; optional $20 setup PR for CI safety gate.","archived":false,"fork":false,"pushed_at":"2026-05-24T03:19:05.000Z","size":46,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T03:25:28.354Z","etag":null,"topics":["agent-instructions","agent-safety","ai-agents","claude-code","codex","cursor","cursor-ai","developer-tools","github-actions","security-tools"],"latest_commit_sha":null,"homepage":"https://yooh-an.github.io/agent-rules-auditor/offer.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yooh-an.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://yooh-an.github.io/agent-rules-auditor/offer.html","https://github.com/Yooh-an/agent-rules-auditor/issues/1"]}},"created_at":"2026-05-24T01:40:51.000Z","updated_at":"2026-05-24T03:23:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Yooh-an/agent-rules-auditor","commit_stats":null,"previous_names":["yooh-an/agent-rules-auditor"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Yooh-an/agent-rules-auditor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yooh-an%2Fagent-rules-auditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yooh-an%2Fagent-rules-auditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yooh-an%2Fagent-rules-auditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yooh-an%2Fagent-rules-auditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yooh-an","download_url":"https://codeload.github.com/Yooh-an/agent-rules-auditor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yooh-an%2Fagent-rules-auditor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33426013,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-instructions","agent-safety","ai-agents","claude-code","codex","cursor","cursor-ai","developer-tools","github-actions","security-tools"],"created_at":"2026-05-24T08:02:23.381Z","updated_at":"2026-05-24T08:02:24.247Z","avatar_url":"https://github.com/Yooh-an.png","language":"Python","funding_links":["https://yooh-an.github.io/agent-rules-auditor/offer.html","https://github.com/Yooh-an/agent-rules-auditor/issues/1","https://www.paypal.com/ncp/payment/NHM88M3F6BMFW"],"categories":[],"sub_categories":[],"readme":"# Agent Rules Auditor\n\nAudit AI coding-agent instruction files for risky or ambiguous rules.\n\nThis is a small open-source CLI for teams using Codex, Claude Code, Cursor, Gemini CLI, or other coding agents with repo-local instruction files.\n\nPublic repo: \u003chttps://github.com/Yooh-an/agent-rules-auditor\u003e\n\nLanding page: \u003chttps://yooh-an.github.io/agent-rules-auditor/offer.html\u003e\n\nRelease: \u003chttps://github.com/Yooh-an/agent-rules-auditor/releases/tag/v0.1.3\u003e\n\nBuy the `$20` Pro Pack with PayPal: \u003chttps://www.paypal.com/ncp/payment/NHM88M3F6BMFW\u003e\n\nAfter payment, request delivery or a setup PR: \u003chttps://github.com/Yooh-an/agent-rules-auditor/issues/1\u003e\n\nRequest a free public repo scan: \u003chttps://yooh-an.github.io/agent-rules-auditor/free-scan.html\u003e\n\nAnnouncement and setup PR scope: \u003chttps://github.com/Yooh-an/agent-rules-auditor/discussions/3\u003e\n\nAsk questions about the Pro Pack: \u003chttps://github.com/Yooh-an/agent-rules-auditor/discussions/2\u003e\n\nPreview the paid bundle contents: [`PRO_PACK_PREVIEW.md`](PRO_PACK_PREVIEW.md)\n\nUse the free GitHub Action: \u003chttps://yooh-an.github.io/agent-rules-auditor/github-action.html\u003e\n\nSee the setup PR demo: [`examples/setup-pr-demo/`](examples/setup-pr-demo/)\n\nLive setup PR demo: \u003chttps://github.com/Yooh-an/agent-rules-auditor-demo-target/pull/1\u003e\n\nSetup PR option: \u003chttps://yooh-an.github.io/agent-rules-auditor/setup-pr.html\u003e\n\nBuyer FAQ: \u003chttps://yooh-an.github.io/agent-rules-auditor/faq.html\u003e\n\nDelivery manifest: \u003chttps://yooh-an.github.io/agent-rules-auditor/delivery.html\u003e\n\nPublic scan index with example findings from postgis, bpftrace, FastLED, and\nother public instruction files:\n\u003chttps://yooh-an.github.io/agent-rules-auditor/scan-examples.html\u003e\n\nKeyword landing pages:\n\n- AGENTS.md audit: \u003chttps://yooh-an.github.io/agent-rules-auditor/agents-md-audit.html\u003e\n- Cursor rules audit: \u003chttps://yooh-an.github.io/agent-rules-auditor/cursor-rules-audit.html\u003e\n- Claude Code instructions audit: \u003chttps://yooh-an.github.io/agent-rules-auditor/claude-code-instructions-audit.html\u003e\n\nIt scans:\n\n- `AGENTS.md`\n- `CLAUDE.md`\n- `GEMINI.md`\n- `RULES.md`\n- `.cursorrules`\n- `.cursor/rules/*.md`\n- `.cursor/rules/*.mdc`\n\nInstruction file names are matched case-insensitively, so `AGENTS.MD` and\n`Agents.md` are scanned too.\n\nIt flags risky patterns such as:\n\n- destructive commands without approval language\n- force-push instructions\n- secret exposure instructions\n- remote-code execution patterns\n- privileged commands\n- attempts to override higher-priority instructions\n- vague \"fix everything\" scope\n\n## 30 Second Demo\n\nRun the included unsafe sample:\n\n```bash\nPYTHONPATH=src python3 -m agent_rules_auditor.cli examples/unsafe/AGENTS.md --fail-on none\n```\n\nYou should see findings for destructive commands, secret exposure, remote\nexecution, instruction override language, and vague scope.\n\nThe `examples/` directory is skipped during whole-repo audits so the demo file\ndoes not make this repository fail its own check.\n\n## Install\n\nFrom this directory:\n\n```bash\npython3 -m pip install .\n```\n\nInstall directly from GitHub:\n\n```bash\npython3 -m pip install \"git+https://github.com/Yooh-an/agent-rules-auditor.git\"\n```\n\nInstall the current release:\n\n```bash\npython3 -m pip install \"git+https://github.com/Yooh-an/agent-rules-auditor.git@v0.1.3\"\n```\n\nFor local development without installation:\n\n```bash\nPYTHONPATH=src python3 -m agent_rules_auditor.cli .\n```\n\n## Usage\n\nAudit the current repo:\n\n```bash\nagent-rules-audit .\n```\n\nReturn JSON:\n\n```bash\nagent-rules-audit . --json\n```\n\nFail CI on warnings:\n\n```bash\nagent-rules-audit . --fail-on warn\n```\n\nDisable failing:\n\n```bash\nagent-rules-audit . --fail-on none\n```\n\n## GitHub Action\n\nUse the free action in pull requests:\n\n```yaml\nname: Agent Rules Audit\n\non:\n  pull_request:\n\njobs:\n  audit-agent-rules:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: Yooh-an/agent-rules-auditor-action@v0.1.3\n        with:\n          fail-on: warn\n```\n\nSee \u003chttps://yooh-an.github.io/agent-rules-auditor/github-action.html\u003e for inputs and setup notes.\n\n## Example Output\n\n```text\nAgent instruction audit: 1 finding(s)\nerrors=1 warnings=0 info=0\n\nERROR AGENTS.md:12 [destructive-command]\n  Instruction mentions a destructive command.\n  Excerpt: Run git reset --hard when tests fail.\n  Fix: Require explicit user approval and a narrow path or target before destructive actions.\n```\n\n## Open Source Core\n\nThe CLI is MIT licensed.\n\nThe paid product is the `$20 Agent Rules Pro Pack`: a setup bundle for teams that want to add this to a repo quickly without writing policy and CI files from scratch.\n\nFor public GitHub repositories, the `$20` purchase can also include a setup PR\nthat adds the workflow, starter policy, Cursor rule, and PR checklist directly\nto the buyer's repo.\n\nThe Pro Pack includes:\n\n- strict `AGENTS.md` template\n- dry-run-first setup script\n- Cursor `.mdc` safety rule\n- GitHub Actions workflow\n- PR checklist text\n- reviewer prompt for risky agent-rule diffs\n- setup PR for public GitHub repos\n- team rollout checklist\n- sample audit report\n- buyer onboarding email\n\nSee `PRO_PACK.md` for the sales page copy and delivery promise.\n\nUse the free GitHub Action:\n\u003chttps://yooh-an.github.io/agent-rules-auditor/github-action.html\u003e\n\nSee `examples/setup-pr-demo/` for the concrete PR files a buyer can expect\nwhen they request the public-repo setup PR option.\n\nSee the live setup PR demo:\n\u003chttps://github.com/Yooh-an/agent-rules-auditor-demo-target/pull/1\u003e\n\nSee the setup PR option page:\n\u003chttps://yooh-an.github.io/agent-rules-auditor/setup-pr.html\u003e\n\nBuy the `$20` Pro Pack with PayPal:\n\u003chttps://www.paypal.com/ncp/payment/NHM88M3F6BMFW\u003e\n\nThe GitHub Sponsor button is configured through `.github/FUNDING.yml` to point\nto the same purchase and setup PR links.\n\nAfter payment, open the purchase thread to request delivery or a setup PR:\n\u003chttps://github.com/Yooh-an/agent-rules-auditor/issues/1\u003e\n\nFor GitHub Action setup PR requests, you can also use:\n\u003chttps://github.com/Yooh-an/agent-rules-auditor-action/issues/1\u003e\n\nSee the announcement for the setup PR scope:\n\u003chttps://github.com/Yooh-an/agent-rules-auditor/discussions/3\u003e\n\nUse the Q\u0026A discussion for pre-purchase questions:\n\u003chttps://github.com/Yooh-an/agent-rules-auditor/discussions/2\u003e\n\nRequest a free scan for a public repository:\n\u003chttps://yooh-an.github.io/agent-rules-auditor/free-scan.html\u003e\n\nSee `PURCHASE.md` for the structured purchase request form and delivery notes.\n\nSee `BUYER_FAQ.md` for what is included, how delivery works, and when not to\nbuy the pack.\n\nSee `DELIVERY_MANIFEST.md` for the current paid ZIP hash, included files, and\nsetup-script verification notes.\n\nSee `PUBLIC_SCAN_EXAMPLES.md` for concrete findings from public AGENTS.md and\nCursor rule files.\n\nUse `checkout-setup.md` if you need to replace the PayPal link with another\ncheckout provider.\n\n## Support And Contributing\n\n- [`SUPPORT.md`](SUPPORT.md) explains where to file CLI bugs and paid delivery requests.\n- [`CONTRIBUTING.md`](CONTRIBUTING.md) covers local development and pull requests.\n- [`SECURITY.md`](SECURITY.md) defines the safe reporting scope.\n- [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) defines basic project behavior.\n\n## Run Tests\n\n```bash\nPYTHONPATH=src python3 -m unittest discover -s tests\n```\n\nIf macOS Python cannot write bytecode caches:\n\n```bash\nPYTHONPYCACHEPREFIX=/private/tmp/agent-rules-pycache python3 -m compileall src tests\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyooh-an%2Fagent-rules-auditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyooh-an%2Fagent-rules-auditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyooh-an%2Fagent-rules-auditor/lists"}