Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
6bdf7ca
Initial skils for new breakdown.
trmartin4 Jun 9, 2026
988130c
PR feedback.
trmartin4 Jun 9, 2026
2957433
Clarifications on gate.
trmartin4 Jun 9, 2026
6e39f15
PR feedback.
trmartin4 Jun 9, 2026
65fee3b
Allowing MCP for querying Jira.
trmartin4 Jun 9, 2026
566b8cd
PR feedback.
trmartin4 Jun 9, 2026
f52c99b
Extract developing-the-plan skill from tech-breakdown-skill-updates
trmartin4 Jun 10, 2026
8859c5d
Added breakdown plan skill.
trmartin4 Jun 10, 2026
b9ae00d
Added new task skill.
trmartin4 Jun 10, 2026
da2d16c
More explicitly handle reading content.
trmartin4 Jun 10, 2026
23e1928
Remove skill created during evaluation.
trmartin4 Jun 10, 2026
f523aa4
PR feedback
trmartin4 Jun 10, 2026
e8ab115
Enhancements.
trmartin4 Jun 10, 2026
6f73126
Removed specific reference to Spec-Kit.
trmartin4 Jun 10, 2026
f0fb11d
Cleaned up process flow.
trmartin4 Jun 10, 2026
d3743c2
PR feedback.
trmartin4 Jun 11, 2026
dda75aa
Remove spec-kit reference
trmartin4 Jun 11, 2026
2f25608
Removed "the" from skill names.
trmartin4 Jun 11, 2026
f89a12b
Merge branch 'tech-breakdown-spec-skill' into tech-breakdown-plan-skill
trmartin4 Jun 11, 2026
cf7ce16
Remove "the" from skill name.
trmartin4 Jun 11, 2026
dfb3d47
Removed duplicate folder.
trmartin4 Jun 11, 2026
95fa9ba
Removing Spec-Kit, again.
trmartin4 Jun 11, 2026
13c8aa6
Updates to task skill.
trmartin4 Jun 11, 2026
5b30416
Updated to use folder structure to support separate files for tasks.
trmartin4 Jun 11, 2026
16f4eae
Merge branch 'tech-breakdown-spec-skill' into tech-breakdown-plan-skill
trmartin4 Jun 11, 2026
5bd0a70
Updated wording.
trmartin4 Jun 11, 2026
3133bdb
Prompt for breakdown location.
trmartin4 Jun 11, 2026
29980e7
Added orientation requirement.
trmartin4 Jun 11, 2026
f3051b6
Updated with orientation.
trmartin4 Jun 11, 2026
1dd89dd
Added required tools.
trmartin4 Jun 12, 2026
573c5d8
PR feedback.
trmartin4 Jun 12, 2026
018d320
Added plan skill reference.
trmartin4 Jun 12, 2026
e5b78b9
PR feedback.
trmartin4 Jun 12, 2026
7d71286
Merge branch 'tech-breakdown-spec-skill' into tech-breakdown-plan-skill
trmartin4 Jun 12, 2026
26b4e6b
Updated template reference.
trmartin4 Jun 12, 2026
66bbb7d
Merge branch 'tech-breakdown-spec-skill' into tech-breakdown-plan-skill
trmartin4 Jun 12, 2026
03be9e7
Merge branch 'tech-breakdown-plan-skill' into tech-breakdown-tasks-skill
trmartin4 Jun 12, 2026
dcbadea
Cleanup.
trmartin4 Jun 12, 2026
0aa8a7b
Linting and diagram consolidation.
trmartin4 Jun 12, 2026
baa47ca
More additional words.
trmartin4 Jun 12, 2026
b25da12
PR recommendations.
trmartin4 Jun 12, 2026
48df024
Fixed spacing.
trmartin4 Jun 12, 2026
bc1f8d8
Merge branch 'tech-breakdown-plan-skill' into tech-breakdown-tasks-skill
trmartin4 Jun 12, 2026
1b4b6f6
Removed reference to model for collaboration.
trmartin4 Jun 13, 2026
18fa71e
Merge branch 'main' into tech-breakdown-plan-skill
trmartin4 Jun 15, 2026
5f19152
Architecting solutions changes.
trmartin4 Jun 15, 2026
7616ead
Merge branch 'tech-breakdown-plan-skill' into tech-breakdown-tasks-skill
trmartin4 Jun 15, 2026
ad817f2
Removed obsolete skills.
trmartin4 Jun 15, 2026
62b1e12
Fix incorrect references.
trmartin4 Jun 15, 2026
b8aa114
Merge branch 'main' into tech-breakdown-tasks-skill
trmartin4 Jun 19, 2026
45293c7
Removed worked example.
trmartin4 Jun 19, 2026
a34fb83
Code review feedback.
trmartin4 Jun 19, 2026
882fe63
Skill creator feedback.
trmartin4 Jun 19, 2026
01717d0
Removed unnecessary allowed tools.
trmartin4 Jun 19, 2026
198079b
Path changes.
trmartin4 Jun 19, 2026
3bf559b
Fix given/when/when order.
trmartin4 Jun 19, 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
6 changes: 3 additions & 3 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@
{
"name": "bitwarden-tech-lead",
"source": "./plugins/bitwarden-tech-lead",
"version": "2.3.1",
"version": "2.3.2",
"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."
},
{
Expand All @@ -78,8 +78,8 @@
{
"name": "bitwarden-delivery-tools",
"source": "./plugins/bitwarden-delivery-tools",
"version": "1.5.0",
"description": "Delivery lifecycle skills for Bitwarden initiatives — initiative funnel navigation, work transitions, tech breakdowns and cross-team signoffs, commits, pull requests, preflight checks, and change labeling."
"version": "2.0.0",
"description": "Delivery lifecycle skills for Bitwarden initiatives — initiative funnel navigation, work transitions, tech breakdowns and task decomposition, commits, pull requests, preflight checks, and change labeling."
},
{
"name": "bitwarden-designer",
Expand Down
3 changes: 3 additions & 0 deletions .cspell.json
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@
"docstrings",
"dread",
"duedate",
"duplicative",
"ECDH",
"ECIES",
"editui",
Expand Down Expand Up @@ -70,13 +71,15 @@
"lockfiles",
"maxResults",
"mcp",
"MECE",
"metacharacters",
"modelcontextprotocol",
"msword",
"MVVM",
"myapp",
"mypassword",
"myproject",
"narratively",
"Newtonsoft",
"nextPageToken",
"numstat",
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ A curated collection of plugins for AI-assisted development at Bitwarden. Enable

| 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-tech-lead](plugins/bitwarden-tech-lead/) | 2.3.2 | 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.7 | 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/) | 1.5.0 | Delivery lifecycle skills: initiative funnel navigation, work transitions, tech breakdowns and cross-team signoffs, commits, PRs, preflight, labeling |
| [bitwarden-delivery-tools](plugins/bitwarden-delivery-tools/) | 2.0.0 | Delivery lifecycle skills: initiative funnel navigation, work transitions, tech breakdowns and task decomposition, 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 |
Expand Down
6 changes: 3 additions & 3 deletions plugins/bitwarden-delivery-tools/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "bitwarden-delivery-tools",
"version": "1.5.0",
"description": "Delivery lifecycle skills for Bitwarden initiatives — initiative funnel navigation, work transitions, tech breakdowns and cross-team signoffs, commits, pull requests, preflight checks, and change labeling.",
"version": "2.0.0",
"description": "Delivery lifecycle skills for Bitwarden initiatives — initiative funnel navigation, work transitions, tech breakdowns and task decomposition, commits, pull requests, preflight checks, and change labeling.",
"author": {
"name": "Bitwarden",
"url": "https://github.com/bitwarden"
Expand All @@ -14,7 +14,7 @@
"initiative-funnel",
"work-transition",
"tech-breakdown",
"cross-team-signoff",
"task-decomposition",
"commit",
"pull-request",
"preflight",
Expand Down
17 changes: 16 additions & 1 deletion plugins/bitwarden-delivery-tools/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,24 @@

All notable changes to the `bitwarden-delivery-tools` plugin will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
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-19

### Added

- **`decomposing-into-tasks` skill** — decomposes a breakdown Plan into a `tasks.md` document with one entry per future Jira work item. Supports resumption against a partly-drafted task list.

### Removed

- **BREAKING:** `writing-tech-breakdowns` skill removed. Superseded by `starting-breakdown`, `developing-breakdown-spec`, `developing-breakdown-plan`, and `decomposing-into-tasks`. The skill was deprecated in 1.4.0.
- **BREAKING:** `coordinating-cross-team-breakdown` skill removed.

### Changed

- `navigating-the-initiative-funnel`: cross-references to the removed skills replaced with pointers to `starting-breakdown`, `developing-breakdown-spec`, `developing-breakdown-plan`, and `decomposing-into-tasks`.

## [1.5.0] - 2026-06-17

### Added
Expand Down
21 changes: 10 additions & 11 deletions plugins/bitwarden-delivery-tools/README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# Bitwarden Delivery Tools

Delivery lifecycle skills for Bitwarden initiatives — from routing work through the Software Initiative Funnel and running cross-team work transitions, through drafting Tech Breakdowns and chasing cross-team signoffs, down to the day-to-day mechanics of committing, opening pull requests, running preflight checks, and labeling changes.
Delivery lifecycle skills for Bitwarden initiatives — from routing work through the Software Initiative Funnel and running cross-team work transitions, through drafting Tech Breakdowns and decomposing them into tasks, down to the day-to-day mechanics of committing, opening pull requests, running preflight checks, and labeling changes.

## Overview

These skills define delivery **process** — initiative phases, transition playbooks, tech-breakdown drafting and cross-team signoff workflows, commit formats, PR workflows, quality gates, and labeling conventions. Platform-specific details (build commands, lint tools, test runners) are discovered dynamically from each repo's CLAUDE.md.
These skills define delivery **process** — initiative phases, transition playbooks, tech-breakdown drafting, task decomposition, commit formats, PR workflows, quality gates, and labeling conventions. Platform-specific details (build commands, lint tools, test runners) are discovered dynamically from each repo's CLAUDE.md.

The plugin spans three concerns:

- **Lifecycle** — how cross-cutting initiatives move through phases and how ownership transitions between teams.
- **Technical design** — how teams draft and circulate Tech Breakdowns under Bitwarden's standard template, and how cross-team signoff and completion communication get coordinated.
- **Technical design** — how teams draft Tech Breakdowns under Bitwarden's standard template and decompose them into tasks.
- **Mechanics** — how individual changes get committed, reviewed, and merged.

Any agent (tech-lead, software-engineer, shepherds, others) can compose these skills as needed.
Expand All @@ -25,13 +25,12 @@ Any agent (tech-lead, software-engineer, shepherds, others) can compose these sk

### Technical design

| Skill | Triggers | Purpose |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `starting-breakdown` | "start a tech breakdown", "create a new breakdown for X", "set up the breakdown file" | Set up a new Tech Breakdown file in `bitwarden/tech-breakdowns`: gather context from the user, copy the template, fill the Status block. Stops at status `In Planning`. |
| `developing-breakdown-spec` | "understand the work", "resolve open questions", "write the breakdown spec", "Spec Alternatives" | Resolve open design questions one at a time with concrete options, then capture what's being built into the Specification section. |
| `developing-breakdown-plan` | "develop the plan", "draft the implementation plan", "map per-layer impact", "scan for in-flight work", "identify cross-team impacts" | Develop the Plan section after the Spec is filled: technical architecture, per-layer impact, in-flight collision scan, cross-team impact mapping, and self-review. Supports resumption. |
| `writing-tech-breakdowns` | "tech breakdown", "scope checklist", "breakdown status" | **Obsolete — superseded by `starting-breakdown` and `developing-breakdown-spec`.** Previously drafted Parts 1, 2, 4, 5, 6 of Bitwarden's Tech Breakdown Template plus the full status lifecycle. |
| `coordinating-cross-team-breakdown` | "cross-team signoff", "affected teams", "completion communication" | Part 3 signoff table, cross-team checklist, and the completion-communication workflow that closes a breakdown |
| Skill | Triggers | Purpose |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `starting-breakdown` | "start a tech breakdown", "create a new breakdown for X", "set up the breakdown file" | Set up a new Tech Breakdown file in `bitwarden/tech-breakdowns`: gather context from the user, copy the template, fill the Status block. |
| `developing-breakdown-spec` | "understand the work", "resolve open questions", "write the breakdown spec", "Spec Alternatives" | Resolve open design questions one at a time with concrete options, then capture what's being built into the Specification section. |
| `developing-breakdown-plan` | "develop the plan", "draft the implementation plan", "map per-layer impact", "scan for in-flight work", "identify cross-team impacts" | Develop the Plan section after the Spec is filled: technical architecture, per-layer impact, in-flight collision scan, cross-team impact mapping, and self-review. Supports resumption. |
| `decomposing-into-tasks` | "decompose into tasks", "draft the tasks section", "break this into stories", "split into Jira tickets", "fill in the tasks table" | Decompose a Plan into a `tasks.md` document with one entry per future Jira work item. |

### Mechanics

Expand Down Expand Up @@ -71,7 +70,7 @@ Start a Tech Breakdown for this feature — walk me through the scope checklist
```

```
The breakdown is at PROPOSED — who needs to sign off and how do I chase them?
Decompose this breakdown's Plan into tasks
```

```
Expand Down
Loading
Loading