Skip to content

WORKFLOW.copilot.md

Latest commit

 

History

History
157 lines (116 loc) · 4.24 KB

WORKFLOW.copilot.md

File metadata and controls

157 lines (116 loc) · 4.24 KB
tracker
kind api_key project query_filter active_states in_progress_state handoff_state terminal_states
github
$GITHUB_TOKEN
$SORTIE_GITHUB_PROJECT
label:backlog
backlog
in-progress
in-progress
review
done
wontfix
polling
interval_ms
120000
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 stall_timeout_ms max_retry_backoff_ms
copilot-cli
copilot
5
4
1800000
300000
300000
copilot-cli
model max_autopilot_continues
gpt-4.1
50
server
port
8642

{{/* Sortie sample workflow — GitHub Issues + Copilot CLI. Fully GitHub-native: no Jira, no Claude Code.

 Required env vars:
   GITHUB_TOKEN          — Fine-grained PAT with Issues read/write + Copilot
                           Requests permissions. Serves double duty: the tracker
                           reads it via $GITHUB_TOKEN expansion and the Copilot
                           CLI picks it up from the process environment.
   SORTIE_GITHUB_PROJECT — Repository in owner/repo format
   SORTIE_REPO_URL       — Git clone URL for the repository

 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 (LICENSE, CODEOWNERS) unless the task explicitly requires it.
  3. Keep changes minimal — implement exactly what the task requires.
  4. Write tests for new functionality. Cover edge cases, not just the happy path.
  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 }}