Skip to content

WORKFLOW.md

Latest commit

 

History

History
156 lines (117 loc) · 3.94 KB

WORKFLOW.md

File metadata and controls

156 lines (117 loc) · 3.94 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 . go mod download
git fetch origin main git checkout -B "sortie/$SORTIE_ISSUE_IDENTIFIER" origin/main
make fmt 2>/dev/null || true git add -A git diff --cached --quiet || git commit -m "sortie($SORTIE_ISSUE_IDENTIFIER): automated changes"
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 max_concurrent_agents_by_state
claude-code
claude
15
4
3600000
5000
300000
300000
in progress to do
3
1
claude-code
permission_mode model max_turns max_budget_usd
bypassPermissions
claude-sonnet-4-20250514
50
5
server
port
8642

{{/* Sortie sample workflow — E2E testing and documentation reference. Required env vars: SORTIE_JIRA_ENDPOINT, SORTIE_JIRA_API_KEY, SORTIE_JIRA_PROJECT, SORTIE_REPO_URL. Optional: SORTIE_WORKSPACE_ROOT (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 for build commands and project boundaries
  • docs/architecture.md for the relevant specification section
  • Any existing tests in the area you are modifying

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 table-driven tests. Cover edge cases, not just the happy path.
  4. If you encounter a problem outside the scope of this task, write blocked to .sortie/status and stop.
  5. Keep changes minimal — implement exactly what the task requires.

{{ 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 }}