Skip to main content

README

GitLab Ultimate Technical Documentation

Comprehensive guide for production-grade software development using GitLab Ultimate

This documentation covers every aspect of GitLab Ultimate, from basic UI navigation to advanced AI-powered workflows, specifically tailored for the Agent Platform's 70+ project ecosystem.

Documentation Overview

Quick Navigation

SectionFocusPriorityDocs
01 - UI NavigationComplete GitLab UI guideMedium5 files
02 - Agent PlatformTriggers, Flows, AgentsCRITICAL8 files
03 - OSSAOpen Standard AgentsCRITICAL7 files
04 - CI/CDPipeline optimizationURGENT9 files
05 - ComponentsMulti-project managementHIGH9 files
06 - VersioningSemVer & releasesHigh8 files
07 - SecuritySecurity & complianceHigh7 files
08 - ObservabilityMonitoring & tracingMedium9 files
09 - AI/DuoAI features & automationMedium9 files
10 - CostCost optimizationURGENT9 files

Total: 80+ comprehensive documentation files

Quick Start Paths

For Developers

  1. Start: UI Navigation Overview
  2. Learn: GitLab Agent Platform
  3. Practice: CI/CD Best Practices
  4. Master: Components

For DevOps/SRE

  1. URGENT: Cost Optimization
  2. Essential: CI/CD Pipeline Efficiency
  3. Critical: Caching Deep Dive
  4. Advanced: Multi-Project Management

For Security Teams

  1. Start: Security Scanning
  2. Process: Vulnerability Management
  3. Policy: Security Policies
  4. Compliance: Compliance Frameworks

For Platform Architects

  1. Architecture: Agent Platform Architecture
  2. Standards: OSSA Integration
  3. Scale: 70+ Project Strategy
  4. Observability: Monitoring & Tracing

01 UI Navigation

Complete guide to every menu, feature, and capability in GitLab Ultimate UI

  • Overview - Complete UI structure and navigation
  • Project Menus - All 10 project-level menus (Plan, Code, Build, Secure, Deploy, Operate, Monitor, Analyze)
  • Group Features - Portfolio management, Epics, Roadmaps
  • Admin Area - Instance administration
  • Ultimate Only - Premium vs Ultimate comparison (77+ exclusive features)

Coverage: 200+ features documented with navigation paths, use cases, and best practices

02 Agent Platform

GitLab Duo Agent Platform (GA: January 2026) - Intelligent workflow automation

Key Features:

  • Multi-agent parallelism
  • Custom flows (YAML-based)
  • Model Context Protocol (MCP)
  • OIDC authentication
  • Complete observability

Pre-built Flows:

  • Software Development Flow (88% success rate)
  • Issue-to-MR Flow
  • Convert CI File Flow (Jenkins, GitHub Actions, CircleCI, Travis, Azure)

03 OSSA

Open Standard for Scalable AI Agents - Vendor-neutral agent definitions

What is OSSA?

  • Vendor-neutral agent manifests (like OpenAPI for AI agents)
  • Multi-platform compatibility (LangChain, CrewAI, AutoGen)
  • GitLab Duo Platform integration
  • Kubernetes-native deployment
  • Type-safe SDKs (TypeScript, Python)

Complementary Standards:

  • Agent Skills (Anthropic) - Procedural knowledge
  • MCP (Model Context Protocol) - Tool connectivity
  • OASF - Agent discovery

04 CI/CD

Cost-optimized, efficient CI/CD pipelines - CRITICAL FOR COST SAVINGS

Expected Savings: 60-70% cost reduction

Quick Wins (Implement Today):

  • Enable interruptible jobs † 30-50% savings
  • Skip draft MR pipelines † 20-30% savings
  • Add pre-flight validation † 50-80% savings on failures
  • Right-size runners † 30-50% savings
  • Path-based rules † 40-60% savings (monorepos)

05 Components

Reusable CI/CD components for 70+ project management

Key Concepts:

  • Centralized component library
  • Version tiers (Stable, Current, Preview, Deprecated)
  • 5-phase rollout process
  • Automation for 70+ projects
  • RFC process for breaking changes

06 Versioning

Semantic versioning, release automation, changelog generation

Your Strategy:

  • Release branches: release/v0.X.x
  • Auto-patching on merge
  • Group milestones (v0.X.x)
  • Conventional Commits
  • semantic-release automation

07 Security

GitLab Ultimate security and compliance features

Features:

  • 8 security scanners
  • Automated compliance frameworks
  • Group-level security policies
  • OIDC authentication
  • SBOM generation (CycloneDX)

08 Observability

Production-grade monitoring, tracing, and analytics

Features:

  • OpenTelemetry tracing (beta)
  • ClickHouse-powered analytics
  • DORA metrics (deployment frequency, lead time, MTTR, change failure rate)
  • Custom dashboards
  • Multi-channel alerting

