# FailBrief

> AI-powered CI/CD failure analysis for GitHub. FailBrief automatically classifies build failures, detects flaky tests, and provides actionable fix suggestions — so your team spends less time debugging pipelines and more time shipping.

FailBrief is a GitHub App that monitors your CI/CD workflows, analyzes failures with AI, and surfaces insights through a dashboard and PR comments.

## Key Features

- **AI Failure Classification**: Automatically categorizes CI/CD failures by error type (test failure, build error, deployment issue, linting) and severity (critical, high, medium, low) with AI-generated fix suggestions.
- **Flaky Test Detection**: Identifies tests that pass and fail intermittently without code changes, with flakiness scores and root cause analysis.
- **PR Comment Analysis**: Posts AI-generated failure analysis directly on your pull requests — impact, root cause, and a suggested fix.
- **Dashboard & Analytics**: Health scores, failure trends, MTTR tracking, error type breakdowns, and repository health comparisons.
- **Integrations**: Slack and Discord notifications for failure alerts and flaky test detection.
- **Team Management**: Multi-user accounts with role-based access (Owner, Admin, Member) and multi-installation support for personal accounts and organizations.

## How It Works

1. Install the FailBrief GitHub App on your repositories.
2. FailBrief monitors your CI/CD workflow runs via GitHub webhooks.
3. When a workflow fails, FailBrief analyzes the logs with AI.
4. Results are posted as PR comments and displayed in the dashboard.
5. Patterns are tracked over time to surface insights and detect flaky tests.

## Plans

- **Free**: 25 monthly analyses, unlimited repos, dashboard access, PR comment analysis.
- **Starter** ($9/mo): 150 monthly analyses, smarter AI classifications, email notifications.
- **Pro** ($29/mo): 500 monthly analyses, advanced AI classifications, Slack & Discord integrations.
- **Business** ($59/mo): 2,000 monthly analyses, best AI classifications, team management.

## Links

- [Install GitHub App](https://github.com/apps/failbrief)
- [Dashboard](https://app.failbrief.com)
- [Pricing](https://app.failbrief.com/pricing)

## Tech Stack

- **Frontend**: React 18, TypeScript, Vite, Tailwind CSS, TanStack Query, Recharts
- **Backend**: .NET, GitHub App webhooks, AI-powered analysis pipeline
- **Payments**: Paddle
- **Auth**: GitHub OAuth