Skip to content

agents.md

Latest commit

 

History

History
156 lines (117 loc) · 8.83 KB

agents.md

File metadata and controls

156 lines (117 loc) · 8.83 KB

Bits&Bytes Team – Agents Handbook

Mission: Getting ambitious teenagers to ship meaningful tech through hackathons, design/dev squads, and product launches. Fully student-led. Org Type: Nonprofit · Independent Teen-Led Code Club · Based in Lucknow, India · Serving builders nationwide

This handbook describes the core Bits&Bytes "agents" (team members), what each person does, and how we collaborate.

1. Brand & Identity

1.1 Mission & Vision

We're not a chapter of someone else's thing. We're fully independent, fully student-led, and we run events on our own terms. Platforms like CodeDay, Hack Club, and NASA Space Apps are great for beginners, but they lock organizers into rigid formats that don't deliver. We're building the alternative. Anyone can participate, but they'll be surrounded by people who actually want to ship, not just attend.

1.2 The Origin Story

We were hosting Daydream Lucknow under Hack Club. Everything was set: venue, sponsors, participants. At the last moment, Hack Club pulled the venue. So we went fully independent and built the entire hackathon in 13 days flat. That's probably the most honest thing we can tell you about us. We don't quit, and we don't make excuses.

1.3 Brand Kit

Bits&Bytes uses a compact, production-friendly visual identity. Key elements:

  • Brand Mark: A 3D cube monogram (the cube contains a stylized 'BB' and a small star accent). Use the full wordmark for large headings and the cube mark for constrained spaces (avatars, favicons). Prefer a white reversed mark on dark backgrounds; use single-color marks on light backgrounds. Always maintain clear space around the mark.

  • Typography:

    • Primary: Helvetica Now — headings and display (use heavier weights for emphasis).
    • Secondary: Georgia Pro — body copy and long-form reading.
    • Accent (script): Palm Club — decorative hero treatments only.
    • Accent (display): Anton — condensed display accents used sparingly.

  • Color System:

    • Burgundy (Core gradient): Base: #97192C → #791423 → #5B0F1A → #3C0A12 → #1E0509
    • Neutrals: #120F0A, #413F3B, #716F6C, #A09F9D, #D0CFCE
    • Accent / Orange (pop gradient): #FC920D → #FDA83D → #FDBE6E → #FED39E → #FEE9CF
    • Warm Accent Range: #C94218, #D46846, #DF8E74, #E9B3A3, #F4D9D1
    • Utility / Interaction: Vibrant Pink #E45A92, Rich Plum #5D2F77, Deep Purple #3E1E68

    Design guidance: treat burgundy/plum as the core voice (serious and composed); use the orange gradient for emphasis and pops; prefer layered gradients for depth; and use the neutral scale to keep layouts clean.

  • Visual Elements:

    • Use gradients (Vibrant Pink → Rich Plum → Deep Purple) for hero backgrounds.
    • Halftone/stipple textures, geometric checks, and a small star/sparkle motif are approved decorative elements. Apply as subtle overlays to add texture without reducing legibility.

  • Logo usage & assets: keep vector SVGs for web/print, provide monochrome variants, and do not distort, rotate, or apply unapproved color treatments.

Refer to public/llms.txt Brand Kit section for the canonical palette and typography guidance.

2. Agent Directory (Who Does What?)

Quick reference for "who to ping for what".

Name Role Superpowers
Yash Singh Co-Founder & Organisation Lead Competitive Math, AI Prototyping, Full-Stack Dev, Event Ops
Aadrika Maurya Co-Founder & Chief Creative Strategist Neuroscience Research (EEG), Brand Strategy, Creative Direction
Akshat Kushwaha Co-Founder & Technical Lead Production Infrastructure, AI/LLMOps, System Reliability
Devaansh Pathak Founding Member & Backend Lead Backend Architecture, Partnership Economics
Maryam Fatima Social Media & Promotions Head Visual Design, Campaign Strategy, Social
Sristhi Singh Operations & Communications Head Logistics, Internal Comms, Coordination

Volunteers (Creatives, Tech, Outreach)

