Skip to content

Latest commit

 

History

History
659 lines (399 loc) · 26.4 KB

File metadata and controls

659 lines (399 loc) · 26.4 KB

SearchSaga

Connecting the Dots

Handle with care!

Triggers curiosity for the curious minds

Born out of frustration

For a search to find a purpose

Product Requirements Document | Version 2.0

March 2026

Created by Aadi | Founder, AgentKite

Built for curious minds. Starting with two.

Table of Contents

**1.**The Soul — Vision & Origin Story

**2.**The Universal Framework — Seven Stages of Evolution

**3.**The Swipe Experience — Three-Axis UX

**4.**Card Design System

**5.**The Galaxy — Web Visualization

**6.**Product Architecture

**7.**AI Content Pipeline — The Seven Agents

**8.**Child Safety System — The Guardian Agents

**9.**Content Management System

**10.**Visual & Design System

**11.**Technical Stack

**12.**Data Model

**13.**Daily Workflow

**14.**Growth & Scaling Plan

**15.**Phase Roadmap

**16.**Success Metrics

**17.**Risks & Mitigations

1. The Soul — Vision & Origin Story

1.1 Handle With Care

Handle with care! Triggers curiosity for the curious minds. Born out of frustration! For a search to find a purpose. Triggers curiosity for finding a purpose.

SearchSaga exists because a father watched his daughters scroll through content designed to trap them, and got angry enough to build the alternative.

It is not anti-technology. It is technology built with intention. Where platforms use infinite scroll to capture attention, SearchSaga uses infinite scroll to ignite curiosity. Where algorithms hide their logic, SearchSaga shows every connection openly. Where feeds are disconnected noise, SearchSaga is a connected web of human knowledge.

Every swipe is a connection. Every session tells a story. Every kid builds their own map of how the world works.

1.2 What Is SearchSaga?

SearchSaga is an infinite-scroll knowledge experience where every topic in human history — technology, science, nature, math, art, human systems — is told as an evolution story and visually connected to everything else. Built for 10-year-old curious minds. One new topic every day. The web grows. Curiosity compounds.

1.3 The Parallel With AgentKite

AgentKite says: you should control what platforms show you. SearchSaga says: here is what happens when you follow your own curiosity instead of an algorithm’s agenda. Same fight, different angle. One is the shield, the other is the sword. Both born from the same frustration. Both built for the same daughters. Both scaling to everyone.

1.4 Core Beliefs

  • Everything is connected. There are no isolated subjects, only undiscovered connections.

  • Every new thing follows the same evolutionary arc — from itch to offspring.

  • Evolution is parallel. Nothing grows alone. Technologies, ideas, and discoveries co-evolve.

  • Curiosity is the only curriculum. No “start here.” Pick any dot. Follow any thread.

  • Kids don’t need dumbed-down content. They need complex ideas told in honest, vivid language.

  • The most addictive UX pattern ever built — the infinite scroll — can be repurposed for good.

1.5 Target Audience

Primary: Children aged 8–12 (sweet spot: 10). Secondary: Parents seeking enrichment that competes with TikTok. Tertiary: Educators and homeschool families. Latent: Curious adults who wish school had been like this.

2. The Universal Framework — Seven Stages of Evolution

Every topic follows seven evolutionary stages. This framework applies universally — AI, the human eye, WiFi, democracy, the color blue. Kids learn the rhythm once and can read any topic through it.

2.1 The Seven Stages

Stage Name Core Question
1 The Itch What was bugging us? What limit or frustration made this necessary?
2 The Mutation Who asked the weird question? What unexpected idea changed everything?
3 The DNA What was already lying around? What older ideas combined?
4 The Birth When did it become real? The messy, fragile first version.
5 The Growth Spurt What happened when it scaled? What broke, surprised everyone?
6 The Territorial Fight Who’s fighting over it? Control, access, ownership.
7 The Offspring What is it quietly giving birth to? Unconnected dots lying around now.

2.2 The Eighth Layer: The Cousins (Parallel Evolution)

