Project Scope Document · Chapter V

This document is confidential. Contact Chapter V for access.

CONFIDENTIAL — PREPARED EXCLUSIVELY FOR AJ BY CHAPTER V · AUGUST 2026
Scope Document v1.0

TownHall

Civic Engagement + AI Communications Platform

Prepared by Chapter V  ·  August 2026  ·  Confidential

$60KBuild Fee
10 wksTo Go-Live
~420 hrsBuild Hours
Oct '26Target Launch

Use the 📝 Add Note button in each section to leave feedback as you read. Submit everything at the end.

Executive Summary

What TownHall Is

TownHall is a civic engagement and AI communications platform that gives chambers of commerce, government entities, trade associations, and advocacy organizations a modern, unified tool — to collect community input at scale, analyze it with AI, and communicate back through AI-powered spokesperson videos.

01

No structured input

Chambers and councils rely on town halls and manual surveys to understand their community. Participation is low. Results take weeks. There's no modern alternative.

02

No AI analysis

Even when input is collected, there's no system to categorize it, surface trends, identify urgency, or produce a report ready for a board meeting — automatically.

03

No AI communications

Officials post inconsistently to social media. There's no tool to draft announcements, generate spokesperson videos, and maintain a consistent public presence efficiently.

The Solution

Three Integrated Pillars

Pillar 01

🎯 Input Engine

Community members submit feedback through polls, surveys, open text, or voice — with no account required. Works on any device, embeddable on any existing website, accessible by QR code in physical spaces.

  • Polls, surveys, open text, voice
  • No account required to submit
  • Embed widget for existing sites
  • QR code generator for physical spaces
  • SMS/text input channel
  • Multi-language support
Pillar 02

🧠 Intelligence Layer

AI (powered by Anthropic Claude) automatically categorizes every submission, maps it to topics, generates plain-language summaries with demographic breakdowns, and surfaces urgency before the next meeting.

  • Auto-categorization + topic matching
  • Sentiment analysis per topic
  • Demographic breakdowns
  • Urgency flagging
  • PDF reports for board packets
  • Public transparency dashboard
Pillar 03

🎙️ Voice Layer

Admins draft announcements with AI assistance, approve or edit the script, then generate a professional AI spokesperson video — their own face and voice, or a stock avatar — ready to post on any social platform.

  • AI script drafting (Claude)
  • Human approval before any video
  • HeyGen Digital Twin — real person's likeness
  • Stock avatar library
  • Voice cloning
  • Custom backgrounds
Product Detail

Full Feature Set

Organized into three build phases. Phase 1 delivers the demo and go-live. Phases 2 and 3 complete the full product by October.

Weeks 1–5 · Demo + Go-Live
🏗

Multi-Tenant Architecture

One codebase, fully isolated data per org. Every client gets their own branded subdomain.

🎨

Org Onboarding

Logo, brand colors, subdomain setup, and admin user management.

📊

Poll + Survey Builder

Multiple choice, ranked choice, and rating scale. Live without developer involvement.

✍️

Open Text + Voice Input

Freeform written or voice submissions — Whisper transcribes voice to text automatically.

🧠

AI Categorization

Every submission is automatically tagged to an existing topic or creates a new one.

📈

Sentiment Analysis

Per-topic sentiment score updated in real time as submissions come in.

✏️

AI Script Drafting

Claude drafts announcements and updates from topic summaries or freeform prompts.

🎬

HeyGen Video Generation

One-click video generation from an approved script. Stock avatar, stored and downloadable.

🌐

Public Submission Page

No account required. Fully branded. Mobile-responsive. Ready for the public from day one.

⚙️

Admin Dashboard

Topics, inputs, videos, users, and org settings — all in one clean interface.

📹

Video Library

All generated videos stored, searchable, and available for download or re-share.

🔐

Role System

CV Super Admin / Org Admin / Staff / Public Contributor with appropriate permissions.

Weeks 6–7 · Intelligence Depth
👥

Demographic Capture

Optional zip code, age range, and affiliation fields — breakdown by demographic in the dashboard.

📉

Sentiment Trending

Track how community sentiment on each topic shifts over weeks and months.

🚨

Urgency Flagging

AI surfaces input spikes and high-urgency topics automatically before the next meeting.

📄

PDF Report Generator

One-click formatted summary report — stats, demographics, AI summary, notable quotes. Board-packet ready.

🔄

Two-Way Topic Status

Open → Under Review → Action Taken. Prior submitters get notified when their topic moves forward.

🛡

Input Moderation

AI pre-screens for inappropriate content. Admins can flag, remove, or escalate any submission.

