Back to Portfolio

AI Chief-of-Staff Agent

A design exercise in building accountability into operational alerting

Domain Systems Design & Workflow Orchestration
Core Stack Make • Gemini • Slack API • Telegram

Problem Statement

In fast-moving teams, critical issues get buried across Slack, email, and spreadsheets. Most alerting tools notify once and move on — there's no ownership tracking, no forced acknowledgment, and no escalation path if something is ignored. That gap, between notifying a problem and ensuring it gets resolved, is what I wanted to design around.

What I Designed

I designed an autonomous layer that monitors Slack in real time, classifies urgency using an LLM, and tracks every issue through an explicit state machine: Pending → Acknowledged → Escalated; So nothing critical can silently fall through. The intent was to force accountability into the workflow itself, rather than relying on someone remembering to follow up.

The system:

"This is a self-initiated systems-design project, built to practice modeling an operational workflow as a state machine, not a tool with live operator usage."

How It Works (System Design)

I built this on a decoupled architecture, by design, so that a failure in one communication channel (say, Telegram going down) wouldn't take down the rest of the recovery process.

Scenario 1: Intelligent Filtering (Entry Point)

Scenario 1: Intelligent Filtering

Watches Slack in real time and uses Gemini to assess context and sentiment rather than matching keywords. Messages classified as critical get a unique ID and are logged into the state machine.

Scenario 2: Human-in-the-Loop Acknowledgment (Accountability Layer)

Scenario 2: Human-in-the-Loop Acknowledgment

Alerts are dispatched to Telegram. The system waits for a structured reply (Acknowledge [ID]) and, on receipt, updates the record's state from Pending to Acknowledged. This step exists specifically to prevent issues from being silently marked done without a human confirming it.

Scenario 3: Automatic Escalation (Fail-Safe)

Scenario 3: Automatic Escalation

A scheduled background process audits the database on an interval, looking for "ghost incidents", records still Pending past their target SLA. These bypass standard chat entirely and trigger a high priority alert through a separate channel (Pushbullet), so an ignored issue can't just stay quietly unresolved.

Key Design Decisions

What This Demonstrates

Project Artifacts