Research: Dynamic Workflows as an optional execution backend for Squad ceremonies
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Facilidade para iniciantes
- 35/100
- Tipo de issue
- Funcionalidade
- Clareza
- Razoavelmente clara
- Status de atividade
- Ativa
- Stack de tecnologia
- github, typescript
Direção de pesquisa
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.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- TypeScript
- Estrelas
- 3.4k
- Forks
- 516
- Merge médio
- 1d 15h
- PRs com merge (30d)
- 116
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de github/squad
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
Mantenedores costumam responder em até 1 dia
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 77/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
Mantenedores costumam responder em até 1 dia
Todas as issues de github/squad
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
vercel-labs/ui#809 ·
Mantenedores costumam responder em até 1 dia
-
bot:ai-assisted component:platform-js status:untriaged
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 74/100
midnightntwrk/platform-js#38 ·
-
[bug] Second false positive on high-cost plugin alert: detection only compares patch entry id, community plugin dsh-auto | [bug] 高成本插件告警第二次误报:检测只比对 patch 条目 id,社区插件 dsh-auto-review 被认成 @deepseek-ai/dsh-experimental-auto-reviewTalvez já em andamento Um pull request vinculado a esta issue está aberto ou já foi mesclado. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
ranxianglei/billion-context#7068 ·
Mantenedores costumam responder em até 1 dia
-
vendor: bump whisper.cpp past 6a8addd — the current pin aborts the app on a failed Metal initAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
mybigday/whisper.rn#348 ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
six-group/six-webcomponents#600 ·