🌍

Public Transparency Dashboard

A public URL showing active topics, sentiment, and status updates. Drives trust and organic engagement.

📤

CSV / Data Export

Full data export for official records, legal compliance, and FOIA requests.

Weeks 8–10 · Full Product
🧑‍💼

Custom Avatar — Digital Twin

Client records a 5-min session. HeyGen builds their actual likeness and voice. Every video is literally them.

🗣

Voice Cloning

Upload a voice sample, clone it. All generated videos use the client's actual voice going forward.

🖼

Background Library

Branded backgrounds, location photos, or neutral presets. Custom uploads supported.

📱

QR Code Generator

Every poll and topic gets a QR code for bulletin boards, meeting rooms, and mailers.

🔁

Scheduled Campaigns

Set up a recurring "quarterly pulse check" that auto-launches, collects, and summarizes on schedule.

📋

Template Library

Pre-built poll and survey templates for common civic topics — budget, infrastructure, safety, events.

🎞

Video Series + Content Calendar

Plan a sequence of videos in advance. Approve in batches. Videos auto-generate on schedule.

🔗

Shareable Video Links

Each video gets a branded short link with an embedded player — copy and paste to any platform.

💬

SMS Input Channel

"Text SALEM to 55555." Reaches seniors and low-income residents who don't use apps. Via Twilio.

🌐

Multi-Language Input

Submissions in any language auto-translate to English for analysis. Displayed back in submitter's language.

🔧

Embed Widget

Drop a poll or feedback form on any existing city or chamber website — no migration required.

👑

CV Super Admin

Chapter V's master dashboard — all orgs, usage tracking, billing records, new client deployment.

Technical Foundation

The Stack

Built on proven, enterprise-grade infrastructure. Everything runs on Cloudflare's global network — 99.99% uptime, distributed across 330+ cities worldwide.

Frontend
React
Fast, modern, fully responsive. Works on every device and browser.
Database + Auth
Supabase
Secure, scalable Postgres database. Multi-tenant isolation built in. Handles all user authentication.
Backend + Hosting
Cloudflare Workers
Globally distributed API layer. No servers to manage. Always available.
AI Analysis
Anthropic Claude
Best-in-class language understanding for categorization, summarization, and script drafting.
Voice Transcription
Whisper (CF AI)
Voice submissions converted to text automatically. Already proven and deployed in prior CV builds.
Video Generation
HeyGen API
Best realistic AI avatar API available. Digital Twin support for real-person likenesses.
File Storage
Cloudflare R2
All generated videos stored securely. Zero egress fees. Download links available instantly.
Notifications
Resend + Twilio
Email via Resend. SMS via Twilio. Both already integrated across CV's platform stack.
Delivery Plan

Build Timeline

Aggressive but achievable. Chapter V has built comparable platforms in this timeframe before. The demo is ready for AJ's first pitch within one week of build start.

Week 1
Demo Ready
Branded, functional prototype AJ can put in front of the chamber. Live poll, AI topic summary, one avatar video generated.
Weeks 2–5
Phase 1 Complete — Go-Live Ready
Full multi-tenant system. Input engine live. AI categorization running. Admin dashboard complete. First client can go live.
Auth + OrgsInput EngineAI DashboardAvatar Videos
Weeks 6–7
Phase 2 Complete — Intelligence Depth
Demographics, sentiment trending, PDF reports, urgency flags, two-way topic status, moderation tools.
DemographicsPDF ReportsUrgency Flags
Weeks 8–10
Phase 3 Complete — Full Product
Digital Twin onboarding, voice cloning, QR codes, scheduled campaigns, embed widget, SMS channel, super admin.
Digital TwinVoice CloneQR CodesSMS
October 2026
🎯 Target Go-Live
First client fully onboarded, trained, and live on TownHall. Platform ready for subsequent sales.

Hours Breakdown

PhaseFocusHours
Phase 1Foundation + MVP200–240
Phase 2Intelligence Depth75–95
Phase 3Full Product100–130
Total375–465 hrs
Rush Timeline Note

The October go-live target is a guaranteed delivery date. A rush premium is applied to the build fee to protect this commitment. Standard timeline (no hard date) would carry a lower fee. This is reflected in the pricing section.

Pricing Discussion

Investment Model

The structure below represents Chapter V's current thinking. This section is intentionally open — AJ's input on pricing is needed before anything is finalized.

Ongoing — Usage Fee
Monthly

