How Do I Read .brass/ai_instructions.yaml?

The Structure of ai_instructions.yaml

BrassCoders writes ai_instructions.yaml as a ranked list of findings — each entry has a title, severity level (CRITICAL / HIGH / MEDIUM / LOW), confidence score, the exact file path and line number, the scanner that found it, and a one-sentence description written for an AI reviewer.

After brasscoders scan ., open .brass/ai_instructions.yaml. The file is plain YAML (https://yaml.org/spec/1.2.2/) — readable in any text editor, parseable by any YAML library.

Findings appear in severity order: CRITICAL findings first, then HIGH, MEDIUM, LOW. Within each severity band, findings are ranked by confidence. The top of the file is where the real bugs cluster.

The OSS core applies heuristic deduplication, so a typical 1,500+ raw finding scan produces a few hundred entries in ai_instructions.yaml. The Paid plan ($12/dev/mo) adds semantic deduplication that reduces that to roughly 30 actionable entries.

How to Use It With Claude Code or Cursor

BrassCoders formats ai_instructions.yaml for direct paste into Claude Code (https://docs.anthropic.com/en/docs/claude-code) or Cursor — the AI assistant reads the ranked finding list and triages each one against the actual source file, providing a source-verified verdict and fix.

The intended workflow:

1. Run brasscoders scan .
2. Open Claude Code or Cursor in your project directory
3. Paste the contents of .brass/ai_instructions.yaml into the conversation
4. Ask: "Triage these findings and identify which are real bugs"

Claude Code or Cursor reads the file paths and line numbers, opens the referenced source files, and evaluates each finding in context. It distinguishes real bugs from false positives, explains why each finding matters, and proposes a fix. This is the intended division of labor: BrassCoders provides the structured, deterministic finding list; the AI assistant provides the context-aware triage.

The .brass/ directory is regenerated on every scan — add it to .gitignore if you don't want to commit scan output to version control.

Install BrassCoders with pip install brasscoders and run brasscoders scan . from your project root. The OSS core is free and Apache 2.0 licensed. BrassCoders Paid adds semantic noise reduction for $12/dev/month.