claude-plugins/symphony/templates/WORKFLOW.md at 187863fa163f355a01fde5bed8f4d246b91ca52b

Files

movq ee4e0b236e fix(symphony): correct runtime model — long-lived session, with multi-session support

Earlier framing assumed each /schedule-fired tick was a cold start
needing on-disk reconciliation. The actual model is a long-lived
orchestrator session where /schedule fires ticks within the running
session — TaskList sees prior-tick tasks just fine. Reframed
accordingly, while leaving the door open to other trigger sources
(Discord channel, webhook, second user session) which DO need
cross-session reconciliation.

Reconciliation logic now has a fast path and a slow path:

- Fast path: task in our TaskList → it's ours → reconcile via TaskGet.
- Slow path: task NOT in our TaskList (another session, or our session
  restarted) → check the worker's heartbeat file. Fresh → another
  session owns it, leave alone. Stale or missing → consider abandoned,
  retry; do not call TaskStop on a task we don't own.

Workers now write .symphony/heartbeats/<issue-id>.json on start,
refresh it at heartbeat_interval_ms cadence (default 60s), and delete
it on graceful exit. Stale heartbeats are how abandonment is detected
across sessions and after crashes.

Also added session_id to state.json running entries so cross-session
reconcilers know who spawned what.

WORKFLOW.md gains heartbeat_interval_ms and heartbeat_stale_ms knobs
under agent: with documented defaults.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-29 21:51:23 -05:00

2.3 KiB

Raw Blame History

tracker, polling, workspace, hooks, agent

tracker

polling

workspace

hooks

agent

kind

active_states

terminal_states

github

open

closed

interval_ms
60000

root
~/.symphony/workspaces

after_create	before_run	after_run	timeout_ms
git fetch origin git checkout -b "{{ issue.branch_name \| default: issue.identifier }}"	# project-specific install/setup test -f package.json && npm install --silent \|\| true test -f pyproject.toml && uv sync \|\| true	# advisory — never blocks the tick true	120000

max_concurrent_agents

max_turns

max_retry_backoff_ms

max_concurrent_agents_by_state

heartbeat_interval_ms

heartbeat_stale_ms

600000

in progress
2

60000

300000

You are working on issue {{ issue.identifier }} — {{ issue.title }}.

{% if attempt %}This is retry attempt {{ attempt }}. Review prior worktree commits and pick up where the last attempt stopped.{% endif %}

Issue body

Labels

Your job

Implement the change on branch {{ issue.branch_name | default: issue.identifier }}.
Add or update tests covering the new behavior. Run them.
Commit referencing {{ issue.identifier }}.
Push the branch and open a PR.
Comment on the issue with the PR link, then transition the issue to a "review" state. Use the commands documented in this project's CLAUDE.md under the issue tracker section — the plugin does not know your tracker's quirks.

If you cannot finish in your turn budget, leave a status comment on the issue summarizing progress and stop. Do not transition state.

2.3 KiB Raw Blame History

Issue body

Labels

Your job

2.3 KiB

Raw Blame History