Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -65,9 +65,9 @@
"description": "GitHub Actions workflow compliance, action security auditing, and org-wide CI/CD remediation."
},
{
"name": "bitwarden-architect",
"source": "./plugins/bitwarden-architect",
"version": "1.0.0",
"name": "bitwarden-tech-lead",
"source": "./plugins/bitwarden-tech-lead",
"version": "2.0.0",
"description": "Software architect agent for planning features across any Bitwarden repository. Discovers platform context dynamically via CLAUDE.md and repo-local planning skills."
}
]
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ A curated collection of plugins for AI-assisted development at Bitwarden. Enable

| Plugin | Version | Description |
| ------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| [bitwarden-architect](plugins/bitwarden-architect/) | 1.0.0 | Software architect for technical planning, architecture reviews, and implementation phasing |
| [bitwarden-tech-lead](plugins/bitwarden-tech-lead/) | 2.0.0 | Software architect for technical planning, architecture reviews, and implementation phasing |
| [bitwarden-atlassian-tools](plugins/bitwarden-atlassian-tools/) | 2.2.3 | Read-only Atlassian access via MCP server with deep Jira issue research skill |
| [bitwarden-code-review](plugins/bitwarden-code-review/) | 1.9.0 | Autonomous code review agent following Bitwarden engineering standards with GitHub integration |
| [bitwarden-devops-engineer](plugins/bitwarden-devops-engineer/) | 0.1.1 | DevOps engineering assistant: workflow compliance linting, action security auditing, and org-wide CI/CD remediation |
Expand Down
56 changes: 0 additions & 56 deletions plugins/bitwarden-architect/README.md

This file was deleted.

Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
{
"name": "bitwarden-architect",
"version": "1.0.0",
"name": "bitwarden-tech-lead",
"version": "2.0.0",
"description": "Software architect agent for planning features across any Bitwarden repository. Discovers platform context dynamically via CLAUDE.md and repo-local planning skills.",
"author": {
"name": "Bitwarden",
"url": "https://github.com/bitwarden"
},
"homepage": "https://github.com/bitwarden/ai-plugins/tree/main/plugins/bitwarden-architect",
"homepage": "https://github.com/bitwarden/ai-plugins/tree/main/plugins/bitwarden-tech-lead",
"repository": "https://github.com/bitwarden/ai-plugins",
"keywords": [
"architect",
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
# Changelog

All notable changes to the `bitwarden-architect` plugin will be documented in this file.
All notable changes to the `bitwarden-tech-lead` plugin 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-04-24

### Changed

- **BREAKING:** Renamed plugin from `bitwarden-architect` to `bitwarden-tech-lead`. Users must uninstall the old plugin and reinstall under the new name (`/plugin install bitwarden-tech-lead@bitwarden-marketplace`). The agent's callable identifier (`name:` in AGENT.md frontmatter) also changed to `bitwarden-tech-lead`.

## [1.0.0] - 2026-04-16

### Added
Expand Down
72 changes: 72 additions & 0 deletions plugins/bitwarden-tech-lead/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Bitwarden Tech Lead Plugin

## 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.

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.

## Agent

| Agent | What It Does |
| --------------------- | ------------------------------------------ |
| `bitwarden-tech-lead` | Plans and architects inside a team's scope |

## Skills

| Skill | What It Does |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| `architecting-solutions` | Tech lead's architectural judgment framework: security mindset, blast radius, Bitwarden constraints |

## Cross-Plugin Integration

| Plugin | How It's Used |
| ----------------------------- | ------------------------------------------------------------------------ |
| `bitwarden-security-engineer` | Security context (P01-P06), architecture pattern review, threat modeling |
| `bitwarden-product-analyst` | Consumes requirements documents as upstream input |
| `bitwarden-software-engineer` | Implementation conventions for server, client, and database decisions |
| `bitwarden-atlassian-tools` | Jira issue research and Confluence page access |

All cross-plugin skills are required because we rely upon each of them for a rich, complete workflow.

## Installation

```bash
/plugin install bitwarden-tech-lead@bitwarden-marketplace
```

### Upgrading from `bitwarden-architect`

This plugin was previously named `bitwarden-architect`. The rename reflects Bitwarden's actual role nomenclature β€” teams are led by tech leads, not team-level architects; the architecture group operates upstream. To upgrade:

```bash
/plugin uninstall bitwarden-architect@bitwarden-marketplace
/plugin install bitwarden-tech-lead@bitwarden-marketplace
```

## Usage

The tech lead agent activates when you're working inside your team's scope:

```
Plan the implementation for PM-12345 within our team
```

```
Break down the epic BW-123456 into stories for our team
```

```
We're receiving a framework transition from the Platform team. Help me prepare.
```

## References

- [Software Initiative Funnel](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/584515614)
- [Work Transition Playbook](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/2521038855)
- [Architecture / Engineering Operating Model](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/1286963201)
- [Technical Strategy Ideas](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/2344517656)
- [Idea-Based Initiatives](https://bitwarden.atlassian.net/wiki/spaces/EN/pages/2785181779)
- [Bitwarden Security Definitions](https://contributing.bitwarden.com/architecture/security/definitions)
- [Bitwarden Security Principles](https://contributing.bitwarden.com/architecture/security/principles/)
- [Bitwarden Contributing Guidelines](https://contributing.bitwarden.com/contributing/)
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
name: bitwarden-architect
description: "Software architect for technical planning, architecture decisions, blast radius assessment, and implementation phasing across Bitwarden repositories. Use when planning a feature, reviewing architecture, assessing blast radius, choosing between approaches, or producing a phased implementation plan. Produces structured architecture plans ready for the software-engineer agent."
name: bitwarden-tech-lead
description: "Tech lead for a Bitwarden product team. Architects solutions inside the team's domain while staying coherent with Bitwarden's holistic architecture. Use when planning work inside a team's scope, receiving a work transition, breaking down an initiative epic, and choosing between approaches within a team."
model: opus
tools: Read, Write, Glob, Grep, Skill
skills:
- architecting-solutions
color: cyan
---

You are a senior software architect at Bitwarden. Your primary job is not writing code β€” it's surveying the landscape of possible solutions, choosing the right approach, and producing plans that engineers execute. You plan, you evaluate trade-offs, you break work into phases, and you ensure the pieces fit together. When a feature needs building, you decide _what_ gets built and _how_ the parts connect β€” then you hand implementation to engineers who specialize in writing code.
You are a tech lead embedded in a Bitwarden product team. Your primary job is not writing code β€” it's surveying the landscape of possible solutions inside your team's domain, choosing the right approach, and producing plans that the team executes. You plan, you evaluate trade-offs, you break epic-level work into stories, and you make sure the pieces fit together both inside your team and alongside the rest of Bitwarden's architecture.

## Orientation

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: architecting-solutions
description: Principal engineer perspective on architecture, system design, architecture reviews, blast radius assessment, trade-off analysis, and decision-making. Use when planning a solution, reviewing architecture, assessing blast radius, evaluating trade-offs, or needing expert software engineering advice.
description: Tech lead perspective on architecture, system design, architecture reviews, blast radius assessment, trade-off analysis, and decision-making. Use when planning a solution, reviewing architecture, assessing blast radius, evaluating trade-offs, or needing expert software engineering advice.
---

## Security Mindset
Expand Down
Loading