docs/roadmap.md

# HearthNet Hackathon Master Plan

**Timeline:** June 6 → June 15  
**Theme:** Community-owned resilient AI infrastructure

## Team Structure

| Role | Person | Responsibility |
| --- | --- | --- |
| Product Lead | Christof | Vision, architecture, scope |
| Tech Lead | TBD | Technical decisions |
| Backend Engineer | TBD | Capability Bus |
| AI Engineer | TBD | LLM & Routing |
| RAG Engineer | TBD | Knowledge system |
| Frontend Engineer | TBD | UI |
| DevOps Engineer | TBD | Deployment |
| Marketing Lead | TBD | Social, branding |
| Pitch Lead | TBD | Presentation |
| Community Manager | TBD | Discord, recruiting |

## Overall Roadmap

| Date | Product | Engineering | AI | DevOps | Marketing | Pitch |
| --- | --- | --- | --- | --- | --- | --- |
| Jun 6 | Team Formation | Repo Setup | Research | Infra Setup | Recruitment | Story Outline |
| Jun 7 | Architecture Freeze | Core Framework | Model Selection | Docker | Branding | Problem Statement |
| Jun 8 | MVP Scope | Discovery | LLM Node | CI/CD | First Post | Demo Flow |
| Jun 9 | Review | Routing | RAG | Containers | Screenshots | Narrative |
| Jun 10 | Scope Check | Integration | Retrieval | Deployments | Progress Post | Draft Slides |
| Jun 11 | Testing | Features | Optimization | Monitoring | Community Feedback | Pitch Draft |
| Jun 12 | Feature Freeze | Bug Fixes | Bug Fixes | Bug Fixes | Video Clips | Presentation |
| Jun 13 | Demo Review | Polish | Polish | Polish | Social Push | Demo Script |
| Jun 14 | Final Review | Final Fixes | Final Fixes | Final Fixes | Launch Post | Rehearsal |
| Jun 15 | Submission | Submission | Submission | Submission | Promotion | Presentation |

## Product & Architecture Track

### June 6

#### Deliverables

- Confirm HearthNet concept
- Define MVP
- Define stretch goals
- Create architecture diagram
- Create user journey

#### Questions to Answer

- What problem are we solving?
- Why now?
- Why is local AI important?
- What does success look like on June 15?

### June 7

#### Architecture Freeze

- Discovery mechanism
- Capability Bus
- Routing layer
- RAG integration
- Frontend architecture

After this date:

- ❌ No major redesigns

## Engineering Track

### Backend

#### Week 1

| Task | Priority |
| --- | --- |
| Node Registry | Critical |
| Discovery | Critical |
| Capability Announcements | Critical |
| Routing Engine | Critical |
| Health Monitoring | High |
| Service Registry | High |
| Metrics | Medium |

#### Checklist

- Nodes discover each other
- Nodes advertise capabilities
- Requests routed correctly
- Failover works

## AI Track

### Local Inference

#### Research

- llama.cpp
- Ollama
- vLLM
- MLX (optional)

#### Tasks

- Select model
- Benchmark model
- Create inference endpoint
- Remote execution

#### Stretch

- Multi-node inference
- Federated learning concept

## RAG Track

### Build Emergency Knowledge Library

#### Potential datasets

- First aid
- Emergency response
- Community handbook
- Local resources

#### Tasks

- PDF ingestion
- Chunking
- Embeddings
- Retrieval
- Citation support

#### Demo question

> "How do I perform CPR?"

Should work even with internet disconnected.

## Frontend Track

### Screens

| Screen | Priority |
| --- | --- |
| Network Map | Critical |
| AI Chat | Critical |
| RAG Search | Critical |
| Node Status | High |
| Marketplace | Medium |
| Community Chat | Medium |

### Visual Goal

Judges should understand everything in 10 seconds.

## DevOps Track

### Infrastructure

#### Tasks

- Docker
- Docker Compose
- GitHub Actions
- Logging
- Monitoring

### Demo Setup

#### Minimum

- Laptop A
- Laptop B
- Raspberry Pi

#### Preferred

- 3 laptops
- 1 Raspberry Pi

## Marketing Track

This is where most hackathon teams completely fail.

### June 6

#### Recruitment Post

- Discord post
- HF discussion
- Reddit post
- Team call invitation

**Goal:** Find engineers.

### June 7

#### Branding

- Name finalized
- Logo
- Banner
- Color scheme
- Elevator pitch

**Example:** HearthNet: Community-Owned AI That Works Even When The Internet Doesn't.

### June 8

#### Landing Page

- Simple website
- Problem statement
- Architecture image
- Team section

### June 9

#### Content

Create:

- Architecture diagram
- Screenshots
- GIFs
- Progress updates

### June 10

#### Community Feedback

Ask:

- Would you use this?
- Why?
- What is missing?

Gather comments.

### June 11-13

#### Daily Posts

Post:

- Progress
- Screenshots
- Team photos
- Failures
- Lessons learned

Judges often recognize active teams.

### June 14

#### Launch Post

Show:

- Demo
- Screenshots
- Architecture

Create buzz before judging.

## Pitch Track

### Day 1

Create story.

#### Problem

Current AI:

- Centralized
- Fragile
- Requires internet

#### Solution

HearthNet:

- Local-first
- Community-owned
- Resilient

### Day 2

#### Demo Narrative

**Scene 1**

- Internet working
- Ask AI question
- Works

**Scene 2**

- Pull network cable
- Audience sees disconnect

**Scene 3**

- Ask same question
- Still works

Audience understands value instantly.

### Day 3

#### Future Vision

- Phase 1: Neighborhood
- Phase 2: City
- Phase 3: Federated Communities
- Phase 4: Global Community AI Network

## Daily Standup Template

Every day:

| Question | Answer |
| --- | --- |
| What did I finish? |  |
| What am I doing today? |  |
| What's blocking me? |  |
| Do I need help? |  |

Maximum 15 minutes.

## Critical Milestones

| Date | Milestone |
| --- | --- |
| Jun 6 | Team Formed |
| Jun 7 | Architecture Frozen |
| Jun 8 | Discovery Working |
| Jun 9 | LLM Running |
| Jun 10 | RAG Working |
| Jun 11 | End-to-End Demo |
| Jun 12 | Failover Working |
| Jun 13 | Feature Freeze |
| Jun 14 | Pitch Rehearsal |
| Jun 15 | Submission |