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