39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# Workflow Model
|
|
|
|
## Navigation
|
|
|
|
- [Home](Home.md) | [Operator Guide](Operator-Guide.md) | [Repositories Map](Repositories.md) | [Identity and Profiles](Identity-and-Profiles.md) | [Workflow Model](Workflow.md) | [Safety and Gates](Safety-and-Gates.md) | [MCP Tools Reference](MCP-Tools.md) | [Operator Runbooks](Runbooks.md) | [Open Decisions](Open-Decisions.md) | [Project History](History.md)
|
|
|
|
## 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)
|
|
|
|
0. 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.
|
|
`gitea_lock_issue` records an operation-scoped `author_issue_work` lease
|
|
with issue, branch, worktree, claimant, created, expiry, and heartbeat
|
|
fields; active or expired same-operation leases require recovery review
|
|
before takeover.
|
|
0b. Global LLM Worktree Rule — main checkout on `master`/`main`/`dev` only;
|
|
mutate only from a `branches/` worktree after proving root, cwd, branch,
|
|
stable main-checkout branch, and session worktree path (no exceptions).
|
|
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](Runbooks.md).
|
|
|
|
Full Gitea-specific runbooks: `docs/llm-workflow-runbooks.md` in the repository.
|