Skip to content

agents.md

Latest commit

 

History

History
215 lines (162 loc) · 14.2 KB

agents.md

File metadata and controls

215 lines (162 loc) · 14.2 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 Section 8 Company (GOBITSNBYTES FOUNDATION) · Independent Teen-Led Builder Network · Based in Lucknow, India · Serving builders nationwide

This handbook describes the core bits&bytes™ "agents" (team members), what each person does, how we collaborate, and our legal governance framework.

1. Brand & Identity

1.1 Mission & Vision

We're not a branch of any external student group. We're fully independent, fully student-led, and we run events on our own terms. Traditional structured networks 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

In July 2025, our team was organizing a major regional student hackathon under an external partner organization. By mid-August, the partner organization cancelled the event, which was a significant setback.

To overcome this uncertainty and avoid relying on external groups, we founded bits&bytes™ as a student-led network in November 2025. Originally, our goal was simply to gather everyone together and host a 24-hour independent hackathon to make up for the cancelled event. However, we quickly realized we could build something far more impactful and sustainable.

To establish a permanent, legally protected, and independent home for the network, GOBITSNBYTES FOUNDATION was incorporated as a Section 8 non-profit company on 2 June 2026. The Foundation is legally governed by its Board of Directors, which holds ultimate fiduciary, constitutional, and safeguarding authority over the Network.

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.

  • Name Usage: The primary brand spelling is "bits&bytes™". In contexts or environments where the ampersand character ("&") is unavailable, unsupported, or restricted (such as domains, email handles, code package repositories, or file system directories), "bitsnbytes" is the official, approved, and equivalent alternative. Both "bits&bytes" and "bitsnbytes" are approved brand descriptors.

  • 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

    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 Chief Executive Officer (CEO) Competitive Math, AI Prototyping, Full-Stack Dev, Event Ops
Akshat Kushwaha Chief Technology Officer (CTO) Production Infrastructure, AI/LLMOps, System Reliability, Operations
Aadrika Maurya Chief Creative Officer (CCO) & Chief Operating Officer (COO) Neuroscience Research (EEG), Brand Strategy, Creative Direction
Devaansh Pathak Chief Financial Officer (CFO) Backend Architecture, Partnership Economics
Drishti Arora Chief Marketing Officer (CMO) Marketing Strategy, Brand Growth, Campaign Management
Raghwender Vasisth Head of Operations Operations Management, Process Optimization, Resource Logistics
Maryam Fatima Head of Brand & Media Visual Design, Campaign Strategy, Social
Srishti Singh Head of Partnerships & Institutional Relations Logistics, Internal Comms, Coordination

Volunteers (Operations, Outreach, Creative, Tech)

bits&bytes™ is supported by a volunteer network:

  • Operations: Shantanu Joshi and Atharva
  • Outreach: Adithya and Aanjaneya
  • Creatives (Graphic + Video Editing): Jaagruti, Vareesha, and Aishwary
  • Tech: Hridyansh, Areeb, and Prakhar

Early Contributors

We are grateful to our early team members and contributors who helped build and shape the network during its initial sprints before moving on to new chapters:

  • Kavan, Saksham, Kaustubh, Oviya

3. Executive & Governance Framework

To protect our community and maintain Section 8 compliance, bits&bytes™ operates under a structured legal division of authority between Upstream governance and operational teams.

3.1 The Board of Directors

The Board of Directors holds ultimate legal, fiduciary, financial, and safeguarding authority over GOBITSNBYTES FOUNDATION.

  • Powers: Approving strategic plans, managing formal banking/accounts, entering into legal contracts/leases, setting the Authority Matrix, and deciding on Fork Recognition, Suspension, or Revocation.
  • Privacy Notice: In accordance with internal security and operational protocols, the names of the individual directors are kept private from public-facing marketing and community documentation. They are referenced collectively as the Board of Directors.

3.2 Executive Officers (Operational Team)

Executive Officers are appointed by the Board under Article 28 of the e-Articles of Association (e-AOA) for day-to-day operations.

  • Operational Status: Titles like CEO, CTO, COO, CFO, and CMO represent specific operational management domains.
  • Signing & Fiduciary Limits: Because bits&bytes™ is intentionally youth-led and includes minors, the designation of an Executive Officer does not automatically confer statutory directorship, legal membership, signature authority, banking access, or the power to bind the Foundation. All formal commitments, contracts, and bank operations must be routed through written Board authorizations.

3.3 Fork Network Model

A Fork is a recognized local, institutional, or thematic operating unit of the bits&bytes™ Network recognized under authority of the Board.

  • Participation Only: Fork Recognition is an operational, brand-use, and community permission only.
  • No Independent Agency: A Fork does not constitute a separate legal entity, franchise, branch office, joint venture, partnership, or subsidiary. A Fork has no authority to bind, contract, represent, or collect funds on behalf of GOBITSNBYTES FOUNDATION. All local fundraising, sponsor deals, and venue contracts must be routed to Upstream for written legal execution.

3.4 Minor Safeguarding & Data Rules

Because many participants are minors, the Foundation enforces rigorous safety protocols:

  • Statutory Compliance: All activities, data processing, and communications involving minors are governed by the Protection of Children from Sexual Offences Act, 2012 (POCSO) and the Digital Personal Data Protection Act, 2023 (DPDP Act).
  • Parental Consent: Verified parent or guardian consent is mandatory for minor participation in events, travel, photography, or public showcases.
  • Safety Records: Safeguarding reports and incident files are kept strictly confidential, secure, and shared only on a strict need-to-know basis. Safeguarding decisions override any concepts of local autonomy.

4. Agent Profiles

4.1 Leadership

Yash Singh – Chief Executive Officer

  • 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 local developer meetups and GDS MUN. Mentor at national student hackathons (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 – Chief Creative Officer & Chief Operating Officer

Akshat Kushwaha – Chief Technology Officer

  • Expertise: Core Systems Engineering, AI-Native Systems, Retrieval Architectures, LLMOps
  • Achievements:
    • Primary systems architect and lead engineer on the team.
    • 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, operations, and anything that needs to actually work under pressure.

Devaansh Pathak – Chief Financial Officer

  • Expertise: Backend Architecture, Database Systems, Partnership Economics
  • Achievements:
    • Co-Architected the high-performance backend systems for the bits&bytes™ platform.
    • Executed partnerships that delivered genuine ROI for sponsors across multiple cities.
  • Profiles:
  • Owns: Financial operations, partnership economics, and backend architecture.

Drishti Arora – Chief Marketing Officer

  • Expertise: Marketing Strategy, Brand Growth, Campaign Management, Audience Development
  • Profiles:
  • Owns: Marketing strategy, brand growth, and audience development across all channels.

Raghwender Vasisth – Head of Operations

  • Expertise: Operations Management, Process Optimization, Resource Logistics, Team Coordination
  • Profiles:
  • Owns: Operational excellence, process optimization, and keeping the organization running at scale.

5. Track Record

  • 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.
  • Regional Space Apps Hackathon: 300+ participants.
  • Web Presence: gobitsnbytes.org serves thousands of monthly visitors with 1,400+ active members.
  • Evaluation Throughput: 2,700+ project submissions reviewed in 3-day sprints.

6. How We Work

6.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.

6.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.

7. 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: June 2026