Table of Contents

End-to-End Workflow

A complete walkthrough of the AI agent pipeline from issue creation to merged PR.

What this page covers

  • Creating a well-formed issue in YouTrack that agents can act on
  • The issue-resolver agent run: what happens step by step
  • The pr-reviewer agent run: review and approval
  • The pr-resolver agent run: handling requested changes
  • Human checkpoints and override points
  • Monitoring agent runs via Gitea Actions logs and Discord notifications

Step 1: Create an issue

Write a clear, specific issue in YouTrack:

  • Summary: concise description of the change
  • Description: context, acceptance criteria, specific files or functions to change
  • Stage: To DO
  • AI State: Ready
  • Git Repo: the repository name (e.g., my-service)

Step 2: issue-resolver runs

The issue-resolver agent is triggered by a Gitea Actions workflow (scheduled or manual). It:

  1. Queries YouTrack for issues where AI State = Ready and Git Repo matches the repository.
  2. Picks the first eligible issue.
  3. Sets Stage = In Progress, AI State = Progressing.
  4. Creates a feature branch and implements the change.
  5. Opens a PR and sets AI State = Done on the issue.

Step 3: pr-reviewer runs

The pr-reviewer reviews the PR diff and either approves or requests changes with specific comments.

Step 4: pr-resolver runs (if changes requested)

The pr-resolver reads review comments, implements the fixes, and pushes updates.

Step 5: human merges

A human reviews the final PR and merges it. The issue moves to Done.