Begins at delivery. Covers hosting, maintenance, platform updates, support, and a base allotment of video minutes per year. Government and chamber buyers are accustomed to annual service fees — this maps to their budget cycles.

  • Hosting + infrastructure (Cloudflare, Supabase, R2)
  • Platform maintenance and updates
  • Technical support for the client org
  • Annual video minute allotment included
  • 6-month usage check-in conversation
  • Year 2+ fee based on prior year actual usage
  • Annual minimum floor (~$15–18K/yr)
AJ's Input Needed
  • What monthly or annual ongoing fee feels right to pitch to a chamber? We're thinking $1,200–2,000/mo but want your read on what the market will bear.
  • Should the first year of the ongoing fee be bundled into the $60K, or does billing start at delivery?
Video Minutes Model
Annual Allotment

Video generation is measured in minutes. Each client receives an annual allotment. The client portal shows a real-time tracker so they always know where they stand. Mid-year top-up packages are available for purchase when needed.

How it works in the portal:
Annual Video Minutes 67 / 150 used
83 minutes remaining · Renews January 2027
Top-Up Packages
25 minutes
$99
Quick top-up
120 minutes
$349
Best value
AJ's Input Needed
  • How many video minutes/year feels right as a base allotment for a chamber client? (We're thinking 100–200 min/yr for a standard deployment.)
  • Do the top-up prices feel reasonable to pitch, or should we adjust?
  • Digital Twin videos (real person's likeness) cost more to generate — should those be a premium tier or bundled in?
Opportunity

Market Size

TownHall's total addressable market extends well beyond chambers. The same platform serves any organization that needs to collect community input and communicate back — no code changes required.

7,000+
Chambers of Commerce
AJ's primary entry point. Faster procurement, strong relationships.
90,000+
Municipalities
City councils, county boards, special districts. Longer sales cycles but larger contracts.
66,000+
Trade Associations
Member input on industry policy. Same use case as chambers. Fast buyers.
14,000+
Labor Unions
Contract priorities, member sentiment, workplace feedback. Underserved by existing tools.
12,000+
Lobbying Firms
Multiplier effect — one firm can generate multiple TownHall deployments for their clients.
~1.5M
Non-Profits + Advocacy
Issue-based organizations with member engagement and communications needs.

Additional Segments

School Boards HOAs Business Improvement Districts Utility Districts Transit Authorities Port Authorities State Agencies Community Foundations
⚖️

Electoral campaigns and PAC advertising are explicitly excluded from TownHall's terms of service. This protects all clients and CV's brand. The platform is designed for civic engagement and non-electoral advocacy — trade associations, unions, chambers, governments, and advocacy organizations. Not campaigns.

Partnership

Business Structure

TownHall is a Chapter V product. Chapter V builds, owns, deploys, and maintains the platform. AJ's role is as a commission-based sales channel with an equity interest in the platform's growth.

Chapter V

Platform Owner

  • Owns the TownHall IP and codebase
  • Builds, deploys, and maintains the platform
  • Manages all technical delivery for every client
  • Handles hosting, maintenance, and support
  • Invoices clients and collects payment
  • Controls product roadmap and feature development
AJ

Sales Channel

  • Earns commission on every new client closed
  • Leverages chamber + civic network to open doors
  • Leads sales conversations and client pitches
  • Higher commission rate on upsells and premium features
  • First sales priority on chamber and government relationships
  • Commission structure: TBD — open for discussion
Commission Structure — To Be Discussed

The specific commission percentages, payout timing, and structure for upsells and renewals have not been finalized. This is a priority conversation before AJ pitches the first client. The intention is a structure that rewards AJ generously for each closed deal and incentivizes growth in the platform's active client base.

Path Forward

Next Steps

1

AJ Reviews This Document

Read through, leave notes on any section, submit your reaction below. Ed will follow up on every item.

2

Pricing + Commission Discussion

Align on the ongoing fee structure, AJ's commission rate, and the first-client pitch package before any sales conversations begin.

3

Chapter V Begins the Build

No waiting on full alignment — Phase 1 build starts immediately. The demo will be ready within one week.

4

AJ's First Pitch

Demo ready within one week of build start. AJ pitches the chamber with a live, branded, functional prototype in hand.

5

Contract Signed → Build Begins in Full

First client signs the $60K agreement. Chapter V locks in the October go-live and begins full-speed delivery.

6

October 2026 — Go Live

First client fully onboarded and live. Platform validated and ready for the next sale. AJ uses the case study to open the next door.

Your Turn

Your Reaction

Leave your overall thoughts below — type or record your voice. Any section-level notes you've saved will be included automatically.

📝 Your Section Notes

No section notes yet. Use the "Add Note" buttons as you read.