Bootstrap Hub Bot Development Guide

A Discord bot built with Go and discordgo that helps solo founders and entrepreneurs track business goals using 2-week "Focus Periods" with automated reminders.

Project Structure

Entry Point

**cmd/bot/main.go**: Application entry point handling CLI flags, database initialization, bot instance creation, and graceful shutdown

Core Components

**Bot Management (internal/bot/bot.go)**

`Bot` struct with Discord session, config, and scheduler

Event handlers: `handleInteraction` (routes commands), `handleReady` (sets status)

Command registration/removal via Discord API

**Configuration (internal/config/config.go)**

Environment variables from `.env`:

`DISCORD_BOT_TOKEN` (required)

`DISCORD_APPLICATION_ID` (required)

`DISCORD_GUILD_ID` (optional, for faster dev updates)

`DISCORD_REMINDER_CHANNEL_ID` (optional)

`DATABASE_PATH` (optional, defaults to `data/bootstrap_hub.db`)

**Command System (internal/commands/)**

**commands.go**: `Command` type, `GetAllCommands()`, `GetCommandDefinitions()`, `GetHandlers()`

**focus.go**: `/focus` command group (start, add, complete, list, status)

**Database Layer (internal/database/)**

**models.go**: `User`, `FocusPeriod` (14 days), `Task` models

**database.go**: GORM/SQLite operations

- Constants: `FocusPeriodDuration` (14 days), `MinimumTasksRequired` (3), `ReminderDays` [3,7,10,12,13]

**Scheduler (internal/scheduler/scheduler.go)**

Hourly tick for automated reminders

Daily reminders on days 3,7,10,12,13 (9-10 AM only)

Goal-setting reminders on days 2-3 if <3 tasks

Development Workflow

Build Commands

```bash

make build # Compile to bin/bootstrap-hub-bot

make run # Build and start

make deps # Download dependencies

make test # Run tests

make clean # Remove artifacts

```

Discord Command Management

```bash

make register # Register slash commands (REQUIRED after changes)

make remove-commands # Remove all commands

make invite # Show bot invite URL

```

**Important**: After adding/modifying slash commands, run `make register`.

Direct Binary Execution

```bash

./bin/bootstrap-hub-bot -register

./bin/bootstrap-hub-bot -remove-commands

./bin/bootstrap-hub-bot -invite

./bin/bootstrap-hub-bot # Normal operation

```

Adding a New Command

1. Create command function in `internal/commands/` returning `*Command` with definition and handler

2. Add to `GetAllCommands()` in `commands.go`

3. Run `make register`

Example interaction flow:

1. User invokes `/focus start`

2. Discord → bot's `handleInteraction()`

3. Routed to `handleFocusCommand()` → `handleFocusStart()`

4. `GetOrCreateUser()` ensures user exists

5. `GetCurrentFocusPeriod()` checks for active period

6. `CreateFocusPeriod()` creates new 14-day period if needed

7. Response embed sent back

Key Implementation Details

**Interaction Response**: All commands must respond within 3s using `InteractionRespond()` with `InteractionResponseChannelMessageWithSource`

**Embeds**: Primary UI for rich formatting

**Guild-Specific Data**: Users/periods scoped per guild for isolation

**Registration Modes**:

- Guild-specific (with `DISCORD_GUILD_ID`): Instant updates

- Global (without): 1-hour propagation

**Bot Permissions** (value: 2147567616): Send Messages, Slash Commands, Embed Links, Read History

Testing

Use `make test`

Database tests: use `:memory:` SQLite or temp files

Handler tests: mock `*discordgo.Session` and `*discordgo.InteractionCreate`

Architecture Notes

GORM with SQLite for persistence

Scheduler auto-starts when `DISCORD_REMINDER_CHANNEL_ID` configured

Reminders posted as embeds to configured channel

2-week focus periods model agile sprints for entrepreneurial accountability

Bootstrap Hub Bot Instructions

Bootstrap Hub Bot Development Guide

Project Structure

Entry Point

Core Components

Development Workflow

Build Commands

Discord Command Management

Direct Binary Execution

Adding a New Command

Key Implementation Details

Testing

Architecture Notes

Reviews (0)