Project Story
💡 Inspiration
As a developer looking to break into remote opportunities, open-source communities, and advanced AI engineering, I repeatedly faced the same frustrating barrier: joining new codebases takes weeks of confusion. Documentation is almost always outdated, system architecture is opaque, and senior engineers rarely have time to explain the system layout.
When GitLab announced the Transcend Hackathon, I realized that the GitLab Orbit Knowledge Graph was the missing link. I wanted to build a practical tool that eliminates this bottleneck by transforming raw repository context into immediate engineering productivity.
🚀 What it Does
Orbit Onboarding Maestro is an automated GitLab Duo Skill that queries the Orbit Knowledge Graph to instantly generate personalized, visual, and adaptive onboarding ecosystems.
Activating the "Full Onboarding Workflow" executes a series of hands-off system operations:
- Graph-Driven Ingestion: Indexes the repository data directly through local Orbit graph data.
- Deep Analytics: Runs five concurrent DuckDB SQL queries across code files, definitions, imports, and cross-module relationships to maximize context efficiency without bloating token utilization.
- Visual Blueprints: Automatically maps code structures into Markdown guides containing live Mermaid sequence diagrams and interactive dependency charts.
- Asynchronous Syncing: Provisions a live GitLab Wiki page and logs idempotent sync histories.
- Task Orchestration: Launches a structured GitLab Issue tracker equipped with milestones, environment setup guides, and first-PR checklists.
- 🧠 Adaptive Memory Journal: Tracks explored code paths to learn user progress and serve personalized, next-step learning suggestions.
🛠️ How I Built It
The architecture combines rapid full-stack prototyping with deep, local infrastructure integration:
- Frontend & Visualizations: Built using Next.js, shadcn/ui, Recharts, and ReactFlow for the dependency maps, initiated with Lovable.dev.
- Core Engine: Engineered with Cursor and VS Code utilizing the
glab orbit localCLI and DuckDB SQL query infrastructure. - Ecosystem Integration: Leveraged the GitLab REST API for background Wiki provisioning and Issue creation, strictly following the official GitLab Duo Skill format.
🛑 Challenges Faced
- Context & State Constraints: Dealt with indexing complexities due to anomalous workspace configurations and folder paths, which required rewriting graph query loops to cleanly pull from the Orbit engine.
- Beyond the Chat Loop: Engineering true task orchestration (Issues, Wikis, Journals) that functions automatically without trapping the user in a repetitive prompt-and-chat loop, while keeping the UI highly performant.
- Enterprise Governance: Designing the automated updates to log actions transparently, aligning with enterprise needs for auditable agent footprints.
🎓 What I Learned & The Impact
This hackathon proved that AI agents are only as powerful as the structural context backing them. The GitLab Orbit Knowledge Graph provides an unparalleled foundation for deterministic, high-accuracy automation. Beyond the code, I mastered rapid full-stack context integration, the GitLab Duo Skill framework, and the paradigm of building context-efficient, enterprise-ready AI tools.
Orbit Onboarding Maestro is more than a hack — it is an end-to-end orchestration agent designed to scale developer productivity from day one.
Built with passion for the GitLab Transcend Hackathon 2026.
Built With
- gitlabduoagentplatform
- gitlaborbit
- gitlabrestapi
- glaborbitlocal
- localstorage
- next.js15
- recharts+reactflow
- tailwindcss+shadcn/ui
- tanstack
- typescript
- vite
Log in or sign up for Devpost to join the conversation.