AI Tuning

Optimize AI assistant configurations. Standards: instructions/ai-tuning.instructions.md

Triggers

Workflow

1. Analyze: Read all existing AI config files in the project

   • CLAUDE.md, AGENTS.md, copilot-instructions.md
   • .claude/rules/*.md, .github/copilot-instructions.md
   • .vscode/mcp.json, .cursor/rules/

2. Identify gaps: Check for:

   • Missing context (tech stack, conventions, tool preferences)
   • Vague instructions ("write good code" vs "use ruff for linting")
   • Outdated commands or patterns
   • Cross-file duplication
   • Misplaced content (subdir file with project-wide rules)

3. Optimize: Apply these principles:

   <optimization_rules>

   • Dense over verbose: Python 3.12 | ruff | pytest not paragraphs
   • Examples over descriptions: code block with ... over "use type annotations"
   • Tables over prose: | Action | Command | for build/test/lint
   • Specific over general: exact commands, exact tool names
   • Hierarchy over flat: root CLAUDE.md (project) > topic rules > subdir rules </optimization_rules>

4. Validate: Every command must be exact and executable in the project

Condensation (CLAUDE.md Deduplication)

Think through deduplication systematically:

Hierarchy: ./CLAUDE.md (project) > ./.claude/rules/*.md (topic) > ./subdir/CLAUDE.md (dir-only)

Before optimization (verbose, vague)

# Project Guidelines

We use Python for our backend. Please make sure to use type hints
when writing Python code. For testing, we prefer pytest. Please run
the linter before committing any code.

After optimization (dense, actionable)

# Stack

Python 3.12 | FastAPI | PostgreSQL | Redis

# Dev Commands

| Task   | Command                |
| ------ | ---------------------- |
| Lint   | `ruff check --fix .`   |
| Format | `ruff format .`        |
| Test   | `pytest -x --tb=short` |
| Types  | `mypy src/`            |

# Conventions

- Type hints on all public functions
- `result: T | None` not `Optional[T]`
- Pydantic models for API schemas

Deduplication example

Found duplication:
  ./CLAUDE.md line 15: "Use ruff for linting"
  ./backend/CLAUDE.md line 3: "Always run ruff before committing"
  ./.claude/rules/python.md line 8: "Lint with ruff check"

Action: Keep in ./CLAUDE.md only (project-wide rule).
Remove from backend/CLAUDE.md and .claude/rules/python.md.