Team Topology
Agent-guided team topology and value stream mapping model. Captures teams (type, cognitive load, domains), interactions (modes, health), system ownership, and value stream flows as versioned snapshots. Designed for incremental discovery through structured conversations — the agent interviews, the model persists.
Draws on Team Topologies (Skelton & Pais), Conway's Law, Westrum organizational typology, GROWS method tracer bullets, and Ruth Malan's evolutionary architecture thinking.
2026.09.15.1
Changed: Bump zod 4.4.3 → 4.6.5
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| organizationContext | string | Brief description of the organization, its size, and primary business |
| scope | string | Scope of this topology instance: 'full' org, a division name, or a product area |
| Argument | Type | Description |
|---|---|---|
| teams | array | Teams discovered through conversation |
| interactions | array | Interactions between teams |
| systemDependencies | array | System-level dependencies that cross team boundaries |
| notes? | string | Context about this discovery session |
| Argument | Type | Description |
|---|---|---|
| streams | array | Value streams mapped through conversation |
| Argument | Type | Description |
|---|---|---|
| findings | array | Findings from analyzing the topology and flows |
| summary | string | Brief narrative summary of the assessment |
Resources
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.1
Fixed: Added missing description field to upgrade entry for version
2026.08.24.2. The omission caused swamp extension pull to fail with a catalog
validation error ("upgrades.N.description: Invalid input: expected string,
received undefined").
2026.08.24.3
Added: Output metadata attributes for observability.
durationMs: Method execution duration in milliseconds.collectedBy: Extension name that produced the data.fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.24.2
Added Troubleshooting section documenting referential integrity validation in discover_topology, strict method ordering, agent-context-only global args, and JSON input requirements.
2026.08.21.2
Changed: discover_topology now rejects a call where an interaction's
source/target or a system dependency's ownerFrom/ownerTo names a team
that isn't present in that same call's teams array. Previously a typo'd or
stale team name was written into the topology snapshot without complaint,
producing a graph edge that pointed at nothing — the error now names the
unknown team(s) and lists the known team names.
Upgrade note: No schema changes. If you were passing interactions or
system dependencies that reference teams outside the current call's teams
list, include those teams in the call or the write will now fail with a
descriptive error instead of silently succeeding.
2026.08.21.1
Changed: Added .describe() to previously undocumented fields across
the schema — the team-type/interaction-mode/Westrum-culture enums, the
notes fields on interactions/flow steps/value streams, the Finding
fields (category, severity, title, description, affectedTeams,
recommendation), and the top-level TopologySchema/FlowsSchema/
AssessmentSchema fields. No behavioral change.
2026.07.18.1
Added: An upgrades array entry (no-op) to mod.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
2026.08.21.1
Changed: Added .describe() to previously undocumented fields across
the schema — the team-type/interaction-mode/Westrum-culture enums, the
notes fields on interactions/flow steps/value streams, the Finding
fields (category, severity, title, description, affectedTeams,
recommendation), and the top-level TopologySchema/FlowsSchema/
AssessmentSchema fields. No behavioral change.
2026.07.18.1
Added: An upgrades array entry (no-op) to mod.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
2026.07.18.1
Added: An upgrades array entry (no-op) to mod.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned