From Ticket to First Commit: Building a Graph-Powered Contribution Strategist with GitLab Orbit
Summary
Orbit Compass, a GitLab Duo Custom Agent developed during the GitLab Transcend Hackathon, addresses a common developer onboarding challenge by transforming issue tickets into actionable contribution roadmaps. The author, frustrated by scattered context across GitLab's tools, found traditional search and Retrieval-Augmented Generation (RAG) inadequate for understanding the "relationships" between development entities. This led to leveraging GitLab Orbit, a knowledge graph modeling issues, merge requests, files, and contributors. Initial LLM attempts failed due to a lack of graph schema understanding. The project then shifted to a deterministic investigation workflow, using Orbit's schema to identify historical context, relevant merge requests, modified files, dependencies, and active contributors. Key design principles included providing explicit evidence for recommendations, replacing numerical scores with qualitative categories (High, Medium, Low), generating fully qualified URLs, and prioritizing clear output. Testing showed Orbit Compass generates a comprehensive contribution roadmap, explaining the "why" behind code context.
Key takeaway
For AI Engineers building developer productivity tools, consider integrating knowledge graphs like GitLab Orbit to move beyond document retrieval. Your solutions should focus on reconstructing context by modeling "relationships" between development entities, not just finding information. Prioritize transparent, evidence-backed recommendations over opaque scoring, and ensure output clarity with fully qualified links to build user trust and provide actionable "next-step" guidance for contributors.
Key insights
Knowledge graphs excel at contextualizing software development relationships beyond simple search.
Principles
- Software development context relies on entity relationships.
- AI recommendations need explicit, verifiable evidence.
- Prioritize clarity and actionable "next-step" information.
Method
Orbit Compass uses a deterministic workflow: identify historical MRs, examine modified files, investigate dependencies, identify active contributors, and check for ongoing work.
In practice
- Model software entities as a knowledge graph.
- Expose reasoning paths for AI-generated recommendations.
- Replace numerical confidence scores with qualitative evidence.
Topics
- GitLab Orbit
- Knowledge Graphs
- Developer Productivity
- AI Agents
- Contributor Onboarding
- Explainable AI
Best for: AI Engineer, Machine Learning Engineer, Software Engineer
Related on AIssential
Editorial summary, takeaway, and curation by AIssential. Original article published by Artificial Intelligence on Medium.