Nothing evolves alone. “The Cousins” identifies what else was evolving simultaneously and why they needed each other. Like flowers and bees — neither makes sense alone. Cousin connections cross subject boundaries: math to physics to technology to nature. These cross-links are the soul of SearchSaga.

2.3 Framework Stress Test

Domain Example Validation
Technology How AI Grew Up Itch: manual computation. DNA: calculus + data + GPUs. Offspring: agents.
Nature How the Eye Evolved Itch: detect light. DNA: photon-reactive proteins. Cousins: brains co-evolved.
Human Systems How Money Grew Up Itch: barter fails. Mutation: a shell has value. Offspring: crypto.
Math How Zero Grew Up Itch: no placeholder. DNA: Babylon + India. Offspring: binary, computing.
Science How Gravity Grew Up Itch: why things fall. Cousins: optics, calculus evolved in parallel.
Art How Color Grew Up Itch: only earth pigments. DNA: chemistry + trade. Offspring: digital color.

3. The Swipe Experience — Three-Axis UX

3.1 The Core: TikTok Meets Tinder

SearchSaga combines TikTok’s vertical scroll with Tinder’s horizontal choice. Three gestures, three meanings:

Gesture Direction Meaning
Swipe Up ↑ Vertical Next moment. Go deeper into this thread. Default. Breathing. Flow.
Swipe Right → Horizontal Follow this connection. Branch to a cousin. Connect a dot.
Swipe Left ← Horizontal Show a different connection. Not this one. Surprise me.

3.2 Two States

Flowing: Swiping up through moments. Low decision, high absorption. Like a page-turner.

Choosing: A connection card appeared. Fork in the road. Right for this cousin. Left for another. Up to skip both and continue current story. This is the active learning moment.

3.3 Why This Changes Everything

On TikTok, 20 minutes gives 40 disconnected fragments. On SearchSaga, 20 minutes gives a journey — a path you chose, a web you wove. “I started at WiFi, branched into Light, branched into the Eye, continued into the Brain, ended at Batteries.” That path is unique. That’s identity, not addiction.

3.4 The Connection Card

The most important content in the product. It appears at branching points between topics and sometimes mid-topic. Shows one sentence, one image, one “wait, WHAT?” that earns the swipe. Example: “WiFi’s cousin: a shrimp sees polarized light — the same physics behind your wireless signal.”

Left/right choices quietly build the kid’s preference map. The feed adapts to follow their curiosity shape — not to addict, but to guide.

3.5 Engagement: Maps, Not Points

No points. No streaks. No leaderboards. Instead:

  • Every completed evolution lights up a node in the kid’s personal web.

  • Every right-swipe lights up a thread.

  • Their profile IS their web — a visual map of curiosity.

  • “You’ve explored 47 nodes. Your web is strong in Technology. Art has unconnected dots waiting.”

3.6 Social: Paths, Not Likes

Kids share paths, not likes. “Money → Gold → Chemistry → Color → Art.” Someone sees it, thinks “wait, how does Gold connect to Color?” and dives in. Curiosity spreads through shared paths.

3.7 Natural Ending

After 15–20 minutes, the feed starts showing greyed-out unconnected dots. “This node isn’t live yet. Coming tomorrow.” The scroll winds down with anticipation, not a wall.

4. Card Design System

4.1 Cards, Not Pages

A stage is too much for one card. A card is one atomic moment: one idea, one image, 5–8 seconds. A seven-stage evolution breaks into 15–25 cards.

4.2 Card Types

Card Type Content Duration
Moment Card One sentence + one visual. A single idea that lands. 5–8 sec
Surprise Card Full-screen big text. The “wait, REALLY?” fact. Does all the work. 3–5 sec
Visual Card Full-screen infographic. Tap to explore. No text wall. 5–10 sec
Stage Marker Just the icon and name. “The Mutation.” Chapter break. 1–2 sec
Connection Card Fork: left cousin / right cousin. One sentence + image per side. 3–10 sec
Interaction Card Question before reveal. “What do you think happened next?” 5–15 sec
Breathing Card Beautiful image. No text. Visual rest. 2–3 sec

4.3 The Rhythm

