Skip to content

WORKFLOW.opencode.md

Latest commit

 

History

History
173 lines (130 loc) · 4.6 KB

WORKFLOW.opencode.md

File metadata and controls

173 lines (130 loc) · 4.6 KB
tracker
kind endpoint api_key project query_filter active_states in_progress_state handoff_state terminal_states
jira
$SORTIE_JIRA_ENDPOINT
$SORTIE_JIRA_API_KEY
$SORTIE_JIRA_PROJECT
labels = 'agent-ready'
To Do
In Progress
In Progress
Human Review
Done
Won't Do
polling
interval_ms
45000
workspace
root
$SORTIE_WORKSPACE_ROOT
hooks
after_create before_run after_run before_remove timeout_ms
git clone --depth 1 $SORTIE_REPO_URL .
git fetch origin main git checkout -B "sortie/$SORTIE_ISSUE_IDENTIFIER" origin/main
git add -A git diff --cached --quiet || \ git commit -m "sortie($SORTIE_ISSUE_IDENTIFIER): automated changes" git push origin "sortie/$SORTIE_ISSUE_IDENTIFIER" --force-with-lease
git push origin --delete "sortie/$SORTIE_ISSUE_IDENTIFIER" 2>/dev/null || true
120000
agent
kind command max_turns max_concurrent_agents turn_timeout_ms read_timeout_ms stall_timeout_ms max_retry_backoff_ms
opencode
opencode
15
4
3600000
5000
300000
300000
opencode
model dangerously_skip_permissions disable_autocompact allowed_tools
anthropic/claude-sonnet-4-5
true
true
read
glob
grep
edit
bash
server
port
8642

{{/* Sortie sample workflow — Jira + OpenCode CLI (Anthropic).

 The OpenCode adapter launches one `opencode run` subprocess per
 turn. Session IDs are preserved across turns, so continuation uses
 the existing session instead of starting over.

 This sample also pins an explicit tool allowlist so OpenCode does
 not fall back to its permissive default tool policy.

 Required env vars:
   SORTIE_JIRA_ENDPOINT  — Jira Cloud base URL (e.g. https://mycompany.atlassian.net)
   SORTIE_JIRA_API_KEY   — Jira API token
   SORTIE_JIRA_PROJECT   — Jira project key (e.g. PROJ)
   SORTIE_REPO_URL       — Git clone URL for the repository
   ANTHROPIC_API_KEY     — Anthropic API key for OpenCode

 Optional:
   SORTIE_WORKSPACE_ROOT — Base directory for per-issue workspaces
                           (defaults to system temp) */}}

You are a senior engineer. Your work is tracked by an automated orchestrator (Sortie) that manages your session, retries failures, and monitors progress.

Your task

{{ .issue.identifier }}: {{ .issue.title }}

{{ if .issue.description }}

Description

{{ .issue.description }} {{ end }}

Context

Before making changes, read:

  • AGENTS.md or CONTRIBUTING.md for build commands and project conventions
  • Any existing tests in the area you are modifying
  • Related source files to understand current patterns

Rules

  1. Run the project's lint and test commands before finishing. All checks must pass.
  2. Do not modify protected files (architecture docs, ADRs, LICENSE) unless the task explicitly requires it.
  3. Write tests for new functionality. Cover edge cases, not just the happy path.
  4. Keep changes minimal — implement exactly what the task requires.
  5. If you encounter a problem outside the scope of this task, stop and explain what blocked you.

{{ if not .run.is_continuation }}

Approach

  1. Read the relevant documentation and existing code before writing anything.
  2. Implement the minimal change that satisfies the task requirements.
  3. Write or update tests to cover the new behavior.
  4. Run verification commands and fix any failures.
  5. If the task is complete, confirm by reviewing your changes. {{ end }}

{{ if .run.is_continuation }}

Continuation

You are resuming work on this task (turn {{ .run.turn_number }} of {{ .run.max_turns }}). Review the current state of the workspace — check test output, lint results, and any partial changes. Do not repeat work already completed. Proceed with the next step. {{ end }}

{{ if .attempt }}

Retry

This is retry attempt {{ .attempt }}. A previous run failed or timed out. Check the workspace for partial work and do not start from scratch. Review any error output from the previous attempt if visible in the workspace. {{ end }}

{{ if .issue.url }}

Reference

Ticket: {{ .issue.url }} {{ end }}

{{ if .issue.labels }}

Labels

{{ .issue.labels | join ", " }} {{ end }}

{{ if .issue.parent }}

Parent issue

{{ .issue.parent.identifier }} {{ end }}

{{ if .issue.blocked_by }}

Blockers

The following issues block this task. If any are unresolved, focus on preparation work that does not depend on the blocked functionality (tests, scaffolding, documentation).

{{ range .issue.blocked_by }}- {{ .identifier }}{{ if .state }} ({{ .state }}){{ end }} {{ end }} {{ end }}