From 339c213470ae6995cfa1c2ac6678cd85524f2305 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sun, 7 Jun 2026 16:04:22 -0400 Subject: [PATCH 1/3] =?UTF-8?q?chore:=20rename=20tech-lead=20=E2=86=92=20e?= =?UTF-8?q?ngineering-shaping,=20software-engineer=20=E2=86=92=20engineeri?= =?UTF-8?q?ng-building?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Structural rename only — the agent body rewrites (absorbing the activity-mode reframe into AGENT.md prose, examples, orientation rubric) land in subsequent commits on this PR before the draft moves out of draft. What's in this commit: - Directory rename: plugins/bitwarden-tech-lead → plugins/bitwarden-engineering-shaping - Directory rename: plugins/bitwarden-software-engineer → plugins/bitwarden-engineering-building - plugin.json: name, homepage, version bump (3.0.0 / 2.0.0 — MAJOR rename) - AGENT.md frontmatter: name field - marketplace.json: entries, paths, descriptions - Root README catalog rows - CHANGELOG entries documenting the rename Cross-plugin references to the old plugin names (in bitwarden-code-review, bitwarden-designer, bitwarden-delivery-tools) and the agent body rewrites themselves are tracked in the draft PR body as remaining work. --- .claude-plugin/marketplace.json | 16 +++++----- README.md | 32 +++++++++---------- .../.claude-plugin/plugin.json | 20 ++++++++++++ .../CHANGELOG.md | 8 ++++- .../README.md | 0 .../agents/AGENT.md | 4 +-- .../.claude-plugin/plugin.json | 19 +++++++++++ .../CHANGELOG.md | 8 ++++- .../README.md | 0 .../agents/AGENT.md | 2 +- .../skills/architecting-solutions/SKILL.md | 0 .../SKILL.md | 0 .../.claude-plugin/plugin.json | 13 -------- .../.claude-plugin/plugin.json | 19 ----------- 14 files changed, 80 insertions(+), 61 deletions(-) create mode 100644 plugins/bitwarden-engineering-building/.claude-plugin/plugin.json rename plugins/{bitwarden-software-engineer => bitwarden-engineering-building}/CHANGELOG.md (74%) rename plugins/{bitwarden-software-engineer => bitwarden-engineering-building}/README.md (100%) rename plugins/{bitwarden-software-engineer => bitwarden-engineering-building}/agents/AGENT.md (85%) create mode 100644 plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json rename plugins/{bitwarden-tech-lead => bitwarden-engineering-shaping}/CHANGELOG.md (79%) rename plugins/{bitwarden-tech-lead => bitwarden-engineering-shaping}/README.md (100%) rename plugins/{bitwarden-tech-lead => bitwarden-engineering-shaping}/agents/AGENT.md (99%) rename plugins/{bitwarden-tech-lead => bitwarden-engineering-shaping}/skills/architecting-solutions/SKILL.md (100%) rename plugins/{bitwarden-tech-lead => bitwarden-engineering-shaping}/skills/contributing-to-technical-strategy/SKILL.md (100%) delete mode 100644 plugins/bitwarden-software-engineer/.claude-plugin/plugin.json delete mode 100644 plugins/bitwarden-tech-lead/.claude-plugin/plugin.json diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 2b9a1d2d..09197d00 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -40,10 +40,10 @@ "description": "Product analyst agent for creating comprehensive Bitwarden requirements documents from multiple sources" }, { - "name": "bitwarden-software-engineer", - "source": "./plugins/bitwarden-software-engineer", - "version": "1.0.0", - "description": "Software engineer agent for a Bitwarden product team. Implements stories, tasks, and bugs in the team's domain with code quality, performance, and security in mind. Participates in refinement, reviews PRs, collaborates with QA, and follows Git conventions." + "name": "bitwarden-engineering-building", + "source": "./plugins/bitwarden-engineering-building", + "version": "2.0.0", + "description": "Building-mode engineering agent for a Bitwarden product team — implementing stories, reviewing PRs, preparing commits and pull requests, and shipping code. Reframed from the previous software-engineer role into an activity mode any engineer steps into when actually constructing the work." }, { "name": "bitwarden-atlassian-tools", @@ -64,10 +64,10 @@ "description": "GitHub Actions workflow compliance, action security auditing, and org-wide CI/CD remediation." }, { - "name": "bitwarden-tech-lead", - "source": "./plugins/bitwarden-tech-lead", - "version": "2.3.1", - "description": "Tech lead agent for a Bitwarden product team. The team's primary technical resource — architects solutions in the team's domain, partners with the EM on scoping and backlog, partners with peer tech leads on cross-team architecture, and serves as the team's conduit for cross-team technical decisions." + "name": "bitwarden-engineering-shaping", + "source": "./plugins/bitwarden-engineering-shaping", + "version": "3.0.0", + "description": "Shaping-mode engineering agent for a Bitwarden product team — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. Reframed from the previous tech-lead role into an activity mode any engineer steps into when planning work rather than implementing it." }, { "name": "bitwarden-shepherd", diff --git a/README.md b/README.md index 23ed4699..6e6ac406 100644 --- a/README.md +++ b/README.md @@ -4,22 +4,22 @@ A curated collection of plugins for AI-assisted development at Bitwarden. Enable ## Available Plugins -| Plugin | Version | Description | -| ------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [bitwarden-tech-lead](plugins/bitwarden-tech-lead/) | 2.3.1 | Tech lead for technical planning, architecture coherence, and surfacing patterns to Technical Strategy Ideas | -| [bitwarden-shepherd](plugins/bitwarden-shepherd/) | 1.0.0 | Champion of a technical strategy — shepherds a TSI through evaluation into the funnel, then through to adoption | -| [bitwarden-atlassian-tools](plugins/bitwarden-atlassian-tools/) | 2.2.6 | Read-only Atlassian access via MCP server with deep Jira issue research skill | -| [bitwarden-code-review](plugins/bitwarden-code-review/) | 1.11.0 | Autonomous code review agent following Bitwarden engineering standards with GitHub integration | -| [bitwarden-delivery-tools](plugins/bitwarden-delivery-tools/) | 2.0.0 | Delivery lifecycle skills: initiative funnel navigation, work transitions, tech breakdowns and cross-team signoffs, commits, PRs, preflight, labeling | -| [bitwarden-designer](plugins/bitwarden-designer/) | 0.1.0 | Product designer persona: Code of Conduct and 30/60/90 critique, critique facilitation; dispatches into bitwarden-design-tools | -| [bitwarden-design-tools](plugins/bitwarden-design-tools/) | 0.1.0 | Design toolkit: content style guide, Figma Dev Mode MCP, Bitwarden brand application, handoff prep, Design System governance, Product and Design Jira | -| [bitwarden-devops-engineer](plugins/bitwarden-devops-engineer/) | 0.1.3 | DevOps engineering assistant: workflow compliance linting, action security auditing, and org-wide CI/CD remediation | -| [bitwarden-init](plugins/bitwarden-init/) | 1.2.0 | Initialize and enhance CLAUDE.md files with Bitwarden's standardized template format | -| [bitwarden-product-analyst](plugins/bitwarden-product-analyst/) | 0.1.5 | Product analyst agent for creating comprehensive Bitwarden requirements documents from multiple sources | -| [bitwarden-security-engineer](plugins/bitwarden-security-engineer/) | 1.2.0 | Application security engineering: vulnerability triage, threat modeling, and secure code analysis | -| [bitwarden-software-engineer](plugins/bitwarden-software-engineer/) | 1.0.0 | Software engineer agent for a Bitwarden product team. Implements stories, tasks, and bugs with code quality, performance, security, and team comms in mind. | -| [claude-config-validator](plugins/claude-config-validator/) | 1.1.1 | Validates Claude Code configuration files for security, structure, and quality | -| [claude-retrospective](plugins/claude-retrospective/) | 1.1.1 | Analyze Claude Code sessions to identify successful patterns and improvement opportunities | +| Plugin | Version | Description | +| ------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [bitwarden-engineering-shaping](plugins/bitwarden-engineering-shaping/) | 3.0.0 | Shaping-mode engineering agent: discovery, scoping, architecture, cross-team coordination, tech-breakdown drafting (reframed from the prior tech-lead role) | +| [bitwarden-shepherd](plugins/bitwarden-shepherd/) | 1.0.0 | Champion of a technical strategy — shepherds a TSI through evaluation into the funnel, then through to adoption | +| [bitwarden-atlassian-tools](plugins/bitwarden-atlassian-tools/) | 2.2.6 | Read-only Atlassian access via MCP server with deep Jira issue research skill | +| [bitwarden-code-review](plugins/bitwarden-code-review/) | 1.11.0 | Autonomous code review agent following Bitwarden engineering standards with GitHub integration | +| [bitwarden-delivery-tools](plugins/bitwarden-delivery-tools/) | 2.0.0 | Delivery lifecycle skills: initiative funnel navigation, work transitions, tech breakdowns and cross-team signoffs, commits, PRs, preflight, labeling | +| [bitwarden-designer](plugins/bitwarden-designer/) | 0.1.0 | Product designer persona: Code of Conduct and 30/60/90 critique, critique facilitation; dispatches into bitwarden-design-tools | +| [bitwarden-design-tools](plugins/bitwarden-design-tools/) | 0.1.0 | Design toolkit: content style guide, Figma Dev Mode MCP, Bitwarden brand application, handoff prep, Design System governance, Product and Design Jira | +| [bitwarden-devops-engineer](plugins/bitwarden-devops-engineer/) | 0.1.3 | DevOps engineering assistant: workflow compliance linting, action security auditing, and org-wide CI/CD remediation | +| [bitwarden-init](plugins/bitwarden-init/) | 1.2.0 | Initialize and enhance CLAUDE.md files with Bitwarden's standardized template format | +| [bitwarden-product-analyst](plugins/bitwarden-product-analyst/) | 0.1.5 | Product analyst agent for creating comprehensive Bitwarden requirements documents from multiple sources | +| [bitwarden-security-engineer](plugins/bitwarden-security-engineer/) | 1.2.0 | Application security engineering: vulnerability triage, threat modeling, and secure code analysis | +| [bitwarden-engineering-building](plugins/bitwarden-engineering-building/) | 2.0.0 | Building-mode engineering agent: implementing stories, reviewing PRs, preparing commits and pull requests, shipping code (reframed from the prior software-engineer role) | +| [claude-config-validator](plugins/claude-config-validator/) | 1.1.1 | Validates Claude Code configuration files for security, structure, and quality | +| [claude-retrospective](plugins/claude-retrospective/) | 1.1.1 | Analyze Claude Code sessions to identify successful patterns and improvement opportunities | ## Usage diff --git a/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json b/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json new file mode 100644 index 00000000..2f6f9e1e --- /dev/null +++ b/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json @@ -0,0 +1,20 @@ +{ + "name": "bitwarden-engineering-building", + "version": "2.0.0", + "description": "Building-mode engineering agent for a Bitwarden product team — implementing stories, reviewing PRs, preparing commits and pull requests, and shipping code. Reframed from the previous software-engineer role into an activity mode any engineer steps into when actually constructing the work. Body rewrite pending; this release records the rename and version baseline.", + "author": { + "name": "Bitwarden", + "url": "https://github.com/bitwarden" + }, + "homepage": "https://github.com/bitwarden/ai-plugins/tree/main/plugins/bitwarden-engineering-building", + "repository": "https://github.com/bitwarden/ai-plugins", + "keywords": [ + "building", + "implementation", + "typescript", + "csharp", + "sql", + "fullstack" + ], + "agents": "./agents/AGENT.md" +} diff --git a/plugins/bitwarden-software-engineer/CHANGELOG.md b/plugins/bitwarden-engineering-building/CHANGELOG.md similarity index 74% rename from plugins/bitwarden-software-engineer/CHANGELOG.md rename to plugins/bitwarden-engineering-building/CHANGELOG.md index 5fc709d8..6800618d 100644 --- a/plugins/bitwarden-software-engineer/CHANGELOG.md +++ b/plugins/bitwarden-engineering-building/CHANGELOG.md @@ -1,10 +1,16 @@ # Changelog -All notable changes to the `bitwarden-software-engineer` plugin will be documented in this file. +All notable changes to the `bitwarden-engineering-building` plugin (previously published as `bitwarden-software-engineer`) will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [2.0.0] - 2026-06-07 + +### Changed (BREAKING) + +- **Renamed plugin from `bitwarden-software-engineer` → `bitwarden-engineering-building`.** Reframed from a role-based identity ("the software engineer") into an activity-mode identity ("an engineer in building mode — implementing stories, reviewing PRs, preparing commits and pull requests, shipping code"). The split with `bitwarden-engineering-shaping` (formerly `bitwarden-tech-lead`) is by activity, not seniority — same engineer steps between modes as the work demands. Any agent or workflow invoking `Agent(bitwarden-software-engineer)` must switch to `Agent(bitwarden-engineering-building)`. The plugin directory, `plugin.json` name, `marketplace.json` entry, root README catalog row, and agent frontmatter `name:` are all renamed; the agent body rewrite (absorbing the mode reframe into the AGENT.md prose, examples, and orientation rubric) lands in subsequent commits on this PR before the draft moves out of draft. + ## [1.0.0] - 2026-05-19 ### Changed diff --git a/plugins/bitwarden-software-engineer/README.md b/plugins/bitwarden-engineering-building/README.md similarity index 100% rename from plugins/bitwarden-software-engineer/README.md rename to plugins/bitwarden-engineering-building/README.md diff --git a/plugins/bitwarden-software-engineer/agents/AGENT.md b/plugins/bitwarden-engineering-building/agents/AGENT.md similarity index 85% rename from plugins/bitwarden-software-engineer/agents/AGENT.md rename to plugins/bitwarden-engineering-building/agents/AGENT.md index b48be505..f74a154c 100644 --- a/plugins/bitwarden-software-engineer/agents/AGENT.md +++ b/plugins/bitwarden-engineering-building/agents/AGENT.md @@ -1,7 +1,7 @@ --- -name: bitwarden-software-engineer +name: bitwarden-engineering-building description: | - Software engineer on a Bitwarden product team. Implements assigned stories, tasks, and bugs scoped to the team's domain with minimal assistance, considering code quality, documented best practices, performance, and security in every change. Grows across the Bitwarden stack (Angular/RxJs, .NET, SQL, and — where relevant — Rust) through self-guided exploration of the codebase. Participates in refinement discussions, surfaces scope drift discovered mid-implementation, reviews teammates' PRs, collaborates with QA on testing questions, reaches out for guidance rather than guessing when work becomes ambiguous, and follows Git best practices. Use when implementing a story or bug, fixing a regression, preparing a commit and PR, reviewing a teammate's PR, asking implementation questions inside the team's codebase, or working through testing questions with QA. + Software engineer on a Bitwarden engineering team. Implements assigned stories, tasks, and bugs scoped to the team's domain with minimal assistance, considering code quality, documented best practices, performance, and security in every change. Grows across the Bitwarden stack (Angular/RxJs, .NET, SQL, and — where relevant — Rust) through self-guided exploration of the codebase. Participates in refinement discussions, surfaces scope drift discovered mid-implementation, reviews teammates' PRs, collaborates with QA on testing questions, reaches out for guidance rather than guessing when work becomes ambiguous, and follows Git best practices. Use when implementing a story or bug, fixing a regression, preparing a commit and PR, reviewing a teammate's PR, asking implementation questions inside the team's codebase, or working through testing questions with QA. Context: An engineer is picking up an assigned Jira story for the current sprint. diff --git a/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json b/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json new file mode 100644 index 00000000..c5204c8b --- /dev/null +++ b/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json @@ -0,0 +1,19 @@ +{ + "name": "bitwarden-engineering-shaping", + "version": "3.0.0", + "description": "Shaping-mode engineering agent for a Bitwarden product team — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. Reframed from the previous tech-lead role into an activity mode any engineer steps into when planning work rather than implementing it. Body rewrite pending; this release records the rename and version baseline.", + "author": { + "name": "Bitwarden", + "url": "https://github.com/bitwarden" + }, + "homepage": "https://github.com/bitwarden/ai-plugins/tree/main/plugins/bitwarden-engineering-shaping", + "repository": "https://github.com/bitwarden/ai-plugins", + "keywords": [ + "shaping", + "discovery", + "architecture", + "tech-breakdown", + "planning" + ], + "agents": "./agents/AGENT.md" +} diff --git a/plugins/bitwarden-tech-lead/CHANGELOG.md b/plugins/bitwarden-engineering-shaping/CHANGELOG.md similarity index 79% rename from plugins/bitwarden-tech-lead/CHANGELOG.md rename to plugins/bitwarden-engineering-shaping/CHANGELOG.md index bd983ab8..89e06214 100644 --- a/plugins/bitwarden-tech-lead/CHANGELOG.md +++ b/plugins/bitwarden-engineering-shaping/CHANGELOG.md @@ -1,10 +1,16 @@ # Changelog -All notable changes to the `bitwarden-tech-lead` plugin will be documented in this file. +All notable changes to the `bitwarden-engineering-shaping` plugin (previously published as `bitwarden-tech-lead`) will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [3.0.0] - 2026-06-07 + +### Changed (BREAKING) + +- **Renamed plugin from `bitwarden-tech-lead` → `bitwarden-engineering-shaping`.** Reframed from a role-based identity ("the team's tech lead") into an activity-mode identity ("an engineer in shaping mode — discovery, scoping, architectural reasoning, cross-team coordination, tech-breakdown drafting"). The split with `bitwarden-engineering-building` (formerly `bitwarden-software-engineer`) is by activity, not seniority — same engineer steps between modes as the work demands. Any agent or workflow invoking `Agent(bitwarden-tech-lead)` must switch to `Agent(bitwarden-engineering-shaping)`. The plugin directory, `plugin.json` name, `marketplace.json` entry, root README catalog row, and agent frontmatter `name:` are all renamed; the agent body rewrite (absorbing the mode reframe into the AGENT.md prose, examples, and orientation rubric) lands in subsequent commits on this PR before the draft moves out of draft. + ## [2.3.1] - 2026-06-07 ### Changed diff --git a/plugins/bitwarden-tech-lead/README.md b/plugins/bitwarden-engineering-shaping/README.md similarity index 100% rename from plugins/bitwarden-tech-lead/README.md rename to plugins/bitwarden-engineering-shaping/README.md diff --git a/plugins/bitwarden-tech-lead/agents/AGENT.md b/plugins/bitwarden-engineering-shaping/agents/AGENT.md similarity index 99% rename from plugins/bitwarden-tech-lead/agents/AGENT.md rename to plugins/bitwarden-engineering-shaping/agents/AGENT.md index df33859b..5ceae1db 100644 --- a/plugins/bitwarden-tech-lead/agents/AGENT.md +++ b/plugins/bitwarden-engineering-shaping/agents/AGENT.md @@ -1,5 +1,5 @@ --- -name: bitwarden-tech-lead +name: bitwarden-engineering-shaping description: | Tech lead for a Bitwarden product team. The team's primary technical resource and authority — partners with the EM on scoping new work, backlog hygiene, and engineer assignments; partners with other tech leads on architecture and design decisions that cross team boundaries; serves as the conduit for cross-team technical decisions that affect the team; undertakes forward-thinking investigative work to remove current and future roadblocks for the team's initiatives and roadmap; and has the authority (backed by the EM) to enforce technical recommendations through PR reviews and team communications. Use when planning or scoping work inside the team's domain, evaluating trade-offs between approaches, partnering with the EM on backlog or refinement, advocating for non-standard technical decisions to peer tech leads, surfacing cross-team technical implications of in-team work, or assessing whether a team-level pattern of pain belongs upstream in Architecture's portfolio. diff --git a/plugins/bitwarden-tech-lead/skills/architecting-solutions/SKILL.md b/plugins/bitwarden-engineering-shaping/skills/architecting-solutions/SKILL.md similarity index 100% rename from plugins/bitwarden-tech-lead/skills/architecting-solutions/SKILL.md rename to plugins/bitwarden-engineering-shaping/skills/architecting-solutions/SKILL.md diff --git a/plugins/bitwarden-tech-lead/skills/contributing-to-technical-strategy/SKILL.md b/plugins/bitwarden-engineering-shaping/skills/contributing-to-technical-strategy/SKILL.md similarity index 100% rename from plugins/bitwarden-tech-lead/skills/contributing-to-technical-strategy/SKILL.md rename to plugins/bitwarden-engineering-shaping/skills/contributing-to-technical-strategy/SKILL.md diff --git a/plugins/bitwarden-software-engineer/.claude-plugin/plugin.json b/plugins/bitwarden-software-engineer/.claude-plugin/plugin.json deleted file mode 100644 index 8fd96b95..00000000 --- a/plugins/bitwarden-software-engineer/.claude-plugin/plugin.json +++ /dev/null @@ -1,13 +0,0 @@ -{ - "name": "bitwarden-software-engineer", - "version": "1.0.0", - "description": "Software engineer agent for a Bitwarden product team. Implements stories, tasks, and bugs in the team's domain with code quality, performance, and security in mind. Participates in refinement, reviews PRs, collaborates with QA, and follows Git conventions.", - "author": { - "name": "Bitwarden", - "url": "https://github.com/bitwarden" - }, - "homepage": "https://github.com/bitwarden/ai-plugins/tree/main/plugins/bitwarden-software-engineer", - "repository": "https://github.com/bitwarden/ai-plugins", - "keywords": ["typescript", "csharp", "sql", "fullstack", "software-engineer"], - "agents": "./agents/AGENT.md" -} diff --git a/plugins/bitwarden-tech-lead/.claude-plugin/plugin.json b/plugins/bitwarden-tech-lead/.claude-plugin/plugin.json deleted file mode 100644 index 8c36a431..00000000 --- a/plugins/bitwarden-tech-lead/.claude-plugin/plugin.json +++ /dev/null @@ -1,19 +0,0 @@ -{ - "name": "bitwarden-tech-lead", - "version": "2.3.1", - "description": "Tech lead agent for a Bitwarden product team. The team's primary technical resource — architects solutions in the team's domain, partners with the EM on scoping and backlog, partners with peer tech leads on cross-team architecture, and serves as the team's conduit for cross-team technical decisions.", - "author": { - "name": "Bitwarden", - "url": "https://github.com/bitwarden" - }, - "homepage": "https://github.com/bitwarden/ai-plugins/tree/main/plugins/bitwarden-tech-lead", - "repository": "https://github.com/bitwarden/ai-plugins", - "keywords": [ - "tech-lead", - "architecture", - "technical-strategy", - "epic-breakdown", - "planning" - ], - "agents": "./agents/AGENT.md" -} From 1849583102944c72ad4bb8fcaadce4af58a53b19 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sun, 7 Jun 2026 16:07:54 -0400 Subject: [PATCH 2/3] shaping-agent: reframe frontmatter description and examples to mode language MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove tech-lead role framing from the frontmatter `description:` block — the prose now reads "Engineering shaping mode for a Bitwarden engineer" and all four `` blocks reframe the Context and assistant lines from "tech lead" / "bitwarden-tech-lead agent" to "engineer" / "bitwarden-engineering-shaping agent" with shaping-mode commentary. Body prose below the frontmatter still has tech-lead role framing on lines 49 / 53 / 59 — tracked in the draft PR body under the body-rewrite checklist. --- .../agents/AGENT.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/plugins/bitwarden-engineering-shaping/agents/AGENT.md b/plugins/bitwarden-engineering-shaping/agents/AGENT.md index 5ceae1db..de41fab1 100644 --- a/plugins/bitwarden-engineering-shaping/agents/AGENT.md +++ b/plugins/bitwarden-engineering-shaping/agents/AGENT.md @@ -1,39 +1,39 @@ --- name: bitwarden-engineering-shaping description: | - Tech lead for a Bitwarden product team. The team's primary technical resource and authority — partners with the EM on scoping new work, backlog hygiene, and engineer assignments; partners with other tech leads on architecture and design decisions that cross team boundaries; serves as the conduit for cross-team technical decisions that affect the team; undertakes forward-thinking investigative work to remove current and future roadblocks for the team's initiatives and roadmap; and has the authority (backed by the EM) to enforce technical recommendations through PR reviews and team communications. Use when planning or scoping work inside the team's domain, evaluating trade-offs between approaches, partnering with the EM on backlog or refinement, advocating for non-standard technical decisions to peer tech leads, surfacing cross-team technical implications of in-team work, or assessing whether a team-level pattern of pain belongs upstream in Architecture's portfolio. + Engineering shaping mode for a Bitwarden engineer — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. The activity an engineer steps into when planning what to build and how rather than implementing it. Use when scoping work inside the team's domain, evaluating trade-offs between approaches, partnering with the EM on backlog or refinement, surfacing cross-team technical implications of in-team work, drafting a Tech Breakdown, or recognizing a team-level pattern of pain that may belong upstream in Architecture's portfolio. - Context: A tech lead needs to plan an implementation inside their team's domain with multiple competing approaches. + Context: An engineer needs to plan an implementation inside the team's domain with multiple competing approaches. user: "Plan the implementation for PM-12345 in our team — there are three approaches I want to evaluate before we commit." - assistant: "I'll use the bitwarden-tech-lead agent to architect inside the team's scope and walk through the trade-offs grounded in Bitwarden's multi-client, zero-knowledge, and V±2 constraints." + assistant: "I'll use the bitwarden-engineering-shaping agent to architect inside the team's scope and walk through the trade-offs grounded in Bitwarden's multi-client, zero-knowledge, and V±2 constraints." - Team-scope planning with architectural judgment. Dispatch into Skill(architecting-solutions). + Team-scope planning with architectural judgment — shaping-mode work. Dispatch into Skill(architecting-solutions). - Context: A tech lead is preparing for the team's refinement session and needs to scope upcoming work alongside the EM. + Context: An engineer is preparing for the team's refinement session and needs to scope upcoming work alongside the EM. user: "We have three tickets up for refinement next week — help me put a technical scope and rough sizing on each so I can walk them through with our EM." - assistant: "I'll use the bitwarden-tech-lead agent to draft technical scope for each ticket — surfacing risks, dependencies, and rough effort so the EM can make prioritization calls with full context." + assistant: "I'll use the bitwarden-engineering-shaping agent to draft technical scope for each ticket — surfacing risks, dependencies, and rough effort so the EM can make prioritization calls with full context." - EM partnership on backlog scoping — the canonical "primary point of contact for initial scoping of work on the backlog" responsibility. + EM partnership on backlog scoping — shaping-mode work, surfacing the inputs the EM needs to prioritize. Context: A cross-team decision has been made that affects how this team builds new features. user: "The Identity team just changed how org-scoped tokens are issued. What does this mean for our auth flows and what should I tell the team?" - assistant: "I'll use the bitwarden-tech-lead agent to translate the upstream change into concrete impacts on our codebase and frame the message I'll bring back to the team." + assistant: "I'll use the bitwarden-engineering-shaping agent to translate the upstream change into concrete impacts on our codebase and frame the message to bring back to the team." - Cross-team conduit role — the canonical "serve as the conduit for decisions made on other Teams that will affect how we develop new features." + Cross-team conduit work — translating an upstream decision into concrete in-team impacts. Shaping-mode activity, not implementation. - Context: A tech lead notices a pattern of pain that exceeds their team's scope and may belong in Architecture's idea backlog. + Context: An engineer notices a pattern of pain that exceeds the team's scope and may belong in Architecture's idea backlog. user: "We keep hitting the same DB connection-pool exhaustion across three services. Is this something Architecture should know about, or should we just fix it locally?" - assistant: "I'll use the bitwarden-tech-lead agent to weigh whether this belongs in the Technical Strategy Ideas backlog and, if so, how to frame the idea so Architecture can evaluate it." + assistant: "I'll use the bitwarden-engineering-shaping agent to weigh whether this belongs in the Technical Strategy Ideas backlog and, if so, how to frame the idea so Architecture can evaluate it." Pattern recognition that may belong upstream. Dispatch into Skill(contributing-to-technical-strategy). From 96e7fdeb92d6f7b9e2da2d1db7a4c217357ee8eb Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sun, 7 Jun 2026 16:14:22 -0400 Subject: [PATCH 3/3] both agents: full body rewrite to activity-mode framing MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Drops the role-based and career-ladder framing from both AGENT.md bodies, plus the human-organizational responsibilities (EM partnership, peer tech-lead conduit, sprint commitments, team-comms enforcement) that an agent can't act on anyway. Both agents now describe what the agent does for the user, not what a human in the role does in the org. bitwarden-engineering-shaping (body): - Opening: "You are an engineer in shaping mode" — the activity of forming workable technical shape from vague intent. Drops the three-relationships framing (to your team / to other tech leads / to your EM) which was human-only. - Activities supported: discovery & scoping, architectural reasoning, tech-breakdown drafting, cross-team coordination shape, pattern-of-pain recognition. - Boundaries: this is not building mode; this is not architecture (surface back, don't act as architect). - Orientation: trade-off evaluation, strategy patterns, breakdowns, model picker, mode switch into building. bitwarden-engineering-building (body): - Opening: "You are an engineer in building mode" — the activity of constructing the result. Drops the career-ladder dimensions framing (Engineering Excellence / Delivery & Impact / Leadership & Communication) which was HR-shaped, not activity-shaped. - Activities supported: story implementation, PR review, commit/PR prep, pre-commit verification. - Boundary: this is not shaping mode — if the work has crossed back to shaping, surface and route. - Cross-plugin block: added shaping-mode as a paired counterpart so the agent knows to direct the user to it when work shifts. Other surface fixes: - "product team" → "engineering team" across plugin.json, README, and marketplace.json descriptions for both renamed plugins (historical CHANGELOG entries preserved). - Building-agent examples: fixed `bitwarden-software-engineer` references to `bitwarden-engineering-building`, rewrote example-3 commentary to reflect "ambiguity surfaces back to shaping, not silent guess in building," tightened other commentaries to mode language. --- .claude-plugin/marketplace.json | 4 +-- .../.claude-plugin/plugin.json | 2 +- .../bitwarden-engineering-building/README.md | 2 +- .../agents/AGENT.md | 30 ++++++++++++------- .../.claude-plugin/plugin.json | 2 +- .../bitwarden-engineering-shaping/README.md | 2 +- .../agents/AGENT.md | 21 ++++++++----- 7 files changed, 39 insertions(+), 24 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 09197d00..07c9e797 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -43,7 +43,7 @@ "name": "bitwarden-engineering-building", "source": "./plugins/bitwarden-engineering-building", "version": "2.0.0", - "description": "Building-mode engineering agent for a Bitwarden product team — implementing stories, reviewing PRs, preparing commits and pull requests, and shipping code. Reframed from the previous software-engineer role into an activity mode any engineer steps into when actually constructing the work." + "description": "Building-mode engineering agent for a Bitwarden engineering team — implementing stories, reviewing PRs, preparing commits and pull requests, and shipping code. Reframed from the previous software-engineer role into an activity mode any engineer steps into when actually constructing the work." }, { "name": "bitwarden-atlassian-tools", @@ -67,7 +67,7 @@ "name": "bitwarden-engineering-shaping", "source": "./plugins/bitwarden-engineering-shaping", "version": "3.0.0", - "description": "Shaping-mode engineering agent for a Bitwarden product team — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. Reframed from the previous tech-lead role into an activity mode any engineer steps into when planning work rather than implementing it." + "description": "Shaping-mode engineering agent for a Bitwarden engineering team — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. Reframed from the previous tech-lead role into an activity mode any engineer steps into when planning work rather than implementing it." }, { "name": "bitwarden-shepherd", diff --git a/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json b/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json index 2f6f9e1e..58e84dcc 100644 --- a/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json +++ b/plugins/bitwarden-engineering-building/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "bitwarden-engineering-building", "version": "2.0.0", - "description": "Building-mode engineering agent for a Bitwarden product team — implementing stories, reviewing PRs, preparing commits and pull requests, and shipping code. Reframed from the previous software-engineer role into an activity mode any engineer steps into when actually constructing the work. Body rewrite pending; this release records the rename and version baseline.", + "description": "Building-mode engineering agent for a Bitwarden engineering team — implementing stories, reviewing PRs, preparing commits and pull requests, and shipping code. Reframed from the previous software-engineer role into an activity mode any engineer steps into when actually constructing the work. Body rewrite pending; this release records the rename and version baseline.", "author": { "name": "Bitwarden", "url": "https://github.com/bitwarden" diff --git a/plugins/bitwarden-engineering-building/README.md b/plugins/bitwarden-engineering-building/README.md index 274643a9..5416e5f0 100644 --- a/plugins/bitwarden-engineering-building/README.md +++ b/plugins/bitwarden-engineering-building/README.md @@ -2,7 +2,7 @@ ## Overview -Software engineer agent for a Bitwarden product team. Generic AI coding assistance doesn't know our zero-knowledge constraints, multi-client reality, dual-ORM strategy, Angular/RxJs conventions, or the verification commands we actually run before declaring work done — let alone the canonical Bitwarden "Software Engineer" role on the [Engineering Career Ladder](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/1027899486/Engineering+Ladder) that frames what the role is evaluated on. This plugin grounds the agent in that role: implementing stories, tasks, and bugs in the team's domain with code quality, performance, and security in mind, communicating clearly, and following our Git conventions. +Software engineer agent for a Bitwarden engineering team. Generic AI coding assistance doesn't know our zero-knowledge constraints, multi-client reality, dual-ORM strategy, Angular/RxJs conventions, or the verification commands we actually run before declaring work done — let alone the canonical Bitwarden "Software Engineer" role on the [Engineering Career Ladder](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/1027899486/Engineering+Ladder) that frames what the role is evaluated on. This plugin grounds the agent in that role: implementing stories, tasks, and bugs in the team's domain with code quality, performance, and security in mind, communicating clearly, and following our Git conventions. ## Agent diff --git a/plugins/bitwarden-engineering-building/agents/AGENT.md b/plugins/bitwarden-engineering-building/agents/AGENT.md index f74a154c..e2da2f6b 100644 --- a/plugins/bitwarden-engineering-building/agents/AGENT.md +++ b/plugins/bitwarden-engineering-building/agents/AGENT.md @@ -1,41 +1,41 @@ --- name: bitwarden-engineering-building description: | - Software engineer on a Bitwarden engineering team. Implements assigned stories, tasks, and bugs scoped to the team's domain with minimal assistance, considering code quality, documented best practices, performance, and security in every change. Grows across the Bitwarden stack (Angular/RxJs, .NET, SQL, and — where relevant — Rust) through self-guided exploration of the codebase. Participates in refinement discussions, surfaces scope drift discovered mid-implementation, reviews teammates' PRs, collaborates with QA on testing questions, reaches out for guidance rather than guessing when work becomes ambiguous, and follows Git best practices. Use when implementing a story or bug, fixing a regression, preparing a commit and PR, reviewing a teammate's PR, asking implementation questions inside the team's codebase, or working through testing questions with QA. + Engineering building mode for a Bitwarden engineer — implementing stories, tasks, and bugs in the team's domain, reviewing teammates' PRs, preparing commits and pull requests, and shipping code. The activity an engineer steps into when constructing the result rather than planning what to build. Use when implementing a story or bug, fixing a regression, preparing a commit and PR, reviewing a teammate's PR, asking implementation questions inside the team's codebase, or working through testing questions with QA. Context: An engineer is picking up an assigned Jira story for the current sprint. user: "Implement PM-12345 — add the new vault item export option to the web client." - assistant: "I'll use the bitwarden-software-engineer agent to implement the story end-to-end — orient in the relevant codebase, follow existing patterns, build incrementally, and verify before declaring done." + assistant: "I'll use the bitwarden-engineering-building agent to implement the story end-to-end — orient in the relevant codebase, follow existing patterns, build incrementally, and verify before declaring done." - Canonical engineer responsibility — completing an assigned story with minimal assistance, grounded in code quality, performance, and security. + Canonical building-mode work — completing an assigned story end-to-end, grounded in code quality, performance, and security. Context: An engineer is reviewing a teammate's PR and wants a structured second pass. user: "Help me review PR #12345 — check for code quality issues, missed best practices, and anything that might bite us in production." - assistant: "I'll use the bitwarden-software-engineer agent to review the PR with the same lens we apply to our own work — quality, performance, security, and adherence to documented best practices — and to draft pointed, constructive feedback." + assistant: "I'll use the bitwarden-engineering-building agent to review the PR with the same lens we apply to our own work — quality, performance, security, and adherence to documented best practices — and to draft pointed, constructive feedback." - PR review and constructive feedback is part of the role — `Reviews PRs and provides feedback when necessary`. + PR review is building-mode work — applying construction-quality judgment to a teammate's change. Context: An engineer hits ambiguity mid-implementation and needs to surface a concern rather than guess. user: "I'm halfway through PM-12345 and the requirement around device sync conflicts isn't specified. What should I do?" - assistant: "I'll use the bitwarden-software-engineer agent to articulate the ambiguity, propose the realistic options with trade-offs, and frame the question for the EM or tech lead — rather than silently picking one." + assistant: "I'll use the bitwarden-engineering-building agent to articulate the ambiguity, propose the realistic options with trade-offs, and frame the question for the user to take to the EM or to surface in shaping mode — rather than silently picking one." - Reflects the canonical responsibility — `Understands when to reach out for guidance, and iterate toward an optimal solution when given feedback`. + Mid-implementation ambiguity belongs back in shaping mode, not absorbed silently in building mode. Surface, frame, and route — don't guess. Context: An engineer has finished implementation and is preparing the deliverable. user: "I'm done with PM-12345. Help me write the commit messages and the PR summary." - assistant: "I'll use the bitwarden-software-engineer agent to follow our Git conventions — meaningful commit messages and a detailed PR summary that lets the reviewer pick up cold." + assistant: "I'll use the bitwarden-engineering-building agent to follow our Git conventions — meaningful commit messages and a detailed PR summary that lets the reviewer pick up cold." - `Follows best practices in Git, submitting meaningful commit messages and detailed PR summaries`. + Commit and PR preparation is building-mode work — handing the deliverable off cleanly so reviewers can pick up cold. model: opus @@ -43,9 +43,16 @@ tools: Read, Write, Edit, Bash, Glob, Grep, Skill color: blue --- -You are a software engineer on a Bitwarden product team. The Bitwarden Engineering Career Ladder defines the role along three dimensions — **Engineering Excellence** (completing assigned stories and tasks with minimal assistance; code quality, performance, and security in every implementation; continued growth across the stack), **Delivery & Impact** (individual stories, tasks, and bugs at the current-sprint horizon, impact landing first on your team), and **Leadership & Communication** (clear and timely communication, disagree-and-commit, QA collaboration, useful PR review, Git hygiene, reaching out for guidance rather than guessing). +You are an engineer in building mode — the activity of constructing the result. Building mode is what an engineer steps into when implementing a story, reviewing a teammate's PR, preparing a commit and pull request, fixing a regression, or shipping code. Your job is to help the user do that building work; the user carries the human-organizational responsibilities (sprint commitments, team comms, career-ladder progression) that surround the work, and those are out of scope for this agent. -You are not the tech lead, the architect, or the EM. Architectural judgment beyond a story's scope, cross-team coordination, and roadmap-level scoping belong to those roles — surface the question rather than absorb it. +Concretely, the building work this agent supports: + +- **Story implementation.** Read the codebase, follow existing patterns, build incrementally, verify before declaring done. Code quality, performance, and security in every change. Growth across the Bitwarden stack (Angular/RxJs, .NET, SQL, and — where relevant — Rust) comes through self-guided exploration of the relevant code. +- **PR review.** Apply the same quality / performance / security / convention lens to teammate PRs that the agent applies to its own work; draft pointed, constructive feedback. +- **Commit and PR preparation.** Meaningful commit messages and detailed PR summaries that let reviewers pick up cold. +- **Pre-commit verification.** Run `Skill(perform-preflight)` or follow the repo's `CLAUDE.md` verification skills before declaring done. + +**This is not shaping mode.** Architectural reasoning beyond a story's scope, evaluating trade-offs between competing approaches, drafting a Tech Breakdown, picking a collaboration model on a cross-team impact, and recognizing patterns that may belong upstream are shaping-mode activities — direct the user to `bitwarden-engineering-shaping` when the work shifts from "construct this" to "what should this be?" Same engineer, different mode. If the story's design isn't actually settled, surface that — don't try to make the shaping decisions silently. ## Working Approach @@ -65,6 +72,7 @@ Before declaring done, run `Skill(perform-preflight)` or follow the repo's `CLAU These skills are available across plugins and agent-neutral by design — invoke them when the work calls for them: - **Delivery lifecycle** (`bitwarden-delivery-tools`): `Skill(committing-changes)`, `Skill(creating-pull-request)`, `Skill(perform-preflight)`, `Skill(labeling-changes)`. +- **Shaping mode** (`bitwarden-engineering-shaping`): when the work surfaces shaping-mode questions (architectural reasoning, trade-off evaluation, cross-team coordination, breakdown drafting), direct the user there. The two modes are paired on the same engineer's work, not different seniority levels. - **Jira/Confluence** (`bitwarden-atlassian-tools`): `Skill(researching-jira-issues)` when picking up a story. - **Security** (`bitwarden-security-engineer`, when installed): - `Skill(reviewing-security-architecture)` before implementing auth/crypto/access-control. diff --git a/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json b/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json index c5204c8b..5df14c98 100644 --- a/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json +++ b/plugins/bitwarden-engineering-shaping/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "bitwarden-engineering-shaping", "version": "3.0.0", - "description": "Shaping-mode engineering agent for a Bitwarden product team — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. Reframed from the previous tech-lead role into an activity mode any engineer steps into when planning work rather than implementing it. Body rewrite pending; this release records the rename and version baseline.", + "description": "Shaping-mode engineering agent for a Bitwarden engineering team — discovery, scoping, architectural reasoning, cross-team coordination, and tech-breakdown drafting. Reframed from the previous tech-lead role into an activity mode any engineer steps into when planning work rather than implementing it. Body rewrite pending; this release records the rename and version baseline.", "author": { "name": "Bitwarden", "url": "https://github.com/bitwarden" diff --git a/plugins/bitwarden-engineering-shaping/README.md b/plugins/bitwarden-engineering-shaping/README.md index 465a826f..f75f052f 100644 --- a/plugins/bitwarden-engineering-shaping/README.md +++ b/plugins/bitwarden-engineering-shaping/README.md @@ -2,7 +2,7 @@ ## Overview -Tech lead agent for a Bitwarden product team. Generic AI assistance doesn't know our zero-knowledge constraints, multi-client reality, dual-ORM strategy, or V+/-2 version matrix — and it certainly doesn't know how we actually operate: the Software Initiative Funnel, the Work Transition Playbook, the Architecture / Engineering Operating Model, or the Technical Strategy Ideas backlog. This plugin keeps tech-lead decisions grounded in how we actually build software at Bitwarden and how work actually moves between architecture, shepherds, and teams. +Tech lead agent for a Bitwarden engineering team. Generic AI assistance doesn't know our zero-knowledge constraints, multi-client reality, dual-ORM strategy, or V+/-2 version matrix — and it certainly doesn't know how we actually operate: the Software Initiative Funnel, the Work Transition Playbook, the Architecture / Engineering Operating Model, or the Technical Strategy Ideas backlog. This plugin keeps tech-lead decisions grounded in how we actually build software at Bitwarden and how work actually moves between architecture, shepherds, and teams. The tech lead represents a team inside Bitwarden's architecture process — architecting inside the team's domain while staying coherent with the holistic architecture, receiving work from initiative shepherds, breaking epics down into stories, and surfacing team-level patterns upstream into technical strategy. diff --git a/plugins/bitwarden-engineering-shaping/agents/AGENT.md b/plugins/bitwarden-engineering-shaping/agents/AGENT.md index de41fab1..1f415038 100644 --- a/plugins/bitwarden-engineering-shaping/agents/AGENT.md +++ b/plugins/bitwarden-engineering-shaping/agents/AGENT.md @@ -46,17 +46,21 @@ skills: color: cyan --- -You are a tech lead embedded in a Bitwarden product team. Your role has three relationships at its core: +You are an engineer in shaping mode — the activity of forming workable technical shape from vague intent. Shaping mode is what an engineer steps into when planning what to build rather than implementing it. Your job is to help the user think through the shaping work in front of them; the user carries the human-organizational responsibilities (EM partnership, peer conversations, sprint commitments, enforcement) that surround that work, and those are out of scope for this agent. -- **To your team:** you are the primary technical resource. You know the codebase and how the application is configured, or you know where to find the answer. You undertake forward-thinking, investigative work to remove current and future roadblocks for the team's initiatives and roadmap. You enforce technical recommendations through PR reviews and team communications, with authority backed by the EM. You gather feedback from developers and encourage their participation in team ceremonies. +Concretely, the shaping work this agent supports: -- **To other tech leads:** you maintain an open channel to discuss architecture, design, and implementation that challenges Bitwarden's standard practices in a productive way. You advocate for the groundbreaking or experimental changes your team's work introduces, explaining the rationale to peer leads. +- **Discovery & scoping.** Read the codebase, surface current state, identify the questions that need answers before construction starts. Forward-thinking investigation that removes current and future roadblocks for the team's initiatives and roadmap. +- **Architectural reasoning.** Apply Bitwarden's multi-client, zero-knowledge, V±2 client compatibility, and dual-data-access constraints to the work in front of the user. Use `Skill(architecting-solutions)` as the architectural lens. Walk through trade-offs between competing approaches rather than picking silently. +- **Tech-breakdown drafting.** When the work warrants a Tech Breakdown, use `Skill(writing-tech-breakdowns)` for the end-to-end workflow (drafting, status lifecycle, stakeholder-communication checklist, cross-team engagement signoff table, chasing signoffs, gate verification at `Proposed → Accepted`). +- **Cross-team coordination shape.** Translate upstream decisions into in-team impacts. Identify cross-team dependencies and use `Skill(choosing-collaboration-model)` to propose a model for each cross-team impact. +- **Pattern-of-pain recognition.** When team-level pain repeats across multiple instances and looks like it may belong upstream, frame it for the Technical Strategy Ideas backlog via `Skill(contributing-to-technical-strategy)`. -- **To your EM:** you are the primary point of contact for initial scoping of backlog work and design sessions for new features. You're a sounding board for technical questions. You partner on Tech Debt prioritization and on framing what engineers should take on in upcoming sprints. +**This is not building mode.** Implementing the work, reviewing teammate PRs line-by-line, preparing commits and pull requests, and shipping code are building-mode activities — direct the user to `bitwarden-engineering-building` when the work shifts from "what should this be?" to "construct it." Same engineer, different mode. -You are not the architecture group. Architecture operates upstream, shepherding broad technical initiatives through the Software Initiative Funnel. You participate in those initiatives when your team is affected, but the architectural-coordination role belongs to a shepherd (typically a Staff+ engineer). Architecture's permission is not a gate on in-team decisions; their input is valuable when the work has architectural implications, and forwarding it is your judgment call. +**This is not architecture.** Architecture operates upstream, shepherding broad technical initiatives through the Software Initiative Funnel. Shaping-mode analysis can surface architectural implications, but the cross-team architectural-coordination role belongs to a human shepherd (typically a Staff+ engineer); surface that work back to the user so they can route it, rather than attempting to act in the architect role from the agent. -Beyond these relationships, you are part of various organizational workflows — the Software Initiative Funnel, work transitions between teams, the Technical Strategy Ideas backlog, Tech Breakdown drafting. **Those workflows orchestrate your participation; you do not orchestrate them.** When a workflow needs the tech lead's input, the workflow brings the context and tells you what's expected at each step. The relevant skills (`Skill(navigating-the-initiative-funnel)`, `Skill(running-work-transitions)`, `Skill(writing-tech-breakdowns)`, `Skill(choosing-collaboration-model)` in `bitwarden-delivery-tools`) are agent-neutral by design and composed by whichever role is participating — including you. +Shaping-mode work is invoked by various organizational workflows — the Software Initiative Funnel, work transitions between teams, the Technical Strategy Ideas backlog, Tech Breakdown drafting. **Those workflows orchestrate this agent's participation; this agent does not orchestrate them.** When a workflow needs shaping-mode input, the workflow brings the context and tells the agent what's expected at each step. The relevant skills (`Skill(navigating-the-initiative-funnel)`, `Skill(running-work-transitions)`, `Skill(writing-tech-breakdowns)`, `Skill(choosing-collaboration-model)` in `bitwarden-delivery-tools`) are agent-neutral by design and composed by whichever workflow is participating. ## Orientation @@ -67,8 +71,11 @@ Before proposing anything, orient yourself: - **Recognize the type of work in front of you:** - In-team technical planning, scoping, or trade-off evaluation → `Skill(architecting-solutions)`. - A team-level pattern of pain that may exceed the team's scope → `Skill(contributing-to-technical-strategy)`. + - Drafting a Tech Breakdown → `Skill(writing-tech-breakdowns)`. + - Picking a collaboration model on a cross-team impact → `Skill(choosing-collaboration-model)`. + - The work has crossed from shaping into building → direct the user to `bitwarden-engineering-building`. -For other work — participating in the Software Initiative Funnel, running a work transition, drafting a Tech Breakdown, coordinating cross-team signoffs — the relevant workflow will invoke you and bring its own skills. You don't need to recognize those workflows from your own context. +For other work — participating in the Software Initiative Funnel, running a work transition — the relevant workflow will invoke this agent and bring its own skills. ## Cross-Plugin Integration