Cards follow a heartbeat: moment, moment, moment, breathe, moment, SURPRISE, explain, explain, visual, moment, interact, reveal. Not a lecture. A pulse.

A full topic plays out over 2–3 minutes of swiping — same as one TikTok rabbit hole. But instead of 15 disconnected videos, they’ve absorbed one complete evolution.

4.4 Card Specs

Type Layout Constraints
Moment Top: illustration (40%). Bottom: 1–2 sentences, large font. Max 25 words. One idea.
Surprise Full screen. Large bold centered text. Background image blurred. Max 15 words.
Visual Full-screen infographic. Tap hotspots for details. Interactive. No reading required.
Stage Marker Centered icon + name. Subtle animation. No text beyond name.
Connection Split: left cousin / right cousin. Image + sentence each. Max 12 words per side.
Interaction Question centered. Optional image. Swipe up for answer. Must be curious, not quiz-like.
Breathing Full-screen image. No text. Palette matches topic mood.

4.5 Typography

  • Primary: sans-serif, 18–22px mobile. Readable on dark backgrounds.

  • Surprise: bold, 28–36px. Unmissable.

  • Connection: 16–18px. Concise.

  • Nothing below 16px. These are kids with varying reading abilities.

4.6 Transitions

  • Swipe up: next card from bottom with slight parallax.

  • Swipe right: card slides left, new topic enters from right with thread animation.

  • Swipe left: connection slides right, alternative enters from left.

5. The Galaxy — Web Visualization

5.1 Two Modes, One Product

The Scroll: Daily engagement. Thread-following. Cards. Where kids live.

The Galaxy: Exploration mode. Full web. Find starting points. See your personal map.

The scroll feeds the galaxy (completed evolutions light up nodes). The galaxy feeds the scroll (tapping any node starts a new thread).

5.2 Galaxy Design

Dark, space-like canvas. Glowing nodes. Bright threads. New nodes glow brighter. Unconnected dots are greyed with question marks.

  • Pan and zoom freely. Pinch on mobile.

  • Tap node to enter scroll for that topic.

  • Threads tappable — show connection description.

  • Filter by domain.

  • Toggle full galaxy vs personal web (only explored nodes).

5.3 Path Replay

Kids replay any session’s path as animation on the galaxy — watching their journey trace across the web. Shareable as video/image for WhatsApp and social.

6. Product Architecture

6.1 Four Core Systems

  1. AI Content Pipeline — Seven agents: topic → complete card deck with visuals and connections.

  2. Child Safety System — Two independent Guardian agents scan everything before CMS entry.

  3. Content Management System — Structured content, node graph, review workflow, publishing.

  4. Frontend Application — Scroll experience + galaxy visualization.

6.2 Flow

Topic input → 7-agent pipeline generates deck → 2 Guardian agents scan for safety → CMS draft → Aadi reviews (15–20 min) → Publish → Frontend rebuilds → Node live in galaxy, cards in scroll feed, threads light up.

6.3 Principles

  • One topic per day. System supports this velocity.

  • AI generates (80%), human curates (20%). The 20% is what makes it special.

  • Safety is infrastructure, not a feature. Content cannot reach CMS without passing two independent safety agents.

  • The web grows organically. Connections compound.

  • Kid-first: every decision filters through excitement AND safety.

7. AI Content Pipeline — The Seven Agents

Agent Role Output
1. Researcher Deep research on topic Facts, dates, people, surprises, potential cousins
2. Storyteller Seven-stage evolution narrative 80–150 words per stage in kid voice
3. Card Architect Breaks stages into atomic cards Ordered deck: 15–25 typed cards with rhythm
4. Visual Architect Infographics + image prompts JSON data + style-consistent prompts
5. Connector Finds cousin links to existing nodes Bidirectional connections + unconnected dot teasers
6. Editor Quality + voice check Polished draft with confidence score
7. Publisher CMS formatting + safety trigger CMS-ready JSON, triggers Guardian agents

7.1 Key Agent Details

The Researcher

Tools: Web search, Wikipedia API, curated sources.

