Bitwarden Designer
Bitwarden Dev Ops Engineer
Bitwarden Product Analyst
Bitwarden Tech Lead
Bitwarden Testing Tools
Claude Config Validator
Claude Retrospective
59 chapters · 270 min
Bitwarden Shepherd
Chapter 52 of 59
Phase 4 (Scoping & Commitment) deep-dive playbook — High-Level Architecture Plan, child epics, per-team handoffs, leadership go/no-go.
8 minutes · 1,746 words · 15 sections
Phase 4 (Scoping & Commitment) deep-dive playbook for an initiative shepherd — the final decision gate before significant resource allocation. The shepherd transitions from leading the work to supporting the teams that will execute it. Deliverables: the High-Level Architecture Plan, child epics, per-team handoff meetings, cost-benefit analysis, leadership go/no-go presentation, operational prioritization, capacity allocation, and the finalized ADR. Time budget: 2–4 weeks, 30–50 hours of shepherd time. Composes Skill(running-work-transitions) in bitwarden-delivery-tools for the originating-side Preparation and Transition Sessions phases of the Work Transition Playbook (opens in a new tab).
Before anything else: the team owns the breakdown — not the shepherd. The single biggest failure mode at this phase is the shepherd writing the team’s stories.
The funnel doc is unambiguous: “After the handoff, run a team breakdown session. The team creates the stories — not the shepherd.” Stories the team didn’t write are stories the team won’t own. Once that happens, downstream failure shows up as “we’re behind schedule because the stories don’t match how the team actually works” and there’s no clean recovery.
Hold the line. Your job is to give each team enough context, scope, and pattern to break the work down well — not to break it down for them.
Phase 4 produces eight artifacts, in roughly this order: the High-Level Architecture Plan, child epics in Jira, the per-team handoff meetings, a cost/benefit analysis, the assigned initiative priority, the leadership presentation for go/no-go, operational prioritization with capacity allocation, and the finalized ADR. Each follows below as its own section.
A Confluence page placed under the EN-space architecture-planning folder, following the “High-Level Architecture Planning” template. The funnel doc specifies its content:
The architecture plan is the document each team’s tech lead reads before the handoff meeting. Write it for that reader.
Create epics under the BW initiative — typically one per team or major module. Each epic carries:
initiative-typescript-migration). This is how everyone’s dashboard rolls up progress later.Example epic shape from the funnel doc:
Epic: Migrate Browser Extension to New Error Pattern Team: Browser Extension Team Description:
- Adopt error middleware pattern proven in PoC (PR #1234)
- Apply to background scripts, content scripts, and popup
- Must maintain existing error reporting to Sentry
- Success: All extension error handling follows new pattern, zero regressions
What does not go in the epic: the implementing stories. Those come from the team’s own breakdown session.
Schedule one handoff meeting per team, 1 hour each. Per the funnel doc, the structure is:
| Time | What |
|---|---|
| 20 min | Shepherd presents: PoC findings, architecture plan section for this team |
| 15 min | Q&A — team asks clarifying questions about approach |
| 15 min | Team discusses: initial thoughts on breakdown approach |
| 10 min | Next steps — team commits to completing breakdown by a specific date |
This is also Phase 2 of the Work Transition Playbook from the originating side. The funnel doc references the playbook explicitly; both perspectives apply.
Before the meeting:
In the meeting:
After the meeting:
Document in the architecture plan. The funnel doc’s framing:
Per the funnel doc, work with engineering leadership to set priority against other initiatives and the Architecture / Engineering Operating Model (opens in a new tab) portfolio:
Update the priority on the BW initiative in Jira.
Present the plan to engineering leadership at a stakeholder sync. Per the funnel doc, include:
Seek an explicit go/no-go decision. Executive commitment means: “Yes, we’re allocating resources to complete this initiative.”
This is the step the funnel doc explicitly distinguishes from executive commitment. Executive commitment says “yes, eventually.” Operational prioritization says “starting on these dates with this much capacity.”
Coordinate with engineering leadership:
Engineering leadership works with team leads and EMs to:
Outputs from this step (per the funnel doc):
The funnel doc names this failure mode explicitly: an initiative with executive commitment but no operational prioritization stalls in backlogs indefinitely. Do not advance to Implementation without operational prioritization.
During Scoping (see Idea-Based Initiatives (opens in a new tab)):
Per the funnel doc:
The five key success factors the funnel doc names:
When you move into Implementation (via Skill(coordinating-implementation-across-teams)), the support-period phase of the Work Transition Playbook begins. The originating-side guidance — what to use you for and what not to use you for — is in Skill(running-work-transitions). Read it before Implementation kicks off; it’s the same playbook the receiving teams are reading.
Skill(shepherding-an-initiative) for the umbrella playbook; Skill(running-work-transitions) (in bitwarden-delivery-tools) for the originating-side handoff mechanics; Skill(coordinating-implementation-across-teams) for what Scoping feeds into.Install this repository
npx skills add bitwarden/ai-plugins/plugin marketplace add bitwarden/ai-pluginsSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
Skill,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_issue,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_issue_comments,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_issue_remote_links,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__search_issues,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_confluence_page,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__get_confluence_page_comments,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__search_confluence,mcp__plugin_bitwarden-atlassian-tools_bitwarden-atlassian__search_confluence_cqlplugins/bitwarden-shepherd/skills/scoping-and-handing-off-to-teams/SKILL.mdmain, last pushed 8 August 2026.SKILL.md, not by matching a directory convention. 13 distinct layouts observed: plugins/bitwarden-atlassian-tools/skills/*/SKILL.md, plugins/bitwarden-code-review/skills/*/SKILL.md, plugins/bitwarden-delivery-tools/skills/*/SKILL.md, plugins/bitwarden-design-tools/skills/*/SKILL.md, plugins/bitwarden-designer/skills/*/SKILL.md, plugins/bitwarden-devops-engineer/skills/*/SKILL.md, plugins/bitwarden-product-analyst/skills/*/SKILL.md, plugins/bitwarden-security-engineer/skills/*/SKILL.md, plugins/bitwarden-shepherd/skills/*/SKILL.md, plugins/bitwarden-tech-lead/skills/*/SKILL.md, plugins/bitwarden-testing-tools/skills/*/SKILL.md, plugins/claude-config-validator/skills/*/SKILL.md, plugins/claude-retrospective/skills/*/SKILL.md..claude-plugin/marketplace.json by Bitwarden, declaring 16 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./bitwarden/ai-plugins.md, and each chapter at its own .md URL.