iris-context/docs/dev/README.md

Iris developer & architecture documentation

This directory contains code architecture guides, engine design notes, and development instructions for Iris contributors.

Table of contents

• Development workflow & runner: Environment setup, building, testing, linters, and modular just runner (justfiles/)
• AI engine architecture: Internal AI completion system (internal/ai), providers, prompt design, and debounce strategy
• Scoring & frecency engine: Scoring mechanics (internal/scoring), frecency calculations, context rules, and skeleton extraction
• Overlay & rendering pipeline: PTY overlay positioning, cell width calculation, and terminal rendering
• PTY bridge & keystroke wrapper: Keystroke interception loop, raw mode PTY handling, and IPC scanner
• Spec & completion engine: Static specifications, priority-based flag gating, and Cobra __complete dynamic completion
• File & path generator: File system traversal, extension filtering, and directory slash preservation
• History provider: Shell history indexing, search algorithms, and caching
• Auto updater: Release tracking, version comparison, and atomic binary updates