> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenable.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Context Refinement

> Automated maintenance of coding agent context files

## Overview

Zenable automatically analyzes your repositories to maintain high-quality AI context files aligned with your organization's requirements.

## How It Works

Scans your repository for AI context files, compares content against your configured requirements, and opens a PR with suggested improvements if issues are found.

**Files analyzed include:**

* **Claude Code**: `**/CLAUDE.md`, `**/.claude/rules/**/*.md`
* **Cursor**: `.cursorrules`, `.cursor/rules/**/*.mdc` (repository root only)
* **OpenAI Codex**: `**/AGENTS.md`
* **GitHub Copilot**: `.github/copilot-instructions.md`, `.github/instructions/**/*.md`
* **Devin Desktop**: `**/AGENTS.md`, `**/.devin/rules/**/*.md`
* **Antigravity CLI**: `**/GEMINI.md`
* **Kiro**: `**/.kiro/steering/**/*.md`

### Imported files (`@`-imports)

Context files often pull in another file with an `@path` reference—for example, a `CLAUDE.md` containing `@AGENTS.md`. Zenable resolves these imports and suggests a shared improvement in the file that actually owns the content (the imported file), instead of duplicating it in every file that references it. When the referenced file is itself a recognized context file, it's refined in its own right.

A **root context file** is a recognized context file that is not imported by
another recognized context file. It starts an independent analysis with its
standalone imports included. Each run analyzes at most 12 root context files.

## Enabling Analysis

<Steps>
  <Step title="Navigate to GitHub Repos">
    Go to **Integrations > GitHub > Repos** in [zenable.app](https://www.zenable.app?utm_source=docs\&utm_medium=ai-context-refinement\&utm_content=console)
  </Step>

  <Step title="Select repositories">
    Click on one or more repositories you want to analyze
  </Step>

  <Step title="Open analysis settings">
    Click the **Analysis** button to open the configuration modal
  </Step>

  <Step title="Enable Refine Context">
    Toggle on **Refine Context** to enable AI context file improvements
  </Step>

  <Step title="Schedule analysis">
    Click **Add to Priority Queue** to run in the next nightly window
  </Step>
</Steps>

## When Analysis Runs

Once enabled, analysis runs automatically on a regular schedule.

### Priority Queue

Click **Add to Priority Queue** to request to prioritize your repository for a review.

## Viewing Results

When improvements are found, a PR is created in your repository. Review, modify, or merge as needed.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Analysis hasn't run yet">
    Verify analysis is enabled and the repository is connected via GitHub integration. Use **Add to Priority Queue** if you need it sooner.
  </Accordion>

  <Accordion title="No PR was created">
    Your context files are already well-aligned with your requirements—no improvements needed.
  </Accordion>
</AccordionGroup>

## Next Steps

* Set up [GitHub PR reviews](/integrations/vcs-reviewers/github) for automated code review
* Define [custom policies](/use-cases/policy-as-code) for your organization


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.