Bits&Bytes is supported by a volunteer network:

  • Creatives: Jaagruti, Kavan, Vareesha, Aishwary, and Shantanu Joshi
  • Tech: Hridyansh, Areeb, and Prakhar
  • Outreach: Adithya, Atharva, and Aanjaneya

3. Agent Profiles

3.1 Leadership

Yash Singh – Co-Founder & Organisation Lead

  • Expertise: Mathematics (IOQM), AI Prototyping, Full-Stack Dev, Hardware Experiments
  • Achievements:
    • Created Codiva, a 5-star rated VS Code extension with thousands of users.
    • National Qualifier for the Indian Mathematics Olympiad (IOQM).
    • Built AI projects including laser pushup detection systems and PDF scrapers.
    • Lead Organizer for Scrapyard Lucknow and GDS MUN. Mentor at NASA Space Apps Challenge (helping 400+ participants).
    • Educator at STEMist Lucknow, teaching CS to underprivileged students.
  • Profiles:
  • Owns: Organizational strategy, event timelines, and outreach. The operator instincts and community connections that make events actually execute.

Aadrika Maurya – Co-Founder & Chief Creative Strategist

Akshat Kushwaha – Co-Founder & Technical Lead

  • Expertise: AI-Native Engineering, Retrieval Systems, System Reliability, LLMOps
  • Achievements:
    • Ex Jr. Research Engineer at jhana.ai at 17, where he built production AI systems including a Steno dictation plugin and AI-era IVRS.
    • Builds production workflows and retrieval architectures that survive real constraints.
    • Built the entire Bits&Bytes tech infrastructure from scratch.
  • Profiles:
  • Owns: The entire tech stack, the infra, and anything that needs to actually work under pressure.

4. Track Record

  • Scrapyard Lucknow: 40+ coders, designers, and filmmakers in one room. Executed in 13 days.
  • India Innovates 2026: Official Executive Partner for the World's Largest Civic Tech Hackathon with 1.26 crore+ applicants.
  • Execron 1.0: Co-hosted AI Hackathon & Workshop at IIT Kanpur for students in Classes 9–12.
  • GitHub Copilot Dev Days: Hosted community developer event focused on AI-assisted coding in Lucknow.
  • Lucknow Build Guild: Free hardware workshop and meetup for local tech people.
  • NASA Space Apps Challenge Lucknow: 300+ participants.
  • CodeDay Hackathons: Across Lucknow, Delhi, and Dehradun.
  • Web Presence: gobitsnbytes.org serves thousands of monthly visitors with 1,500+ active members and 130+ shipped projects.
  • Evaluation Throughput: 2,700+ project submissions reviewed in 3-day sprints.

5. How We Work

5.1 Core Principles

  1. High Agency ONLY – We don't do hand-holding. We build for people who want to ship.
  2. Ship Real Products – Workshops and hack nights must end with something shipped, not just something learned.
  3. Collaboration First – We default to pairing and sharing context.
  4. Resilience – We don't make excuses; we ship regardless of obstacles.

5.2 Technical Guidelines

  1. Performance First – Optimized for speed (TTFB, LCP, INP).
  2. Always Optimized – Production-grade code is mandatory; no "just for fun" hacks on core infra.
  3. Use PNPM – Always use pnpm for speed and consistency.

6. AI Assistant & RAG Maintenance

  • The repository includes an on-page AI assistant that answers from two sources:
    • live page context (client pathname and optional page snippets sent by the client), and
    • a semantic RAG index stored in Supabase (site_embeddings) and queried via lib/rag.ts.
  • Embeddings are generated with openai/text-embedding-3-small through the Hack Club proxy (HACKCLUB_PROXY_API_KEY) by scripts/embed-site.ts.
  • The embed script currently indexes public/llms.txt and agents.md (keeping these files current keeps the RAG index up to date).
  • To refresh the RAG index after content changes run:
npx tsx scripts/embed-site.ts
  • A Husky pre-push hook runs the embedding step automatically when tracked source paths change; see .husky/pre-push for EMBED_PATHS.
  • To add more content to the index, update scripts/embed-site.ts filePaths and the .husky/pre-push EMBED_PATHS variable.

Last updated: May 2026