Key: Prioritizes surprising, counterintuitive facts — these become Surprise Cards.

The Storyteller

Key: Follows seven-stage framework strictly. Every stage starts with a hook. Offspring ends with an open question, never a statement.

The Card Architect

Key: The rhythm designer. One idea per card. Places Surprise Cards for impact, Breathing Cards against fatigue, Interaction Cards before reveals, Connection Cards at natural branches. Enforces the heartbeat.

The Connector

Key: Most critical agent. Finds NON-OBVIOUS cross-subject connections. Deprioritizes obvious links. Generates Connection Card hooks — the one sentence that earns the right swipe.

7.2 Voice Guidelines

  • Cool older cousin, not teacher. Excited, not lecturing.

  • “You know how...” bridges to kid experiences.

  • Every stage: one “wait, really?” moment.

  • Short sentences. Active voice. Concrete over abstract.

  • Never “in conclusion.” Use “imagine” liberally.

  • Offspring ends with a question. Leave them thinking.

7.3 Cost Estimation

Component Cost per Node
7 content agents (Claude API) $0.55–$0.85
2 Guardian agents (safety) $0.10–$0.16
Image generation (3–5 images) $0.20–$0.40
Total per node $0.85–$1.40
Monthly (30 nodes) $25–$42

8. Child Safety System — The Guardian Agents

This is the most important section. Content reaching children is a responsibility, not a feature. Safety is infrastructure.

8.1 Philosophy: Defense in Depth

Every piece of content — text, image prompt, infographic, connection — passes through TWO independent safety agents before entering CMS. Different models, different rulesets. Both must pass. If either flags, content is blocked for human review. This is three layers total: Guardian 1 + Guardian 2 + Aadi’s human review.

8.2 Guardian Agent 1: The Word Shield

Language-level content safety

Scans: Every text field — card text, connections, infographic labels, image alt text, titles.

Model: Dedicated Claude instance with child-safety system prompt.

Category Catches Action
Explicit language Profanity, slurs, sexual terms, drug references Block
Violence and harm Graphic violence, self-harm, weapons glorification Block
Age-inappropriate tone Content causing anxiety, existential distress, fear Flag for tone adjustment
Bias and stereotypes Gender, racial, cultural, religious bias Block
Manipulative language Fear hooks, shame, urgency tactics, dark patterns Block
Sensitive history Wars, slavery, colonialism — handle with care, not avoid Flag with sensitivity guidance
Commercial content Brand promotion, product placement, ad language Block and strip
Misinformation Pseudoscience, conspiracy theories, unverified claims Block, route to fact-check

8.3 Guardian Agent 2: The Context Shield

Semantic and contextual safety

Scans: Complete card deck holistically — meaning, implications, context that word-level misses.

Model: Different AI instance with separate system prompt. Independence is critical.

Category Catches Action
Contextual inappropriateness Safe words combining into inappropriate meaning, innuendo Block
Emotional tone Too dark, hopeless, anxiety-inducing for target age Flag for tone adjustment
Connection safety Cousin connections that could lead toward inappropriate chains Block connection, suggest alternative
Image prompt safety Prompts that could generate disturbing or frightening images Block, generate alternative
Interaction card safety Questions that could make kids feel stupid or ashamed Flag, rewrite encouraging
Cultural sensitivity Western-centric framing, erasure of non-Western contributions Flag with guidance
Cumulative effect Individual cards fine but sequence creates distressing arc Flag, suggest reorder
Data privacy Content encouraging kids to share personal information Block and strip

8.4 Safety Gate

  1. Content pipeline completes. Publisher formats the deck.

  2. Guardian 1 (Word Shield) scans all text fields.

  3. Guardian 2 (Context Shield) scans complete deck holistically.

  4. BOTH pass → enters CMS as “Review” for Aadi.

  5. EITHER blocks → quarantined. Aadi notified with issues. Cannot publish until resolved and both re-pass.

  6. EITHER flags → enters CMS as “Safety Flagged.” Aadi must acknowledge each flag before publishing.

  7. Aadi’s review is the THIRD safety layer.