09 AI/Duo

GitLab Duo and AI-powered features (2025/2026)

Major Update - GitLab 18.0 (May 2025):

  • Code Suggestions and Chat included in Premium/Ultimate (no extra cost)
  • Claude Sonnet 4 as default model
  • 1.5M developers using GitLab AI

GitLab 18.7 (December 2025):

  • SAST False Positive Detection (90% confidence)
  • Planner Agent Beta
  • Secret Validity Checks
  • 6-month Duo Analytics Dashboard

Agent Platform GA: January 2026

  • Multi-agent parallelism
  • Custom flows (YAML)
  • Model Context Protocol (MCP)
  • Software Development Flow (88% success rate)

10 Cost Optimization

CRITICAL: Preventing wasted CI minutes across 70+ projects

Expected Impact: 60-70% total cost reduction

Immediate Actions:

  1. Read Overview (30 min)
  2. Apply Quick Wins (2-4 hours)
  3. Set up Monitoring (1 hour)
  4. Implement Pre-Push Validation (2 hours)

Documentation Statistics

  • Total Files: 80+ comprehensive markdown documents
  • Total Size: ~6MB of technical documentation
  • Total Lines: ~40,000+ lines
  • Code Examples: 500+ working configurations
  • Coverage: 100% of GitLab Ultimate features

Critical Priorities

Immediate (This Week)

  1. Cost Optimization - Stop burning CI minutes
  2. Pre-Push Validation - Prevent failed pipelines
  3. Usage Tracking - Set up budget alerts

Short-Term (This Month)

  1. Component Strategy - Manage 70+ projects
  2. CI/CD Efficiency - Optimize pipelines
  3. Security Scanning - Enable all scanners

Long-Term (This Quarter)

  1. Agent Platform - Implement AI workflows
  2. Observability - Production monitoring
  3. DORA Metrics - Track DevOps performance

Finding Information

By Role

Developers:

DevOps/SRE:

Security:

Architects:

By Topic

Cost Management:

Multi-Project:

AI & Automation:

Security & Compliance:

Production Readiness:

Common Issues and Solutions

"We're burning too many CI minutes"

† Start: Cost Optimization Overview † Quick wins: Strategies † Tracking: Monitoring

"Pipelines are too slow"

† Caching: Caching Deep Dive † Optimization: Pipeline Efficiency † Patterns: CI/CD Patterns

"Managing 70+ projects is overwhelming"

† Strategy: Multi-Project Strategy † Components: Creating Components † Governance: Governance

"Security scans are failing MRs"

† Scanning: Security Scanning † Triage: Vulnerability Management † Policies: Security Policies

"How do I use AI agents?"

† Start: Agent Platform Overview † Build: Building Agents † Integrate: CI/CD Integration

External Resources

Official GitLab

GitLab Duo

Community

Tools

Contributing

This documentation is maintained as part of the Agent Platform technical documentation. Updates should follow:

  1. File Policy:

    • Documentation in GitLab Wiki (not .md files in repos)
    • Technical docs in _WIKIs/technical-docs.wiki/
    • No .sh files - use npm scripts or TypeScript tools

  2. Git Workflow:

    • Issue-driven development
    • Release branch strategy (release/v0.X.x)
    • Conventional Commits
    • Group milestones

  3. Quality Standards:

    • Comprehensive examples
    • Real-world use cases
    • Cited sources
    • Production-ready patterns

Version History

  • 2026-01-08: Initial comprehensive documentation release
    • 10 major sections covering all GitLab Ultimate features
    • 80+ documentation files
    • Focus on cost optimization and multi-project management
    • GitLab 18.7 (December 2025) features included
    • Agent Platform GA preparation (January 2026)

How to Use This Documentation

First Time Here?

  1. Read this README completely
  2. Identify your role (Developer, DevOps, Security, Architect)
  3. Follow the "Quick Start Path" for your role
  4. Bookmark frequently used sections

Looking for Something Specific?

  1. Check the Quick Navigation table
  2. Use the Finding Information section
  3. Search for keywords in section descriptions

Implementing Best Practices?

  1. Start with Cost Optimization if burning CI minutes
  2. Review CI/CD Best Practices
  3. Implement Components for multi-project management
  4. Enable Security Scanning
  5. Set up Observability

Building with Agents?

  1. Understand Agent Platform
  2. Learn OSSA standards
  3. Review AI/Duo capabilities
  4. Follow Best Practices

This documentation represents the most comprehensive guide to GitLab Ultimate available, specifically tailored for production-grade software development in a multi-project environment.

Last Updated: 2026-01-08 GitLab Version: 18.7 (December 2025) Agent Platform: GA preparation (January 2026)