Skip to content

agents.md

Latest commit

 

History

History
132 lines (96 loc) · 7.01 KB

agents.md

File metadata and controls

132 lines (96 loc) · 7.01 KB

Bits&Bytes Team – Agents Handbook

Mission: Empowering ambitious teenagers to ship meaningful tech through premium hackathons, design/dev squads, and real-world product launches.
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 is great at, and how we collaborate to ship high‑impact, production-grade projects fast.

1. Brand & Identity

1.1 Mission & Vision

We move away from "beginner-friendly" formats that treat participants like they need constant hand-holding. We build space for exceptionally talented, high-agency individuals who want to ship real products, not just prototypes.

1.2 The Origin Story

Originally hosting Daydream Lucknow under Hack Club, we faced a last-minute venue withdrawal with everything already set. Instead of quitting, we went fully independent and realized that independence allows us to bypass the rigid formats of global orgs and deliver actual sponsor ROI and participant value.

1.3 Brand Kit

Bits&Bytes uses a compact, production-friendly visual identity designed for high-impact student-led communications. 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 the project's brand board and public/llms.txt Brand Kit section for the canonical palette, typography guidance, and visual examples.

2. Agent Directory (Who Does What?)

Quick reference for “who to ping for what”.

Name Role Superpowers
Yash Singh Co-Founder & Organisation Lead STEM Prodigy, AI Prototyping, Competitive Math, Debate
Aadrika Maurya Co-Founder & Chief Creative Strategist Neuroscience Research (EEG), Brand Strategy, Regional Management
Akshat Kushwaha Co-Founder & Technical Lead Production-Grade Engineering, AI/LLMOps
Devaansh Pathak Founding Member & Backend Lead Backend Architecture, Partnership Economics, Database Systems
Maryam Fatima Social Media & Promotions Head Impact Storytelling, Visual Design, Campaign Strategy
Sristhi Singh Operations & Communications Head Process Optimization, Logistics, Internal Comms

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).
    • Lead Organizer for Scrapyard Lucknow and 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 high-impact outreach.

Aadrika Maurya – Co-Founder & Chief Creative Strategist

Akshat Kushwaha – Co-Founder & Technical Lead

  • Expertise: AI-Native Engineering, Retrieval Systems, System Reliability, LLMOps
  • Achievements:
    • AI-native systems engineer who asks what happens when software fails—building production workflows and retrieval architectures that survive real constraints.
    • Lead at STEMist Prayagraj: Defining high-performance engineering culture for young builders across the city.
    • Lead Architect: Built the entire Bits&Bytes production-grade tech infrastructure from scratch.
  • Profiles:
  • Owns: System architecture, technical stability, and shifting the club towards production-ready software.

4. Track Record

  • Scrapyard Lucknow: 80 registrations, 50 participants, 10k+ impressions. Executed in 13 days.
  • NASA Space Apps Challenge Lucknow: 300+ participants.
  • CodeDay Hackathons: Across Lucknow, Delhi, and Dehradun.
  • Web Presence: gobitsnbytes.org serves thousands of monthly visitors with 1000+ active members.

5. How We Work

5.1 Core Principles

  1. High Agency ONLY – We don't do hand-holding. We build for thinkers and builders.
  2. Ship Real Products – Workshops and hack nights must convert into tangible outcomes.
  3. Collaboration First – We default to pairing and sharing context.
  4. Resilience – We don't make excuses; we ship regardless of obstacles (e.g., the venue incident).

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.

Last updated: April 6, 2026