8.5 Image Safety Pipeline

  1. Visual Architect generates prompts with safety-conscious prefix.

  2. Guardian 2 reviews prompts before image generation.

  3. Images generated via API.

  4. Generated images pass vision-based content moderation (OpenAI / AWS Rekognition).

  5. Only images passing both prompt review AND generated scan are included.

  6. Aadi reviews all images in CMS.

8.6 Ongoing Safety

  • Weekly re-scan of all published content with updated safety rules.

  • Versioned safety rules, updated as edge cases emerge.

  • Parent feedback channel: flag any card, immediately queued for review.

  • Quarterly external review by child content safety consultant.

9. Content Management System

9.1 Sanity.io

  • Customizable schemas — each card type maps to a schema field.

  • Bidirectional reference fields for cousin connections.

  • GROQ for graph queries.

  • Real-time preview.

  • API-first: pipeline writes, frontend reads.

9.2 Workflow

  1. Pipeline generates deck → Guardian agents scan.

  2. Safety passes → CMS as “Review” (or “Safety Flagged”).

  3. Aadi reviews: cards, rhythm, connections, images, safety flags.

  4. Publish → webhook → Next.js ISR → live.

10. Visual & Design System

10.1 Aesthetic

Warm, hand-drawn, alive. Not corporate, not clinical, not “educational blue.” A brilliant older cousin drew this in their notebook and it came alive. Kurzgesagt meets sketchbook. Dark backgrounds, warm vibrant nodes and cards.

10.2 Image Style

Locked prefix: “Warm hand-drawn illustration, sketch lines with watercolor fills, whimsical, educational not childish, dark background, vibrant colors, no text, diverse characters.”

  • Works on dark backgrounds. No photorealism. Consistent palette: oranges, teals, purples, yellows.

10.3 Stage Icons

  • The Itch — cracked seed. The Mutation — lightning bolt + brain. The DNA — intertwined threads. The Birth — fragile sprout. The Growth Spurt — expanding spiral. The Territorial Fight — two flags. The Offspring — glowing question mark.

11. Technical Stack

Layer Technology Why
Frontend Next.js 14+ Static gen, ISR, React ecosystem
Scroll Engine Custom React + touch Three-axis gesture detection
Galaxy D3.js + Framer Motion Force graph + smooth transitions
Cards/Infographics React + D3 Dynamic, animated, data-driven
Styling Tailwind CSS Dark-theme tokens, responsive
CMS Sanity.io Structured, graph refs, API-first
AI Pipeline Python CLI Orchestrates 7 agents + 2 guardians
AI Model Claude API All content + safety agents
Images DALL-E 3 / Midjourney Consistent style prefix
Image Safety OpenAI Moderation / Rekognition Post-generation scan
Hosting Vercel Native Next.js, ISR, edge
Search Algolia Typo-tolerant, fast, kid-friendly
Analytics Plausible / PostHog Privacy-first, COPPA compliant

11.1 Privacy

  • COPPA compliant. No personal data from children under 13.

  • No accounts required. Optional parent-managed profiles.

  • Aggregate analytics only. No third-party trackers. No ads. Ever.

12. Data Model

12.1 Topic Node

Field Type Description
id auto Unique identifier
title string Display name
slug slug URL path
domain enum Science
subtitle string One-line hook
cards array of Card Ordered deck (15–25 typed cards)
stages object Raw seven-stage text for galaxy summaries
cousins array of Connection Bidirectional links with descriptions
unconnected_dots array of string Future topic teasers
images array of asset Generated images with placement
status enum Draft
safety_report object Guardian results, flags, remediations
confidence number Editor quality score (0–1)

12.2 Card

Field Type Description
type enum moment
text rich text Card content (null for breathing/visual)
image asset ref Illustration
stage enum Which of 7 stages
connection_left/right Connection ref For connection cards
question + answer_ref string + ref For interaction cards

12.3 Connection

Field Type Description
from/to node refs Source and target topics
type enum cousin
hook string One sentence for connection card (earns the swipe)
strength 1–5 Visual thread weight in galaxy
cross_domain boolean Crosses subject boundaries

