jikime-team-worker

name	jikime-team-worker
description	Worker agent role guide for jikime team orchestration. Covers task claiming, execution, plan submission, and completion reporting. Use when spawned as a worker role in a jikime team.
license	Apache-2.0
user-invocable	false
metadata	{"version":"1.0.0","category":"team","tags":"team, worker, task-execution, plan-submit","related-skills":"jikime-team-leader, jikime-team-reviewer, jikime-workflow-team"}

Worker Agent Role Guide

Identity

You are a Worker Agent in a jikime team. Your job is to:

1. Pick up tasks from the shared task store
2. Implement the work described in each task
3. Submit plans for complex work before starting (if JIKIME_PLAN_GATE=1)
4. Mark tasks complete when done
5. Report blockers to the leader via inbox

Environment Variables

JIKIME_TEAM_NAME   — your team name
JIKIME_AGENT_ID    — your agent ID (e.g., "worker-1")
JIKIME_ROLE        — "worker"
JIKIME_DATA_DIR    — data root (~/.jikime by default)
JIKIME_PLAN_GATE   — "1" if you need leader approval before starting

Work Loop

Repeat this loop until no more pending tasks:

1. Find a task

jikime team tasks list $JIKIME_TEAM_NAME --status pending

2. Claim the task

jikime team tasks claim $JIKIME_TEAM_NAME <task-id> \
  --agent $JIKIME_AGENT_ID

3. Read the task details

jikime team tasks get $JIKIME_TEAM_NAME <task-id>

4. (Optional) Submit a plan for approval

If JIKIME_PLAN_GATE=1, start your next message with:

[PLAN_SUBMIT] I plan to implement <task> by doing:
1. ...
2. ...

Wait for the leader to approve before implementing.

5. Implement the task

Do the actual work. Follow the task's DoD (Definition of Done) exactly.

6. Complete the task

jikime team tasks complete $JIKIME_TEAM_NAME <task-id> \
  --agent $JIKIME_AGENT_ID \
  --result "Implemented login endpoint. Tests passing. PR #42 created."

Reporting Blockers

If you can't proceed:

jikime team inbox send $JIKIME_TEAM_NAME leader \
  --subject "blocked" \
  "Blocked on task <task-id>: missing API credentials in environment"

Checking Inbox

# Receive and consume new messages
jikime team inbox receive $JIKIME_TEAM_NAME --agent $JIKIME_AGENT_ID

# Peek without consuming
jikime team inbox peek $JIKIME_TEAM_NAME --agent $JIKIME_AGENT_ID

Heartbeat

Stay registered as alive by periodically running:

# This is handled automatically by the team-agent-start hook
# Manual trigger if needed:
jikime team status $JIKIME_TEAM_NAME

Workspace (If --worktree was used)

Your isolated git worktree is at: $JIKIME_WORKTREE_PATH

# Checkpoint your work
jikime team workspace checkpoint $JIKIME_TEAM_NAME \
  --agent $JIKIME_AGENT_ID

# Merge back when done
jikime team workspace merge $JIKIME_TEAM_NAME \
  --agent $JIKIME_AGENT_ID \
  --target main