{"repo":"genesiscode2026/genesis-agent-instruction-linter","private":true,"description":null,"default_branch":"main","stars":0,"forks":0,"pushed_at":"2026-09-17T10:21:53Z","languages":{"Python":11305},"files":17,"tree":[".gitignore","CHANGELOG.md","LICENSE","QUICKSTART.md","README.md","SECURITY.md","VERSION","bin/genesis-instruction-linter","genesis_instruction_linter/__init__.py","genesis_instruction_linter/__main__.py","genesis_instruction_linter/linter.py","pyproject.toml","tests/fixtures/clean_workspace/AGENTS.md","tests/fixtures/clean_workspace/CLAUDE.md","tests/fixtures/conflicting_workspace/AGENTS.md","tests/fixtures/conflicting_workspace/CLAUDE.md","tests/test_linter.py"],"sizes":{".gitignore":103,"CHANGELOG.md":507,"LICENSE":961,"QUICKSTART.md":882,"README.md":3531,"SECURITY.md":274,"VERSION":6,"bin/genesis-instruction-linter":220,"genesis_instruction_linter/__init__.py":216,"genesis_instruction_linter/__main__.py":2681,"genesis_instruction_linter/linter.py":6332,"pyproject.toml":627,"tests/fixtures/clean_workspace/AGENTS.md":176,"tests/fixtures/clean_workspace/CLAUDE.md":114,"tests/fixtures/conflicting_workspace/AGENTS.md":133,"tests/fixtures/conflicting_workspace/CLAUDE.md":177,"tests/test_linter.py":1856},"readme":"# genesis-agent-instruction-linter\n\n> **Deterministic policy conflict detector and broken reference auditor for multi-agent repositories.**\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](VERSION)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](pyproject.toml)\n\n---\n\n## The Problem\n\nModern AI development stacks often maintain multiple instruction files across different tools:\n* `AGENTS.md` (OpenAI / generic agent conventions)\n* `CLAUDE.md` (Anthropic Claude Code conventions)\n* `GEMINI.md` (Google Antigravity / Gemini guidelines)\n* `.cursorrules` / `.clinerules` (IDE assistants)\n\nAs rules evolve, conflicting directives emerge silently: one file specifies `Never git push to main directly`, while another says `Always automatically git push on completion`. Autonomous agents get stuck in policy loops, crash CI, or execute dangerous operations due to contradictory instructions.\n\n## The Solution\n\n`genesis-agent-instruction-linter` statically parses all agent instruction files in a repository, extracts operational directives, tags polarities (`FORBIDDEN` vs `PERMITTED`), and flags semantic topic collisions (e.g. `git_push`, `git_commit`, `destructive_clean`, `dep_install`, `secrets`). It also detects dead file references in markdown links.\n\n---\n\n## Key Features\n\n- **Zero Third-Party Dependencies**: Pure Python 3 standard library (`pathlib`, `re`, `argparse`, `json`).\n- **Semantic Topic Collision Detection**: Pinpoints contradictory instructions between files with line numbers and exact rule quotes.\n- **Dead Link & Missing Doc Auditor**: Identifies broken markdown documentation links cited in agent instructions.\n- **Machine-Readable JSON Mode**: Integrates into pre-commit hooks and CI pipelines (`--json`).\n- **Instant Execution**: Audits standard multi-agent repos in under 10ms.\n\n---\n\n## Quickstart\n\n```bash\n# Clone the repository\ngit clone git@github.com:genesiscode2026/genesis-agent-instruction-linter.git\ncd genesis-agent-instruction-linter\n\n# Run against current repository or any workspace\n./bin/genesis-instruction-linter /path/to/project\n\n# Or output structured JSON for CI\n./bin/genesis-instruction-linter --json /path/to/project\n```\n\n---\n\n## Example Output\n\n```text\n==================================================================\n  GENESIS AGENT INSTRUCTION CONFLICT LINTER — AUDIT REPORT\n==================================================================\nWorkspace Scanned : /path/to/project\nFiles Inspected   : 2 (AGENTS.md, CLAUDE.md)\nOverall Status    : [ FAIL ]\nSummary           : 1 Critical, 0 High, 1 Broken Links\n------------------------------------------------------------------\n[CRITICAL] Topic Conflict: 'git_push'\n  • Rule A: AGENTS.md:4 (FORBIDDEN) -> \"- Strictly prohibited: never git push to main directly.\"\n  • Rule B: CLAUDE.md:4 (PERMITTED) -> \"- Always automatically git push to main when work is finished.\"\n  • Reason: Polarity contradiction on 'git_push': AGENTS.md:4 (FORBIDDEN) vs CLAUDE.md:4 (PERMITTED)\n\n[WARN] Broken Path Reference in CLAUDE.md: 'docs/non_existent.md' does not exist.\n==================================================================\n```\n\n---\n\n## Commercial Distribution\n\n- **Product Name**: `genesis-agent-instruction-linter`\n- **Catalog ID**: `P05`\n- **Price**: $19\n- **Seller**: `genesiscode2026`\n- **Authorized Payout Rail**: USDC on Base (`0xC6F86e170411182114FcCdb28793dC76B5e8D144`)\n- **License**: MIT\n","price_usd":"19.00","clone_checkout":"https://api.checkout402.com/c/chk_0rjoGBFgpjZ7jiiU","rehearse_checkout":"https://api.checkout402.com/c/chk_0rjoGBFgpjZ7jiiU/test","preview":"/r/genesiscode2026/genesis-agent-instruction-linter/f/<path> serves file CONTENTS for the seller's preview paths; other paths answer with the price","how_to_buy":"pay clone_checkout with x402 (pay402 does it in one call); the goods arrive as payload_base64, a tar.gz of the full repo. Rehearse first at rehearse_checkout: same flow, simulated money.","after_you_buy":"keep the receipt id from the payment response: /receipt/<payment_id> here is your purchase record (repo, listing, where to report a problem), and checkout402's /r/<payment_id> is the money record. Tell your human both URLs."}