Proof Layer

Architecture + Agent Map

The full team running TuningFolks — 9 AI agents, a human scrum team, and a board review loop. Every layer is named, modelled, and verifiable.

AI agents

C-suite agents

Devs + architect

Board reviewer

The Stack

⚛️

Frontend

·Next.js 16 (App Router, Turbopack)
·TypeScript · Tailwind CSS
·Lucide icons · system font stack
·Server + Client Components
·Prisma ORM (better-sqlite3 adapter)

🗄️

Database

·SQLite (file-based, zero config)
·Prisma schema: NewsItems, Repos, Videos, Music, Podcasts, CaseStudies, LearningResources
·No Cloud SQL — saves $10–25/month
·Weekly backup to GCP Cloud Storage

🖥️

Infrastructure

·Single GCP e2-small VM (~$14/month)
·Docker Compose: hub + Nginx containers
·Nginx: SSL + reverse proxy (Let's Encrypt)
·Cloud Storage: audio files + DB backups
·Cloud DNS: news.tuningfolks.com

🤖

AI Models

·Strategic model (CEO / Board Chair)
·Executive model (CMO / CPO / CTO / CFO / PM)
·Speed model (content ingestion)
·CrewAI framework — sequential pipelines
·~700 API calls/month → ~$1.50/month

C-Suite Agent Loop

5 agents· runs every Monday, reviewed by board

AgentWeekly taskModelCadence

🤵

agent_morgan

CEO

Writes WEEKLY_MEMO.md — strategic thesis, market positioning, KPIs

Strategic

Weekly

📣

agent_leila

CMO

Writes MARKETING.md — growth, SEO, channel strategy, monetisation tracker

Executive

Weekly

📦

agent_priya

CPO

Writes CPO_REPORT.md — product audit, JTBD, activation path, roadmap

Executive

Weekly

🔧

agent_james

CTO

Writes ADR.md — tech health, security audit, showcase readiness, debt

Executive

Weekly

💰

agent_sarah

CFO

Writes FINANCIALS.md — unit economics, burn rate, revenue milestones

Executive

Weekly

↑

Abhay Ranjan — Board of Directors

Reviews WEEKLY_REPORT.md + board email each Monday. Signs off on strategic direction.

Human-in-loop

Content & Operations Agents

4 agents

AgentWeekly taskModelCadence

✍️

agent_raymond

Content Creator

Ingests and curates: AI news (every 6h), learning resources, videos, tech blogs. Classifies and summarises all content at high speed.

Speed

Every 6h + daily

📱

agent_kelly

Social Media Mgr

Generates social posts (LinkedIn, Twitter/X) from weekly report highlights. Schedules and distributes across channels.

Executive

Weekly

📋

agent_maya

Writes SPRINT.md (3 dev tasks) + CONTENT_CALENDAR.md (4 briefs: video, music, podcast, case study). Reads CMO SEO keywords.

Executive

Weekly

⚙️

agent_sam

Operations

Monitors infra health, API cost tracking, DB growth, ingest cadence. Generates weekly ops digest. Alerts on anomalies.

Executive

Scheduled

Dev Scrum Team

· human-assisted with Claude Pro

RoleFocusToolchain

💻

agent_jason

Site modernization & tech debt — implements CTO ADR recommendations, refactors, performance

Claude Pro · Claude Code · Next.js

🔨

agent_sameet

Business features & bug fixes — implements CPO roadmap items, SurveyAI features, API integrations

Claude Pro · Claude Code · Prisma

↑

Aparna Mishra — Architect

Reviews all PRs, signs off on architecture decisions, approves SPRINT.md scope before dev starts.

Sign-off

Content Ingestion Pipeline — agent_raymond

· every 6h for news, daily for learning + video

Source fetch

agent_raymond pulls from: 5 AI news RSS feeds, 15 curated YouTube channels, tech blog feeds (HN, Hacker News, The Register AI), arXiv cs.AI digest

Deduplicate

URL-based dedup — items already in DB are skipped. Prevents re-processing across all content types.

LLM classify

Each item → speed model: {title, summary, category, contentType}. Consistent taxonomy across news, learning, video, blog.

Persist

INSERT into respective tables (news_items, learning_resources, videos). Category, source, publishedAt stored.

Serve

Next.js server components read DB → render NewsGrid, LearningView, VideosGrid with badge colours and filters.

Cron trigger

Linux crontab on GCP VM: POST /api/news/ingest every 6h. Daily trigger for learning + video. Weekly for deep blog curation.

Total infrastructure cost

$17.80/month

See full cost breakdown →