1

Workflow

Jason Walker edited this page 2026-07-06 01:36:36 -04:00

Table of Contents

• Workflow Model
• Navigation
• Step 1: Review queue first (reviewer profile)
• Step 2: Implement issues (author profile)
• Step 3: Operator follow-ups

Workflow Model

Navigation

• Home | Operator Guide | Repositories Map | Identity and Profiles | Workflow Model | Safety and Gates | MCP Tools Reference | Operator Runbooks | Open Decisions | Project History

Step 1: Review queue first (reviewer profile)

1. gitea_resolve_task_capability(task="review_pr")
2. List open PRs; pick the oldest eligible PR (not self-authored, mergeable).
3. Pin head SHA; validate diff scope and run tests locally.
4. gitea_mark_final_review_decision → gitea_review_pr / gitea_submit_pr_review
5. gitea_merge_pr only with confirmation="MERGE PR <n>" and pinned head SHA.

Step 2: Implement issues (author profile)

1. gitea_resolve_task_capability for the author task.
2. gitea_lock_issue before implementation mutations.
3. Claim with gitea_mark_issue / status:in-progress label.
4. Branch, implement, test, push, gitea_create_pr.
5. Release claim when done; never self-review the PR.

Step 3: Operator follow-ups

Wiki publication, credential provisioning, and cross-repo mirror operations are operator-confirmed actions — see Runbooks.

Full Gitea-specific runbooks: docs/llm-workflow-runbooks.md in the repository.