Buildly Open Source Hackathon Kit

This repository contains the playbook, templates, issue guidance, and tool links for running a Buildly-style hackathon where teams move from idea to documented product to working prototype with open source, Buildly Labs, Buildly Forge, bb-agent MCP, and modern AI developer tools.

The goal is simple: help teams create useful products, document their decisions, design responsibly, and ship working code that another team could understand, reuse, and improve.

What Teams Will Build

Each team should leave the hackathon with:

• A clear product brief and problem statement.
• A lightweight product design package: users, journeys, screens, architecture, and API/service assumptions.
• A working prototype or service slice.
• A documented repository with setup, usage, and contribution notes.
• GitHub issues that show the work plan, decisions, and follow-up roadmap.
• A demo that explains both the product and the build process.

Start Here

• Hackathon Wiki
• Lab Workflow
• Tool Catalog
• AI and MCP Guidance
• Product Design Guide
• Judging Rubric
• Starter Issue

Suggested Flow

1. Discover: Define the user, problem, constraints, success metric, and open source surface area.
2. Design: Sketch the user flow, data model, service boundaries, and first prototype.
3. Build: Use Buildly and open source components where they reduce time or risk.
4. Vibe code responsibly: Use bb-agent MCP, Codex, GitHub Copilot, Cursor, Claude Code, or other AI coding tools with clear prompts, review, and tests.
5. Document: Keep decisions, setup, and API behavior in markdown as the product evolves.
6. Demo: Show the user problem, the prototype, what works, what is next, and what the team learned.

Core Links

• Buildly
• Buildly GitHub
• Buildly CollabHub onboarding
• Buildly Marketplace
• Buildly Component Library
• Model Context Protocol
• mcp-agent
• Open Source Guides
• GitHub Skills

Repository Map

docs/
  guidance/       Product, AI, documentation, and judging guidance
  issues/         Markdown issue examples and planning templates
  labs/           Lab-by-lab workshop flow
  tools/          Tool catalog and setup guidance
  wiki/           Wiki-style entry points and operating pages
.github/
  ISSUE_TEMPLATE/ GitHub issue forms for teams and organizers

License

This hackathon kit is open source under the repository license. Teams should confirm the licenses of any third-party code, models, datasets, templates, or assets they add to their own projects.