Skip to content

[AGENT] Repository-Based Reusable Workflow Builder #18

@antgrutta

Description

@antgrutta

Which migration agent does this relate to?

  • Jenkins Migrator
  • Azure DevOps Migrator
  • CircleCI Migrator
  • GitLab Migrator
  • Travis CI Migrator
  • Bamboo Migrator
  • Bitbucket Migrator
  • Drone CI Migrator
  • Reusable Workflow Builder
  • New platform (please specify)

Is this a bug or an improvement?

  • Bug - Agent produces incorrect output
  • Improvement - Agent could handle this better

Describe the issue or improvement

The current Reusable Workflow Builder agent requires GitHub organization names as input and performs broad scanning across all repositories in those organizations to discover CI/CD patterns. This approach has limitations:

  1. Overly broad scope — Scanning entire organizations pulls in repositories that may be irrelevant to the desired reusable workflows, adding noise to the pattern analysis.
  2. Lack of intent — The agent infers what reusable workflows to build solely from pattern frequency, with no way for the user to express what they actually need.
  3. Slow discovery — Enumerating and analyzing all repositories in large organizations is time-consuming when the user already knows which repositories are representative.

The updated agent should change its input model to accept:

  • A list of repositories (e.g., org/repo1, org/repo2) instead of organization names. This gives users precise control over which codebases are analyzed.
  • High-level requirements describing the type of reusable workflow(s) to build (e.g., "Create a reusable workflow for Node.js CI with linting, testing, and Docker image publishing" or "Build a standardized Terraform deployment workflow"). This lets users steer the output rather than relying entirely on automated pattern detection.

The agent should use the provided repositories as reference implementations — analyzing their existing CI/CD configurations to extract concrete patterns, versions, and configurations — then combine that analysis with the user's stated requirements to generate targeted reusable workflows.

Additional context

  • The current agent prompt expects input in the form: "Analyze organizations: [org1, org2, org3] for CI/CD patterns". The new input format should be something like: "Build reusable workflows from repositories: [org/repo1, org/repo2] — Requirements: [description of desired workflows]".
  • The agent should still support analyzing CI/CD files from multiple platforms (GitHub Actions, GitLab CI, Jenkins, Azure DevOps, etc.) within the specified repositories.
  • Pattern frequency analysis should be scoped to the provided repository list only, not expanded to the broader organization.
  • All existing output rules (reusable workflow files in .github/workflows/reusable-*.yml, usage docs in docs/<name>-usage.md, no scripts, no README files) should remain unchanged.
  • The high-level requirements should guide which patterns the agent prioritizes and what the generated workflows focus on, while the repository analysis provides the concrete implementation details.

Metadata

Metadata

Assignees

No one assigned

    Labels

    agentsNew and udpated Agents

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions