Kodiai is a GitHub App that provides AI-powered code reviews, issue triage, mention responses, and knowledge management. This directory contains all project documentation — from system design to operational runbooks.
- Architecture — System design, module map, request lifecycles, data layer, and key abstractions
- Configuration — Complete
.kodiai.ymlreference with all fields, types, defaults, and examples
- Deployment — Azure Container Apps deployment, secrets, scaling, health probes, and common commands
- Graceful Restart Runbook — Zero-downtime deploys with graceful shutdown and webhook queue replay
- Knowledge System — 5-corpus retrieval pipeline (findings, threads, wiki, snippets, issues) with two-stage RRF merge, vector + BM25 search, and background sync
- Issue Intelligence — Automated issue triage, template validation, duplicate detection, Bayesian threshold learning, and troubleshooting retrieval
- Guardrails — Epistemic guardrail pipeline for claim classification, hallucination prevention, and context-grounded response filtering
Troubleshooting and operations guides in runbooks/:
- Mentions Debug — Debug
@kodiai/@claudementions that don't produce replies - Formatter Suggestions — Verify explicit same-PR formatter suggestions through the default
git-clang-formatpath or a repo override - Review Requested Debug — Debug manual re-request flows that don't trigger reviews
- Scale — Handle large PRs, long threads, and timeout issues
- Slack Integration — Deploy and operate Slack integration
- Slack Webhook Relay — Configure and troubleshoot verified webhook-to-Slack relay sources
- xbmc/xbmc Cutover — Cut over xbmc/xbmc from GitHub Actions to the Kodiai GitHub App
- xbmc/xbmc Ops — Day-2 operations for xbmc/xbmc after cutover
Test evidence and verification records in smoke/:
- Phase 27 UAT Notes — Path-instruction testing notes
- Phase 72: Telemetry Follow-Through — Release evidence for OPS-04/OPS-05 telemetry
- Phase 74: Reliability Regression Gate — Pre-release reliability gate for issue write-mode
- Phase 75: Live OPS Verification Closure — Release candidate OPS closure procedure
- Phase 80: Slack Operator Hardening — Slack v1 channel gating and operator verification
- M053 Formatter Suggestions Proof Alignment — M053/S05/R085 alignment note that maps accepted M066 live proof to the milestone closure criteria
- M066 Formatter Suggestions Smoke Proof — Accepted proof record for same-PR formatter suggestions, including the default-command xbmc/xbmc validation
- Slack Webhook Relay — Accepted, suppressed, and failed-delivery smoke path for webhook relay
- xbmc/kodiai Write Flow — End-to-end write-mode smoke test for xbmc/kodiai
- xbmc/xbmc Write Flow — End-to-end write-mode smoke test for xbmc/xbmc