> ## 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/**/*.md`, `.cursor/rules/**/*.mdc`
* **OpenAI Codex**: `AGENTS.md`
* **GitHub Copilot**: `.github/copilot-instructions.md`, `.github/instructions/**/*.md`
* **Windsurf**: `.windsurfrules`, `.windsurf/rules/**/*.md`
* **Roo Code**: `.clinerules`, `.roo/rules/**/*.md`
* **Gemini CLI**: `GEMINI.md`
* **Kiro**: `.kiro/steering/**/*.md`
* **Continue**: `.continuerules`, `.continue/rules/**/*.md`
* **Generic**: `CONVENTIONS.md`, `CONTRIBUTING.md`

## 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