The latest articles on DEV Community by koki kanda (@kohli217). https://dev.to/kohli217 https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4135355%2F963fe7dd-9133-4153-89ea-332f6c61a935.png https://dev.to/kohli217 en koki kanda Mon, 21 Sep 2026 09:12:16 +0000 https://dev.to/kohli217/i-built-a-preflight-linter-for-repositories-used-by-multiple-ai-coding-agents-3mfp https://dev.to/kohli217/i-built-a-preflight-linter-for-repositories-used-by-multiple-ai-coding-agents-3mfp <p>When a repository is used with multiple AI coding agents, the instructions can slowly drift apart.</p> <p>You may end up with:</p> <ul> <li> <code>AGENTS.md</code> telling Codex to use one command</li> <li>Copilot instructions using another</li> <li>Cursor rules targeting a different part of the repository</li> <li>package scripts that were renamed but are still referenced by AI instructions</li> </ul> <p>I built <strong>codex-workspace-bootstrap (<code>cwb</code>)</strong> to catch those problems before an AI coding agent starts changing code.</p> <h2> What it checks </h2> <p><code>cwb</code> can detect:</p> <ul> <li>repository readiness issues</li> <li>package-manager mismatches</li> <li>missing <code>package.json</code> scripts</li> <li>conflicting validation commands</li> <li>nested <code>AGENTS.md</code> / <code>AGENTS.override.md</code> </li> <li>nested Cursor rules</li> <li>Copilot path-specific instructions</li> <li>risky filenames tracked by Git</li> </ul> <p>It currently understands instruction/config files used by:</p> <ul> <li>Codex</li> <li>GitHub Copilot</li> <li>Cursor</li> <li>Cline</li> <li>Continue</li> <li>Claude Code</li> <li>Gemini CLI</li> </ul> <h2> Usage </h2> <p>Install:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>pip <span class="nb">install </span>codex-workspace-bootstrap </code></pre> </div> <p>Then run:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>cwb preflight <span class="nb">.</span> </code></pre> </div> <p>The result is one of:</p> <ul> <li><code>READY</code></li> <li><code>NEEDS ATTENTION</code></li> <li><code>BLOCKED</code></li> </ul> <p>For CI:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>cwb preflight <span class="nb">.</span> <span class="nt">--fail-on-integrity</span> </code></pre> </div> <p>There is also a safe fix preview:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>cwb fix <span class="nb">.</span> </code></pre> </div> <p>Existing conflicting instruction files are never automatically rewritten.</p> <h2> Why I made it </h2> <p>AI coding tools are getting better at editing code, but the repository around them still needs to stay consistent.</p> <p>My goal with <code>cwb</code> is not to replace Codex, Copilot, Cursor, Gitleaks, Trivy, or similar tools.</p> <p>It is a preflight layer that runs before them.</p> <p>The checks are local and deterministic. Commands found in AI instruction files are analyzed but not executed.</p> <p>GitHub:</p> <p><a href="https://github.com/kohli217/codex-workspace-bootstrap" rel="noopener noreferrer">https://github.com/kohli217/codex-workspace-bootstrap</a></p> <p>I’m especially interested in false positives, unusual monorepos, and real-world instruction layouts.</p> showdev python opensource ai