- 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.
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!
- Go to github.com/adenhq/hive
- Click the Star button in the top right
- Screenshot your starred repo (showing the star count)
Task 1.2: Watch the Repository 👁️
Stay updated with our latest changes!
- Click the Watch button
- Select "All Activity" to get notifications
- Screenshot your watch settings
Task 1.3: Fork the Repository 🍴
Create your own copy to experiment with!
- Click the Fork button
- Keep the default settings and create the fork
- Screenshot your forked repository
Task 1.4: Join Discord 💬
Connect with our community!
- Join our Discord server
- Introduce yourself in
#introductions - 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:
- What are the three LLM providers Aden supports out of the box?
- How many MCP tools does the Hive Control Plane provide?
- What is the name of the frontend dashboard?
- In the "How It Works" section, what is Step 5?
- What city is Aden made with passion in?
Task 2.2: Architecture Quiz 🏗️
Based on the architecture diagram in the README:
- What are the three databases in the Storage Layer?
- Name two components inside an "SDK-Wrapped Node"
- What connects the Control Plane to the Dashboard?
- Where does "Failure Data" flow to in the diagram?
Task 2.3: Comparison Challenge 📊
From the Comparison Table, answer:
- What category is CrewAI in?
- What's the Aden difference compared to LangChain?
- 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:
- What is the main frontend folder called?
- What is the main backend folder called?
- What file would you edit to configure the application?
- What's the Docker command to start all services (hint: check README)?
Task 3.2: Find the Features 🎯
Look through the codebase to find:
- Where are the MCP tools defined? (provide the file path)
- What port does the API run on? (hint: check README or docker-compose)
- 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:
- Name: Give your agent a catchy name
- Goal: What problem does it solve? (2-3 sentences)
- Self-Improvement: How would it get better over time when things fail?
- 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
- Create a GitHub Gist at gist.github.com
- Name it
aden-getting-started-YOURNAME.md - Include all your answers and screenshots (use image hosting like imgur for screenshots)
- Email the Gist link to
careers@adenhq.com- Subject:
[Getting Started Challenge] Your Name - Include your GitHub username
- Subject:
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:
- Backend Engineers: 🧠 Architecture Deep Dive
- AI/ML Engineers: 🤖 Build Your First Agent
- Frontend Engineers: 🎨 Frontend Challenge
- DevOps Engineers: 🔧 DevOps Challenge
Good luck! We're excited to see your submissions! 🎉