> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Guide

> Complete guide to using Hitler — the accountability bot for Inagiffy's content marketing team

# How Hitler Works

Hitler is a **Slack-first accountability bot** built for Inagiffy's content marketing team. The bot is the primary interface — you talk to it in Slack, and it handles task tracking, KPI scoring, reports, and accountability enforcement automatically. The web dashboard exists for managers/admins to configure settings and view reports.

## The Daily Cycle

Here's what a typical day looks like with Hitler running:

```
9:00 AM   Morning thread posted to team channel
          → Everyone replies with their tasks for the day

11:00 AM  Submission deadline
          → Users who didn't submit get a DM reminder

11:30 AM  Classification digest
          → Bot posts task classification summary to ops channel

5:00 PM   EOD nudge
          → Bot posts a reminder to update task statuses

7:00 PM   EOD collection
          → Bot collects task statuses from thread replies
          → Marks tasks as done / carry-forward / blocked / no-update

9:00 PM   Daily report generated
          → Public report → progress channel (team-visible)
          → Private report → DM to admins/managers
          → Daily shoutout if anyone hit 100% completion

Friday    Weekly report (6 PM), KPI snapshot (11 PM)
Monthly   Monthly report on last working day (6 PM)
```

All times are in your org's configured timezone.

***

## For Employees

### Posting Your Tasks (Morning Thread)

Every morning, the bot posts a thread in your team channel. Reply with your tasks for the day:

```
- Write newsletter for Client A (L)
- QC design for Client B (S)
- Update social calendar (M)
```

The bot auto-parses each line into a task with:

* **Title** extracted from your text
* **Size** — S (small, weight 1), M (medium, weight 2), L (large, weight 3)
* **Client** — auto-detected from client names in your org
* **Task type** — classified as writing, design, QC, etc.

If you don't specify size, it defaults to M.

### Talking to the Bot

DM the bot or mention `@Hitler` in any channel. It understands natural language:

```
"I need to finish the newsletter for Acme by EOD"
→ Creates a task: "Finish newsletter for Acme" | Size: M | Client: Acme

"What are my tasks?"
→ Lists your current tasks with statuses

"Done with the Acme newsletter"
→ Marks matching task as completed

"I'm blocked on the design — waiting on client feedback"
→ Reports a blocker, notifies ops immediately
```

### Slash Commands

| Command             | What it does                    |
| ------------------- | ------------------------------- |
| `/tasks`            | List your current tasks         |
| `/done <task>`      | Mark a task as completed        |
| `/blocked <reason>` | Report a blocker (notifies ops) |
| `/unblocked <note>` | Resolve your active blocker     |
| `/status`           | Show your current status        |
| `/mood`             | Log your mood (1-5 scale)       |
| `/help`             | Show all available commands     |

### Things You Can Ask the Bot

Just DM the bot naturally — it has tools for:

* **Tasks**: "show my tasks", "what's pending?", "mark X as done", "create task: do Y"
* **Reminders**: "remind me in 2 hours to send the email", "snooze reminder 30 min"
* **Mood**: "log mood 4", "how have I been feeling this week?"
* **Stats**: "what's my KPI?", "how am I doing this week?"
* **Cards**: "do I have any cards?", "show my yellow cards"
* **Blockers**: "I'm blocked on X", "show my blockers"
* **OOO**: "I'm out tomorrow", "check my OOO status"
* **Checklists**: "show my checklist", "check item 3 on content writing", "checklist done"
* **SOPs**: "what SOPs do I have?", "done with weekly report for Acme"

### End of Day

At 5 PM the bot posts an EOD nudge. At 7 PM it collects statuses. Reply to the morning thread with updates:

```
- Newsletter for Acme: done
- Design QC for Client B: carry forward (waiting on assets)
- Social calendar: done
```

The bot parses statuses: **done**, **carry-forward** (with optional reason), **blocked**, or **no update**.

### Cards and Accountability

The system tracks your performance through a card system:

| Card       | Trigger                                                          | Consequence                  |
| ---------- | ---------------------------------------------------------------- | ---------------------------- |
| **Yellow** | Carry-forward >2 tasks, missing submissions, low completion      | Warning — visible in reports |
| **Red**    | Accumulating yellows, repeated misses, critical underperformance | Escalated to leadership      |

Cards are visible to you ("show my cards") and to managers in the dashboard.

### Checklists

Role-based quality checklists are assigned to you. Check your pending ones:

```
"show my checklist"
→ Lists your checklists with completion status

"check content writing item 2"
→ Marks item 2 on Content Writing checklist as done

"checklist done"
→ Marks all items on your active checklist as complete
```

**Default checklists by role:**

* **Writers**: Correct hyperlinks, AI-slop edited out, appropriate writing style, outline followed
* **Designers**: Redirect URL added, hyperlinks correct, images clickable
* **Client QC**: Subject line options shared, scheduled/followed up on time

