Skip to content

Reframe tech-lead/software-engineer as engineering-shaping/engineering-building #138

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
trmartin4 wants to merge 3 commits into
base: tech-breakdown-skill-updates
Choose a base branch
from
Draft

Reframe tech-lead/software-engineer as engineering-shaping/engineering-building #138

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
339c213
chore: rename tech-lead → engineering-shaping, software-engineer → en…
trmartin4 Jun 7, 2026
1849583
shaping-agent: reframe frontmatter description and examples to mode l…
trmartin4 Jun 7, 2026
96e7fde
both agents: full body rewrite to activity-mode framing
trmartin4 Jun 7, 2026
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
16 changes: 8 additions & 8 deletions .claude-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 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",
Expand All @@ -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 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",
Expand Down
32 changes: 16 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
20 changes: 20 additions & 0 deletions plugins/bitwarden-engineering-building/.claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"name": "bitwarden-engineering-building",
"version": "2.0.0",
"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"
},
"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"
}
8 changes: 7 additions & 1 deletion .../bitwarden-software-engineer/CHANGELOG.md → ...twarden-engineering-building/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion ...ins/bitwarden-software-engineer/README.md → .../bitwarden-engineering-building/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading
Loading