Files
Gitea-Tools/docs/wiki/Workflow.md
T
sysadminandClaude Opus 4.8 2111c84e7d docs: add Work Selection Rule for LLM operating rules
Require lease verification (open PRs, branches, worktrees, leases,
merged completion) before any issue or PR work. Surface the rule in
the portable skill, Gitea runbooks, operator guide, and start-issue
template; add doc-contract tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-07-06 13:45:25 -04:00

1.6 KiB

Workflow Model

Navigation

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_decisiongitea_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. Work Selection Rule — verify a work lease before any mutations (open PRs, issue-linked PRs, branches, worktrees, dirty worktrees, active leases/ handoffs, merged-PR completion). Stop if another session owns the lease.
  2. gitea_resolve_task_capability for the author task.
  3. gitea_lock_issue before implementation mutations.
  4. Claim with gitea_mark_issue / status:in-progress label.
  5. Branch, implement, test, push, gitea_create_pr.
  6. 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.