13. Daily Workflow

Step Time Action
1 Auto Pipeline runs. Generates topic. Guardians scan.
2 0–2 min Notification. Open Sanity. Check safety report.
3 2–10 min Swipe through card preview. Feel the rhythm.
4 10–18 min Check connections (surprising?). Check images (right feel?).
5 18–22 min Gut check: would my daughter swipe right? Publish or revise.
6 22–25 min Share if it’s a good one.

13.1 The Daughters Test

Every weekend: daughters explore the week’s nodes. Where they zone out = rework card. Where they say “wait, really?” = working. Where they swipe right = connection earned it. This is the most valuable feedback loop.

13.2 Content Calendar

Rolling 2-week queue seeded by the Connector agent based on most-referenced unconnected dots. The web tells you what to write next.

14. Growth & Scaling Plan

WhatsApp Parent Groups (India-first)

Most powerful organic channel. Parent shares a path: “my kid couldn’t stop swiping.” More effective than any ad.

Short-form Social

15-second Surprise Card animations on YouTube Shorts / Reels. The hook, not the full story.

Educator Networks

“Start anywhere. Follow 5 connections. Write about your path.” Natural project-based learning.

SEO

Each topic = indexed page. Long-term organic discovery.

14.1 Scaling

Timeline Nodes State
Month 1 30 Core clusters. Framework proven.
Month 3 90 Web emerging. Cross-domain visible.
Month 6 180 Dense. All domains. 10+ step paths.
Year 1 365 Rich galaxy. Classroom-ready.
Year 2 700+ Sub-galaxies. Community contributions.

15. Phase Roadmap

Phase 0: Prove the Story (Week 1–2)

  • 5 stories manually. Test at dinner table. Record reactions.

  • Sketch card breakdowns on paper. Test the rhythm.

Deliverable: 5 proven stories. Locked voice. Card rhythm template.

Phase 1: Build the Pipeline (Week 3–5)

  • Sanity CMS with card schemas. 7 agents + 2 guardians.

  • Generate 10 topics. Iterate until matching manual quality.

Deliverable: Working pipeline with safety gates. 10 tested nodes.

Phase 2: Build the Scroll (Week 6–8)

  • Next.js frontend. Three-axis swipe engine. All 7 card types.

  • Basic galaxy. 20+ nodes end-to-end tested.

Deliverable: Working scroll + galaxy with 20+ connected nodes.

Phase 3: Launch (Week 9–10)

  • Polish. Lock style. Automate daily pipeline. Launch with 30 nodes.

Deliverable: searchsaga.com live. Daily cadence running.

Phase 4: Grow (Month 3+)

  • All 6 domains. Social teasers. Educator outreach. Path sharing.

16. Success Metrics

16.1 North Star

Nodes explored per session. Target: 4+ evolutions via connections.

16.2 Key Metrics

Metric Target (Month 3) Measures
Nodes per session 4+ Web navigation quality
Swipe-right rate 40%+ Connection cards compelling
Weekly return 30%+ Daily cadence creates habit
Cards per session 50+ Kids in flow
Session time 5+ min Sustained engagement
Path shares 5% Worth sharing
Safety incidents 0 Guardians + review working
Aadi daily time <25 min Sustainable

17. Risks & Mitigations

Risk Impact Mitigation
AI content generic High Voice guidelines. Human review. Surprise mandate.
Connections obvious High Connector deprioritizes obvious. Weekly manual review.
Inappropriate content Critical 2 Guardians + human review + image moderation + weekly re-scans + parent flagging.
Factual errors High Editor fact-checks. Low scores → extra review.
Swipe fatigue High Card Architect enforces rhythm. Breathing cards.
Galaxy clutters Medium Domain clustering. Zoom levels. Designed for 1000+.
Burnout Medium <25 min/day. Pre-generated buffer. Weekend fallback.
COPPA gaps High No personal data. Parent-managed only. No trackers.

SearchSaga

Handle with care!

Every swipe is a connection. Every session tells a story.

Born out of frustration. Built with love.

For a search to find a purpose.

Built for curious minds. Starting with two.