### SOPs (Standard Operating Procedures)

Recurring process obligations tracked automatically:

```
"what SOPs do I have?"
→ Shows your pending SOPs with due dates

"done with weekly client report"
→ Marks that SOP as completed for this period
```

SOPs have deadlines. Overdue SOPs trigger reminders. Missed SOPs show up in reports.

***

## For Managers / Admins

### The Web Dashboard

Access at your configured web URL. Sign in with Slack OAuth.

The dashboard has 5 main views:

#### Today View (`/dashboard`)

* Live task feed grouped by person
* Per-person completion percentage
* Card pills (yellow/red indicators)
* Active blocker alerts
* Cron job status

#### Clients View (`/dashboard/clients`)

* Per-client health cards
* Health score (0-100): 50% task completion + 30% deploy compliance + 20% carry-forward ratio
* Deploy streak tracking
* Week-over-week trend sparklines
* Team member breakdown per client

#### Team View (`/dashboard/team`)

* Per-person KPI breakdown
* Card history
* Task list with advisory notes
* Performance trends

#### Reports View (`/dashboard/reports`)

* Daily public/private reports
* Weekly public/private reports
* Monthly reports
* Filter by date range

#### Cards View (`/dashboard/cards`)

* Full card log with filters
* Dismiss cards
* Manual red card issuance
* Card rules reference

### Additional Pages

| Page         | Route                     | Purpose                                                        |
| ------------ | ------------------------- | -------------------------------------------------------------- |
| Action Items | `/dashboard/action-items` | Auto-generated action items from weekly reports + manual items |
| Checklists   | `/dashboard/checklists`   | Manage checklist templates, view completion stats              |
| SOPs         | `/dashboard/sops`         | Define SOPs, track compliance rates                            |
| Settings     | `/dashboard/settings`     | All org configuration                                          |

### Action Items

Weekly private reports auto-generate action items based on data patterns:

* User below 50% KPI for 2+ weeks → "Schedule 1:1 with \[name]"
* Client with missed deploys → "Review \[client] workflow"
* High carry-forward user → "Check workload for \[name]"

Items carry forward weekly until resolved. Track them at `/dashboard/action-items`.

### Intervention Logging

When someone picks up another person's work, log it:

```
/log-intervention @person Finished their newsletter because they were sick
```

This is tracked privately and surfaces in daily/weekly/monthly private reports. Helps identify who needs help and who helps others.

### Reports Breakdown

**Daily Public Report** (posted to progress channel):

* Per-user task list with completion status
* Team completion % (weighted by task size)
* Tasks done / carry-forward / blocked / no-update counts

**Daily Private Report** (DM to admins):

* Everything in public + cards issued + active blockers + OOO users
* Interventions logged today
* Per-client summary
* Stale tasks (in\_progress 2+ days)
* Checklist completion summary

**Weekly Public Report** (Friday, progress channel):

* Team completion % for the week
* Performer of the Week (highest weighted completion)
* Card summary
* Client sends: on time vs missed

**Weekly Private Report** (Friday, DM to admins):

* Per-user KPI comparison
* Card tally per user
* Carry-forward patterns
* Client health summaries
* Interventions log
* Auto-generated recommended action items
* SOP compliance summary
* Checklist completion rates

**Monthly Report** (last working day, DM to admins):

* 4-week trend data
* Employee of the Month
* Card history
* Recurring blocker analysis
* Client health trends
* SOP compliance by category

### Positive Reinforcement

The system automatically recognizes performance:

* **Daily**: Users with 100% completion get a shoutout in the wins channel
* **Weekly**: Performer of the Week announced (highest weighted completion)
* **Monthly**: Employee of the Month auto-nominated

Configure the wins channel in Settings. Falls back to progress channel if not set.

***

## Settings Reference

All settings are configured at `/dashboard/settings`.

### Schedule & Timing

| Setting             | Default  | What it controls                            |
| ------------------- | -------- | ------------------------------------------- |
| Timezone            | UTC      | All cron times reference this               |
| Daily check-in time | 9:00 AM  | When mood check-in DM is sent               |
| Morning thread time | 9:00 AM  | When the team thread is posted              |
| Submission deadline | 11:00 AM | When missing submission reminders fire      |
| EOD nudge time      | 5:00 PM  | When the "update your tasks" reminder posts |
| EOD collection time | 7:00 PM  | When the bot parses task statuses           |

### Feature Toggles

| Toggle              | Default  | What it controls                                        |
| ------------------- | -------- | ------------------------------------------------------- |
| Morning threads     | On       | Daily task thread in team channel                       |
| Progress channel    | On       | Public reports and updates                              |
| Daily task deadline | Off      | Hard deadline enforcement                               |
| Proactive nudges    | Moderate | Frequency of bot reminders (gentle/moderate/aggressive) |
| Mood tracking       | On       | Daily mood check-ins                                    |
| Reinforcement       | On       | Shoutouts and recognition posts                         |

