Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 67 additions & 0 deletions agent-context-kit/agents-md-validator/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
<!doctype html>
<html lang="en" data-theme="dark">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1">
<meta name="theme-color" content="#07111f">
<link rel="icon" type="image/png" href="data:image/png;base64,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">
<title>AGENTS.md Validator — ACKit 0.5.4</title>
<meta name="description" content="Validate AGENTS.md and CLAUDE.md instructions; find conflicts, duplicates and scope problems.">
<link rel="canonical" href="https://cynrath.github.io/agent-context-kit/agents-md-validator/">
<link rel="describedby" href="/agent-context-kit/llms.txt">
<meta property="og:type" content="article">
<meta property="og:url" content="https://cynrath.github.io/agent-context-kit/agents-md-validator/">
<meta property="og:title" content="AGENTS.md Validator — AgentContextKit">
<meta property="og:description" content="Validate AGENTS.md and CLAUDE.md instructions; find conflicts, duplicates and scope problems.">
<meta property="og:site_name" content="Cynrath">
<meta name="twitter:card" content="summary">
<script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"AGENTS.md Validator — AgentContextKit","description":"Validate AGENTS.md and CLAUDE.md instructions; find conflicts, duplicates and scope problems.","url":"https://cynrath.github.io/agent-context-kit/agents-md-validator/","isPartOf":{"@type":"WebSite","name":"AgentContextKit Documentation","url":"https://cynrath.github.io/agent-context-kit/"},"about":{"@type":"SoftwareSourceCode","name":"AgentContextKit","codeRepository":"https://github.com/Cynrath/agent-context-kit","programmingLanguage":"TypeScript","softwareVersion":"0.5.4","license":"https://opensource.org/licenses/MIT"}}</script>
<link rel="stylesheet" href="/agent-context-kit/assets/ackit-docs.css">
</head>
<body>
<a class="skip-link" href="#main">Skip to content</a>
<header class="site-header"><div class="shell header-inner">
<a class="brand" href="/agent-context-kit/">ACKit Docs</a>
<nav class="docs-nav" aria-label="ACKit documentation"><a href="/agent-context-kit/">Overview</a>
<a href="/agent-context-kit/getting-started/">Getting Started</a>
<a href="/agent-context-kit/cli/">CLI</a>
<a href="/agent-context-kit/readiness/">Readiness</a>
<a href="/agent-context-kit/optimize/">Optimize</a>
<a href="/agent-context-kit/profiles/">Profiles</a>
<a href="/agent-context-kit/instruction-graph/">Instruction Graph</a>
<a href="/agent-context-kit/rule-packs/">Rule Packs</a>
<a href="/agent-context-kit/workflows/">Workflows</a>
<a href="/agent-context-kit/intent/">Intent</a>
<a href="/agent-context-kit/checkpoints/">Checkpoints</a>
<a href="/agent-context-kit/evidence/">Evidence</a>
<a href="/agent-context-kit/verification/">Verification</a>
<a href="/agent-context-kit/status/">Status</a>
<a href="/agent-context-kit/drift/">Drift</a>
<a href="/agent-context-kit/policy/">Policy</a>
<a href="/agent-context-kit/roles/">Roles</a>
<a href="/agent-context-kit/skills/">Skills</a>
<a href="/agent-context-kit/sync/">Managed Sync</a>
<a href="/agent-context-kit/github-action/">GitHub Action</a>
<a href="/agent-context-kit/mcp/">MCP</a>
<a href="/agent-context-kit/sdk/">SDK</a>
<a href="/agent-context-kit/provider-surfaces/">Provider Surfaces</a>
<a href="/agent-context-kit/trust-flow/">Trust Flow</a>
<a href="/agent-context-kit/dashboard/">Dashboard</a>
<a href="/agent-context-kit/diagnostics/">Diagnostics</a>
<a href="/agent-context-kit/vscode/">VS Code</a>
<a href="/agent-context-kit/security/">Security</a>
<a href="/agent-context-kit/benchmarks/">Benchmarks</a>
<a href="/agent-context-kit/migration/">Migration</a>
<a href="/agent-context-kit/agents-md-validator/" class="active" aria-current="page">AGENTS.md Validator</a>
<a href="/agent-context-kit/ai-agent-readiness/">AI Agent Readiness</a>
<a href="/agent-context-kit/context-optimization/">Context Optimization</a>
<a href="/agent-context-kit/mcp-repository-tools/">MCP Repository Tools</a></nav>
<a class="button button-small" href="https://github.com/Cynrath/agent-context-kit" rel="noopener" target="_blank">GitHub</a>
</div></header>
<main id="main" class="shell docs-main"><article class="docs-article"><h1>AGENTS.md Validator</h1><p>One repository, many agents: <code>AGENTS.md</code> (Codex), <code>CLAUDE.md</code> (Claude Code), <code>GEMINI.md</code> (Gemini) and Copilot instructions plus nested scopes. When files disagree, agents follow stale or contradictory guidance and waste runs.</p><p>ACKit resolves every instruction file into a provider-aware graph with scope, precedence and provenance, then reports conflicts, duplicates, shadowing and dead files — before your agent reads them.</p><pre><code>ackit instructions --explain
ackit optimize --explain</code></pre><pre><code>codex/AGENTS.md → claude/CLAUDE.md (provenance: frontmatter applyTo)</code></pre><p>Try it without installing: <code>npx --yes @cynrath/agent-context-kit@latest readiness</code></p><p><a class="button" href="/agent-context-kit/instruction-graph/">Instruction Graph</a><a class="button" href="/agent-context-kit/optimize/">Optimize</a><a class="button" href="https://github.com/Cynrath/agent-context-kit">GitHub</a><a class="button" href="https://www.npmjs.com/package/@cynrath/agent-context-kit">npm</a></p></article></main>
<footer class="site-footer"><div class="shell footer-inner"><p>AgentContextKit 0.5.4 · offline-first · deterministic · MIT</p><p><a href="https://www.npmjs.com/package/@cynrath/agent-context-kit">npm</a> · <a href="https://github.com/Cynrath/agent-context-kit">GitHub</a> · <a href="https://cynrath.github.io/">Cynrath</a></p></div></footer>
<script src="/agent-context-kit/assets/ackit-docs.js" defer></script>
</body>
</html>
71 changes: 71 additions & 0 deletions agent-context-kit/ai-agent-readiness/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
<!doctype html>
<html lang="en" data-theme="dark">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1">
<meta name="theme-color" content="#07111f">
<link rel="icon" type="image/png" href="data:image/png;base64,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">
<title>AI Agent Readiness — ACKit 0.5.4</title>
<meta name="description" content="Score any repository 0–100 for AI coding-agent readiness with explainable deductions.">
<link rel="canonical" href="https://cynrath.github.io/agent-context-kit/ai-agent-readiness/">
<link rel="describedby" href="/agent-context-kit/llms.txt">
<meta property="og:type" content="article">
<meta property="og:url" content="https://cynrath.github.io/agent-context-kit/ai-agent-readiness/">
<meta property="og:title" content="AI Agent Readiness — AgentContextKit">
<meta property="og:description" content="Score any repository 0–100 for AI coding-agent readiness with explainable deductions.">
<meta property="og:site_name" content="Cynrath">
<meta name="twitter:card" content="summary">
<script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"AI Agent Readiness — AgentContextKit","description":"Score any repository 0–100 for AI coding-agent readiness with explainable deductions.","url":"https://cynrath.github.io/agent-context-kit/ai-agent-readiness/","isPartOf":{"@type":"WebSite","name":"AgentContextKit Documentation","url":"https://cynrath.github.io/agent-context-kit/"},"about":{"@type":"SoftwareSourceCode","name":"AgentContextKit","codeRepository":"https://github.com/Cynrath/agent-context-kit","programmingLanguage":"TypeScript","softwareVersion":"0.5.4","license":"https://opensource.org/licenses/MIT"}}</script>
<link rel="stylesheet" href="/agent-context-kit/assets/ackit-docs.css">
</head>
<body>
<a class="skip-link" href="#main">Skip to content</a>
<header class="site-header"><div class="shell header-inner">
<a class="brand" href="/agent-context-kit/">ACKit Docs</a>
<nav class="docs-nav" aria-label="ACKit documentation"><a href="/agent-context-kit/">Overview</a>
<a href="/agent-context-kit/getting-started/">Getting Started</a>
<a href="/agent-context-kit/cli/">CLI</a>
<a href="/agent-context-kit/readiness/">Readiness</a>
<a href="/agent-context-kit/optimize/">Optimize</a>
<a href="/agent-context-kit/profiles/">Profiles</a>
<a href="/agent-context-kit/instruction-graph/">Instruction Graph</a>
<a href="/agent-context-kit/rule-packs/">Rule Packs</a>
<a href="/agent-context-kit/workflows/">Workflows</a>
<a href="/agent-context-kit/intent/">Intent</a>
<a href="/agent-context-kit/checkpoints/">Checkpoints</a>
<a href="/agent-context-kit/evidence/">Evidence</a>
<a href="/agent-context-kit/verification/">Verification</a>
<a href="/agent-context-kit/status/">Status</a>
<a href="/agent-context-kit/drift/">Drift</a>
<a href="/agent-context-kit/policy/">Policy</a>
<a href="/agent-context-kit/roles/">Roles</a>
<a href="/agent-context-kit/skills/">Skills</a>
<a href="/agent-context-kit/sync/">Managed Sync</a>
<a href="/agent-context-kit/github-action/">GitHub Action</a>
<a href="/agent-context-kit/mcp/">MCP</a>
<a href="/agent-context-kit/sdk/">SDK</a>
<a href="/agent-context-kit/provider-surfaces/">Provider Surfaces</a>
<a href="/agent-context-kit/trust-flow/">Trust Flow</a>
<a href="/agent-context-kit/dashboard/">Dashboard</a>
<a href="/agent-context-kit/diagnostics/">Diagnostics</a>
<a href="/agent-context-kit/vscode/">VS Code</a>
<a href="/agent-context-kit/security/">Security</a>
<a href="/agent-context-kit/benchmarks/">Benchmarks</a>
<a href="/agent-context-kit/migration/">Migration</a>
<a href="/agent-context-kit/agents-md-validator/">AGENTS.md Validator</a>
<a href="/agent-context-kit/ai-agent-readiness/" class="active" aria-current="page">AI Agent Readiness</a>
<a href="/agent-context-kit/context-optimization/">Context Optimization</a>
<a href="/agent-context-kit/mcp-repository-tools/">MCP Repository Tools</a></nav>
<a class="button button-small" href="https://github.com/Cynrath/agent-context-kit" rel="noopener" target="_blank">GitHub</a>
</div></header>
<main id="main" class="shell docs-main"><article class="docs-article"><h1>AI Agent Readiness</h1><p>Is your repository actually ready for Codex, Claude Code, Cursor, Copilot or Gemini — or will the agent burn context on missing instructions, leaked secrets and bloated includes? Guessing costs tokens; measuring is one command.</p><p>ACKit scores instructions, security, context efficiency, task hygiene, skills and policy on a deterministic 0–100 scale with weighted renormalization, strict gates and baselines.</p><pre><code>ackit readiness
ackit readiness --strict
ackit readiness --fail-below 80</code></pre><pre><code>Readiness 89/100 ██████████████████░░ (threshold 0 — pass)
Instructions 90/100
Security 90/100
Context Efficiency 70/100</code></pre><p>Try it without installing: <code>npx --yes @cynrath/agent-context-kit@latest readiness</code></p><p><a class="button" href="/agent-context-kit/readiness/">Readiness</a><a class="button" href="/agent-context-kit/cli/">CLI Reference</a><a class="button" href="https://github.com/Cynrath/agent-context-kit">GitHub</a><a class="button" href="https://www.npmjs.com/package/@cynrath/agent-context-kit">npm</a></p></article></main>
<footer class="site-footer"><div class="shell footer-inner"><p>AgentContextKit 0.5.4 · offline-first · deterministic · MIT</p><p><a href="https://www.npmjs.com/package/@cynrath/agent-context-kit">npm</a> · <a href="https://github.com/Cynrath/agent-context-kit">GitHub</a> · <a href="https://cynrath.github.io/">Cynrath</a></p></div></footer>
<script src="/agent-context-kit/assets/ackit-docs.js" defer></script>
</body>
</html>
Loading
Loading