Skip to content

Define Flow Registry contribution guidelines

Background

The Flow Registry framework (referenced at https://gitlab.com/gitlab-org/modelops/applied-ml/code-suggestions/ai-assist/-/tree/main/docs/flow_registry) provides a centralized system for building agentic flows for Duo Agent Platform. Currently, product groups lack clear guidance on how to contribute their components, which could lead to:

  • Inconsistent component implementations
  • Duplicated efforts across teams
  • Difficulty in maintaining and scaling the framework
  • Barriers to adoption by product groups

Objectives

Create comprehensive contribution guidelines that cover:

1. Component Architecture Standards

  • Define the structure and interface requirements for Flow Registry components
  • Establish naming conventions and organizational patterns
  • Specify required metadata and configuration formats

2. Development Workflow

  • Step-by-step process for contributing new components
  • Code review requirements and approval processes
  • Testing standards and requirements
  • Documentation expectations

3. Integration Guidelines

  • How to register components with the Flow Registry
  • Dependency management and version compatibility
  • Configuration
  • Monitoring and observability requirements

4. Quality Assurance

  • Code quality standards and linting rules
  • Performance benchmarks and optimization guidelines
  • Security considerations and compliance requirements