Research: Dynamic Workflows as an optional execution backend for Squad ceremonies
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 35/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- github, typescript
Rechercherichtung
Start by reading the current ceremony specification and the entry points for Ralph, squad loop, and schedule.json, then compare them with the Dynamic Workflows concepts and limits in the linked GitHub documentation. Use one existing ceremony for an opt-in adapter spike, keeping irreversible actions out. Done means a capability mapping, working comparison, recovery and approval demonstrations, and a recommendation for the portable model.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Context
GitHub recently introduced Dynamic Workflows for Copilot CLI, the Copilot app, and the Copilot SDK. Extensions can define orchestration in code while agents handle reasoning: sequential and parallel stages, conditional paths, structured results, verification, checkpoints, pause/resume, and resource limits.
This overlaps with capabilities Squad already has or is defining: ceremonies, /fleet coordination, squad loop, Ralph, scheduling, recovery, verification roles, and rate/resource governance.
For the next version, investigate whether Dynamic Workflows can become an optional execution backend for Squad, without making Squad's portable model dependent on this GitHub feature.
References:
Qualifications: the feature is in public preview. Deterministic orchestration does not make agent outputs deterministic. Human interaction depends on the client. AI-credit limits are approximate, not hard spending ceilings. Scheduling should be investigated as a host/automation integration rather than assumed to be a native workflow primitive. Reusing a workflow definition is distinct from resuming a run with saved results.
Areas to investigate
1. Ceremonies as executable workflows
A ceremony could describe a portable process:
research -> challenge -> plan -> approve -> implement -> verify
A Copilot adapter could translate that ceremony into a Dynamic Workflow: workflow code controls execution, while Squad agents provide reasoning at specific stages.
Compare the current ceremony specification with actual workflow primitives. Identify existing semantics, gaps, and potential new portable concepts. Do not assume ceremonies are already executable task graphs.
2. Reusable multi-agent coordination patterns
Examples:
parallel review -> challenge -> reconcile -> final result
research -> architecture -> plan -> parallel implementation -> test -> security review -> approval -> PR
Determine what belongs in the portable model versus the adapter: structured stage contracts, dependencies, conditional transitions, failure handling, bounded retries, and parallel-work isolation. Parallel agents must not silently overwrite shared files or team state.
3. Dynamic Workflows as an execution backend
Evaluate:
Squad ceremony/task graph -> execution adapter -> Copilot Dynamic Workflow
The adapter should sit alongside existing execution mechanisms, not replace them by default. Compare preservation of agent identity, charters, routing, permissions, shared decisions, and persistent memory.
Define a backend capability contract. Unsupported semantics must be surfaced explicitly, not silently skipped or weakened. Keep preview-specific APIs inside the Copilot adapter.
4. Verification and approval gates
Could Challenger, Worf, and fact-checker become required execution stages rather than instructions an orchestrating agent is expected to remember?
implementation -> security review -> adversarial review -> tests -> consensus/gate -> human approval
Investigate portable concepts for required reviewers, evidence, approval, rejection, disagreement, and escalation. Distinguish model consensus from executable checks and human authorization: agent agreement is not proof of correctness.
Define behavior when a reviewer fails, returns malformed output, or disagrees, and when a client cannot present an approval prompt. Missing approval must not become implicit approval.
5. Long-running and scheduled work
Compare backend capabilities with Ralph, squad loop, schedule.json, recovery/checkpointing, rate/resource governance, and unattended execution.
Investigate whether the backend can own execution mechanics while Squad retains portable intent and policy. Separate scheduling/triggering from workflow execution.
Assess cancellation, interruption, retry, resume, and reuse of completed results. Determine how resumed runs avoid duplicate side effects such as publishing, PR creation, or decision writes. Document what happens if the ceremony, repository revision, or workflow definition changes between pause and resume.
Key architectural question
Squad defines WHO + WHAT + PROCESS: agents and roles, tasks, ceremonies, dependencies, policies, and gates.
Execution backends implement HOW: dispatch, parallel execution, conditional transitions, runtime checkpointing/resume, and resource accounting/enforcement. Scheduling may come from the host or a separate trigger adapter.
The intended semantics of a dependency, gate, or policy remain Squad-owned; the backend supplies the mechanism. Dynamic Workflows could be one backend, with a capability-based path for non-Copilot runtimes.
Research questions
- How closely do existing ceremonies map to Dynamic Workflow primitives?
- Which orchestration concepts should remain portable?
- Do we need explicit gates, approvals, consensus rules, parallel stages, dependencies, and structured stage contracts?
- Could
schedule.jsonreference a ceremony and inputs rather than describe orchestration itself? - Which runtime responsibilities can be delegated, and which must remain Squad-owned?
- Can an adapter preserve charters, memory ownership, routing, and governance without duplicating Squad's runtime?
- How do backend limits relate to Squad rate governance, including approximate credit ceilings and work already in flight?
- What permissions apply to agents versus extension code? GitHub documents that extension code can execute outside agent permission prompts; how should Squad governance cover that boundary?
- What guarantees exist for checkpoint persistence, retries, cancellation, and side-effect idempotency?
- How do approval and unattended execution behave across CLI, app, SDK, and non-interactive clients?
- How do we avoid coupling the specification to a preview API, and what does this imply for future non-Copilot backends?
Suggested next-version spike
Select one existing ceremony, or the closest supported equivalent, and implement an opt-in Dynamic Workflow adapter. Candidate:
research -> parallel specialist review -> Challenger -> plan approval -> implementation -> Worf review -> tests -> human approval
Compare:
- Current Squad execution.
- Dynamic Workflow execution.
- The smallest portable representation supporting both.
Use the same bounded task and inputs. Keep publication, merges, and other irreversible actions out of the initial spike. Include approval before implementation, not only after it.
Deliverables / completion criteria
- A mapping of ceremony semantics to backend capabilities, including unsupported features and gaps.
- A small working adapter and example preserving agent identity, charters, and ownership rules.
- A comparison of behavior, orchestration overhead, observed latency and AI-credit usage, observability, and recovery; record results rather than assume savings.
- Demonstrations of success, reviewer rejection/disagreement, failed checks, pause/resume, reached resource limits, and unavailable approval channels.
- Evidence that required gates cannot be bypassed and resumed stages do not repeat completed side effects.
- A recommendation: adopt an optional backend, extend the portable model first, or defer, with preview/API risks and implications for non-Copilot runtimes.
Non-goals
- Replacing Squad orchestration or removing human oversight.
- Making Dynamic Workflows mandatory.
- Redesigning all ceremonies, scheduling, or Ralph in this spike.
- Treating agent agreement as a substitute for tests or authorization.
The goal is to determine whether Dynamic Workflows can serve as a runtime target for Squad's portable coordination model, not to couple Squad to one execution engine.
CC @bradygaster
- Vorherrschende Sprache
- TypeScript
- Sterne
- 3.4k
- Forks
- 516
- Ø Merge
- 1 T. 15 Std.
- Gemergte PRs (30 T.)
- 116
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus github/squad
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
Maintainer antworten meist innerhalb von 1 Tag
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 77/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
bot:ai-assisted component:platform-js status:untriaged
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 74/100
midnightntwrk/platform-js#38 ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
ranxianglei/billion-context#7068 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
mybigday/whisper.rn#348 ·
-
enhancement severity:low
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Battle-Cattle/BCUK-Bot-4#1075 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 67/100
ilan-pinto/roaring-lions#1552 ·
Maintainer antworten meist innerhalb von 1 Tag