| name | gitea-pagerank-workflow |
| description | PageRank-powered task management using Gitea, tea CLI, and gitea-robot. Replaces beads/br and mcp_agent_mail with Gitea-native tooling. Use when agents need to pick work, prioritize issues, manage dependencies, coordinate multi-agent work, or run agile workflows against git.terraphim.cloud. Triggers: 'what should I work on', 'pick next task', 'triage issues', 'show ready tasks', 'prioritize backlog', 'claim issue', 'close issue', 'add dependency', 'show dependency graph', 'coordinate work', 'start session', 'run workflow'. Keywords: gitea, pagerank, triage, ready, robot, tea, issue, priority, dependency, backlog, sprint. |
Gitea PageRank Workflow
Gitea is the single source of truth for task management, prioritization, and multi-agent coordination. Use gitea-robot for PageRank-based prioritization and tea for issue/PR lifecycle.
Environment Setup
export GITEA_URL="https://git.terraphim.cloud"
export GITEA_TOKEN=$(op read "op://TerraphimPlatform/gitea-test-token/credential")
Verify: curl -s -H "Authorization: token $GITEA_TOKEN" "$GITEA_URL/api/v1/user" | jq .login
Core Commands
Discover Work (PageRank-ranked)
gitea-robot triage --owner OWNER --repo REPO --format json
gitea-robot ready --owner OWNER --repo REPO
gitea-robot graph --owner OWNER --repo REPO
PageRank scores: higher = blocks more downstream work. Fix high-PageRank issues first.
Issue Lifecycle (tea CLI)
tea issues list --state open
tea issues create --title "..." --description "..." --labels "priority/P1-high,type/task"
tea issues edit IDX --add-labels "status/in-progress" --add-assignees "AGENT_NAME"
tea comment IDX "message"
tea issues close IDX
Dependencies
gitea-robot add-dep --owner OWNER --repo REPO --issue X --blocks Y
PR Workflow
tea pulls create --title "Fix #IDX: title" --description "..." --base main --head branch
tea pulls merge --style squash
Agent Workflow
Single-Agent Flow
- Pick work:
gitea-robot ready --owner O --repo R -- pick highest PageRank unblocked issue
- Claim:
tea issues edit IDX --add-labels "status/in-progress" --add-assignees "AGENT"
- Branch:
git checkout -b task/IDX-short-title
- Implement: TDD in worktree, commit with
Refs #IDX in messages
- PR:
tea pulls create --title "Fix #IDX: title" --base main --head task/IDX-short-title
- Close:
tea issues close IDX after merge, add completion comment
Multi-Agent Coordination
For multi-agent conventions including file reservation via labels, coordination via comments, and cross-repo patterns, see references/agent-coordination.md.
Label Convention
Repos need standard labels for the workflow. Run scripts/gitea-setup-labels.sh to create them. See references/label-convention.md for the full set.
CLAUDE.md Integration
To replace the MCP Agent Mail + Beads snippet in a project's CLAUDE.md, use the snippet in references/claude-md-snippet.md.
Migration from Beads/Agent Mail
For mapping from br/bd commands and Agent Mail to Gitea equivalents, see references/migration.md.
Identifier Conventions
| Context | Format | Example |
|---|
| Commit message | Refs #IDX or Fixes #IDX | Refs #42 |
| Branch name | task/IDX-short-title | task/42-auth-refactor |
| PR title | Fix #IDX: description | Fix #42: Refactor auth |
| Cross-repo | owner/repo#IDX | terraphim/gitea#42 |