Skip to content

templates: add versioned reusable agent-team Partituras #28

Description

@guicybercode

Context

Teams repeatedly use the same arrangements: architect, developer, reviewer, tester, notes, and communication links. Rebuilding the topology for every task is slow and error-prone.

Goal

Add reusable, versioned Agent Team templates, inspired by Partituras, that can instantiate a task team with roles, connections, notes, and layout hints.

Scope

  • Define a versioned template schema.
  • Include role references, adapter capability requirements, connection types, starter notes, and optional canvas positions.
  • Support local create, duplicate, edit, archive, import, and export.
  • Validate templates before task side effects.
  • Resolve agents and roles through stable IDs or portable selectors.
  • Provide a preview showing missing capabilities and substitutions.

Acceptance criteria

  • Exported templates contain no env values, secrets, machine-specific absolute paths, session IDs, or PTY data.
  • Unknown future fields can be preserved or rejected according to the schema version.
  • Instantiation is all-or-nothing before worktree/session creation begins.
  • Missing agents do not silently select a different vendor.
  • Users explicitly approve substitutions.
  • Historical tasks retain the template version they used.
  • Import rejects malformed, oversized, and cyclic connection graphs.
  • Round-trip and migration tests cover at least two schema versions.

Out of scope

A public template marketplace and cloud synchronization.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions