Files
hive/docs/quizzes/01-getting-started.md
T
Vincent Jiang c51c1ff754 Add engineering challenges and scripts for GitHub topics
- Created quizzes for various engineering tracks: Getting Started, Architecture Deep Dive, Build Your First Agent, Frontend Challenge, and DevOps Challenge.
- Added README for the quizzes directory to guide users through the challenges.
- Implemented a script to set GitHub repository topics for adenhq/hive using GitHub CLI.
2026-01-19 19:41:30 -08:00

4.9 KiB

🚀 Getting Started Challenge

Welcome to Aden! This challenge will help you get familiar with our project and community. Complete all tasks to earn your first badge!

Difficulty: Beginner Time: ~30 minutes Prerequisites: GitHub account


Part 1: Join the Aden Community (10 points)

Task 1.1: Star the Repository

Show your support by starring our repo!

  1. Go to github.com/adenhq/hive
  2. Click the Star button in the top right
  3. Screenshot your starred repo (showing the star count)

Task 1.2: Watch the Repository 👁️

Stay updated with our latest changes!

  1. Click the Watch button
  2. Select "All Activity" to get notifications
  3. Screenshot your watch settings

Task 1.3: Fork the Repository 🍴

Create your own copy to experiment with!

  1. Click the Fork button
  2. Keep the default settings and create the fork
  3. Screenshot your forked repository

Task 1.4: Join Discord 💬

Connect with our community!

  1. Join our Discord server
  2. Introduce yourself in #introductions
  3. Screenshot your introduction message

Part 2: Explore Aden (15 points)

Task 2.1: README Scavenger Hunt 🔍

Find the answers to these questions by reading our README:

  1. What are the three LLM providers Aden supports out of the box?
  2. How many MCP tools does the Hive Control Plane provide?
  3. What is the name of the frontend dashboard?
  4. In the "How It Works" section, what is Step 5?
  5. What city is Aden made with passion in?

Task 2.2: Architecture Quiz 🏗️

Based on the architecture diagram in the README:

  1. What are the three databases in the Storage Layer?
  2. Name two components inside an "SDK-Wrapped Node"
  3. What connects the Control Plane to the Dashboard?
  4. Where does "Failure Data" flow to in the diagram?

Task 2.3: Comparison Challenge 📊

From the Comparison Table, answer:

  1. What category is CrewAI in?
  2. What's the Aden difference compared to LangChain?
  3. Which framework focuses on "emergent behavior in large-scale simulations"?

Part 3: Quick Code Exploration (15 points)

Task 3.1: Project Structure 📁

Clone your fork and explore the codebase:

git clone https://github.com/YOUR_USERNAME/hive.git
cd hive

Answer these questions:

  1. What is the main frontend folder called?
  2. What is the main backend folder called?
  3. What file would you edit to configure the application?
  4. What's the Docker command to start all services (hint: check README)?

Task 3.2: Find the Features 🎯

Look through the codebase to find:

  1. Where are the MCP tools defined? (provide the file path)
  2. What port does the API run on? (hint: check README or docker-compose)
  3. Find one TypeScript interface related to agents (provide file path and interface name)

Part 4: Creative Challenge (10 points)

Task 4.1: Agent Idea 💡

Aden can build self-improving agents for any use case. Propose ONE creative agent idea:

  1. Name: Give your agent a catchy name
  2. Goal: What problem does it solve? (2-3 sentences)
  3. Self-Improvement: How would it get better over time when things fail?
  4. Human-in-the-Loop: When would it need human input?

Example format:

Name: DocBot
Goal: Automatically keeps documentation in sync with code changes.
      Monitors PRs and updates relevant docs.
Self-Improvement: When docs get rejected in review, it learns the feedback
                  and adjusts its writing style and coverage.
Human-in-the-Loop: Major architectural changes require human approval
                   before doc updates go live.

Submission Checklist

Before submitting, make sure you have:

  • Screenshots from Part 1 (Star, Watch, Fork, Discord)
  • Answers to all Part 2 questions
  • Answers to all Part 3 questions
  • Your creative agent idea from Part 4

How to Submit

  1. Create a GitHub Gist at gist.github.com
  2. Name it aden-getting-started-YOURNAME.md
  3. Include all your answers and screenshots (use image hosting like imgur for screenshots)
  4. Email the Gist link to careers@adenhq.com
    • Subject: [Getting Started Challenge] Your Name
    • Include your GitHub username

Scoring

Section Points
Part 1: Community 10
Part 2: Explore 15
Part 3: Code 15
Part 4: Creative 10
Total 50

Passing score: 40+ points


What's Next?

After completing this challenge, choose your specialization:


Good luck! We're excited to see your submissions! 🎉