### Channels

| Channel          | Purpose                                            |
| ---------------- | -------------------------------------------------- |
| Progress channel | Morning threads, EOD summaries, public reports     |
| OOO channel      | Out-of-office announcements                        |
| Ops channel      | Classification digests, operational alerts         |
| Report channel   | Where reports are posted (falls back to progress)  |
| Wins channel     | Shoutouts and recognition (falls back to progress) |

### Bot Personality

| Setting   | Options                      |
| --------- | ---------------------------- |
| Tone      | Friendly / Professional      |
| Formality | Casual / Neutral / Formal    |
| Verbosity | Concise / Moderate / Verbose |

### Privacy

| Setting                     | Options                   |
| --------------------------- | ------------------------- |
| Scores visible to employees | Yes / No                  |
| Show team comparison        | Yes / No                  |
| Journal privacy             | Private / Manager / Admin |
| Notify on flags             | Yes / No                  |

***

## Automated Processes (Crons)

These run automatically based on org settings. No manual intervention needed.

| Cron                  | Schedule                 | What it does                                                    |
| --------------------- | ------------------------ | --------------------------------------------------------------- |
| Morning thread        | Daily at configured time | Posts task thread to progress channel                           |
| Submission deadline   | Daily at configured time | DMs users who haven't submitted                                 |
| EOD nudge             | Daily at configured time | Reminds team to update statuses                                 |
| EOD collection        | Daily at configured time | Parses task statuses from threads                               |
| Daily report          | Daily 9 PM               | Generates public + private daily reports                        |
| Classification digest | Daily 11:30 AM           | Posts task classification summary                               |
| Blocker escalation    | Every hour               | Escalates unresolved blockers (8h → founder DM, 24h → critical) |
| Thursday check-in     | Thursday 6 PM            | DMs underperforming users (\< 60% KPI)                          |
| Weekly KPI snapshot   | Friday 11 PM             | Saves KPI data for historical tracking                          |
| Weekly report         | Friday 6 PM              | Generates weekly reports, carries forward action items          |
| Monthly report        | Last working day 6 PM    | Generates monthly report                                        |
| Personal summary      | Daily at check-in time   | DMs each user their daily task summary                          |
| OOO status update     | Daily 00:05              | Transitions OOO records (upcoming → active → completed)         |
| SOP period generation | Daily 00:10              | Creates pending SOP records for new periods                     |
| SOP overdue check     | Daily 10:00 AM           | Sends reminders for overdue SOPs                                |
| Overdue task scanner  | Hourly                   | Scans for overdue tasks                                         |
| Stale task detection  | Every 15 min             | Flags tasks in\_progress for 2+ days                            |

***

## KPI Scoring

Each user gets a composite KPI score (0-100):

| Component             | Weight | What's measured                               |
| --------------------- | ------ | --------------------------------------------- |
| Task completion       | 40%    | Weighted completion rate (by task size S/M/L) |
| Timeliness            | 20%    | % of tasks completed by deadline              |
| Carry-forward         | 15%    | Lower carry-forward ratio = better            |
| Submission compliance | 15%    | Did you post in the morning thread?           |
| Blocker ratio         | 10%    | % of tasks that got blocked                   |

KPI targets are configurable per-org at `/dashboard/settings/kpi-targets`.

***

## Blocker Escalation

When a blocker is reported (via `/blocked` or auto-detected from carry-forward reasons):

| Time     | Action                                              |
| -------- | --------------------------------------------------- |
| 0 hours  | Ops notified in progress channel                    |
| 8 hours  | Founder/admin DM: "Blocker unresolved for 8+ hours" |
| 24 hours | Marked critical, posted to progress channel         |

Auto-detected from carry-forward reasons containing: "blocked", "waiting on", "depends on", "stuck", "can't proceed", "need approval", "pending review".

***

## Client Management

Clients are first-class entities with:

* **Deploy days**: Configured day(s) of the week when client content goes out
* **Assigned members**: Writers and designers linked to each client
* **Health score**: Auto-computed from task completion + deploy compliance
* **Health levels**: Healthy (above 75), At Risk (50–75), Critical (below 50)

Manage clients at `/dashboard/clients`. Create via Settings or API.

***

## Roles and Permissions

| Role         | Can do                                                                   |
| ------------ | ------------------------------------------------------------------------ |
| **Employee** | Own tasks, mood, checklists, SOPs, view own KPI                          |
| **Manager**  | Everything employee + view team KPIs, reports, cards, interventions      |
| **Admin**    | Everything manager + org settings, user management, manual card issuance |

Roles are assigned in Settings → User Management.