npm - wizz-method - Versions diffs - 1.0.0 - Mend

wizz-method 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (761) hide show

package/build/site/explanation/forensic-investigation/index.html ADDED Viewed

@@ -0,0 +1,167 @@
+<!DOCTYPE html><html lang="en" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-uxe7q6yi"> <head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Forensic Investigation | Wizz Method</title><link rel="canonical" href="http://localhost:3000/explanation/forensic-investigation/"/><link rel="alternate" hreflang="en" href="http://localhost:3000/explanation/forensic-investigation/"/><link rel="alternate" hreflang="vi-VN" href="http://localhost:3000/vi-vn/explanation/forensic-investigation/"/><link rel="alternate" hreflang="zh-CN" href="http://localhost:3000/zh-cn/explanation/forensic-investigation/"/><link rel="alternate" hreflang="fr-FR" href="http://localhost:3000/fr/explanation/forensic-investigation/"/><link rel="alternate" hreflang="cs-CZ" href="http://localhost:3000/cs/explanation/forensic-investigation/"/><link rel="sitemap" href="/sitemap-index.xml"/><link rel="shortcut icon" href="/wizz-icon-orange.svg" type="image/svg+xml"/><meta name="generator" content="Astro v5.18.1"/><meta name="generator" content="Starlight v0.37.5"/><meta property="og:title" content="Forensic Investigation"/><meta property="og:type" content="article"/><meta property="og:url" content="http://localhost:3000/explanation/forensic-investigation/"/><meta property="og:locale" content="en"/><meta property="og:description" content="How bmad-investigate treats every issue like a crime scene, grades evidence, and produces a structured case file engineers can act on"/><meta property="og:site_name" content="Wizz Method"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="How bmad-investigate treats every issue like a crime scene, grades evidence, and produces a structured case file engineers can act on"/><meta name="ai-terms" content="AI-optimized documentation: http://localhost:3000/llms-full.txt (plain text, ~100k tokens, complete Wizz Method reference). Index: http://localhost:3000/llms.txt"/><meta name="llms-full" content="http://localhost:3000/llms-full.txt"/><meta name="llms" content="http://localhost:3000/llms.txt"/><script>
+	window.StarlightThemeProvider = (() => {
+		const storedTheme =
+			typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
+		const theme =
+			storedTheme ||
+			(window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
+		document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
+		return {
+			updatePickers(theme = storedTheme || 'auto') {
+				document.querySelectorAll('starlight-theme-select').forEach((picker) => {
+					const select = picker.querySelector('select');
+					if (select) select.value = theme;
+					/** @type {HTMLTemplateElement | null} */
+					const tmpl = document.querySelector(`#theme-icons`);
+					const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
+					if (newIcon) {
+						const oldIcon = picker.querySelector('svg.label-icon');
+						if (oldIcon) {
+							oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
+						}
+					}
+				});
+			},
+		};
+	})();
+</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M5 12a1 1 0 0 0-1-1H3a1 1 0 0 0 0 2h1a1 1 0 0 0 1-1Zm.64 5-.71.71a1 1 0 0 0 0 1.41 1 1 0 0 0 1.41 0l.71-.71A1 1 0 0 0 5.64 17ZM12 5a1 1 0 0 0 1-1V3a1 1 0 0 0-2 0v1a1 1 0 0 0 1 1Zm5.66 2.34a1 1 0 0 0 .7-.29l.71-.71a1 1 0 1 0-1.41-1.41l-.66.71a1 1 0 0 0 0 1.41 1 1 0 0 0 .66.29Zm-12-.29a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.71-.71a1.004 1.004 0 1 0-1.43 1.41l.73.71ZM21 11h-1a1 1 0 0 0 0 2h1a1 1 0 0 0 0-2Zm-2.64 6A1 1 0 0 0 17 18.36l.71.71a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.76-.66ZM12 6.5a5.5 5.5 0 1 0 5.5 5.5A5.51 5.51 0 0 0 12 6.5Zm0 9a3.5 3.5 0 1 1 0-7 3.5 3.5 0 0 1 0 7Zm0 3.5a1 1 0 0 0-1 1v1a1 1 0 0 0 2 0v-1a1 1 0 0 0-1-1Z"/></svg><svg aria-hidden="true" class="dark astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.64 13a1 1 0 0 0-1.05-.14 8.049 8.049 0 0 1-3.37.73 8.15 8.15 0 0 1-8.14-8.1 8.59 8.59 0 0 1 .25-2A1 1 0 0 0 8 2.36a10.14 10.14 0 1 0 14 11.69 1 1 0 0 0-.36-1.05Zm-9.5 6.69A8.14 8.14 0 0 1 7.08 5.22v.27a10.15 10.15 0 0 0 10.14 10.14 9.784 9.784 0 0 0 2.1-.22 8.11 8.11 0 0 1-7.18 4.32v-.04Z"/></svg><svg aria-hidden="true" class="auto astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg></template><link rel="stylesheet" href="/_astro/print.DNXP8c50.css" media="print"><link rel="stylesheet" href="/_astro/index.DdjI3lF_.css"><script type="module" src="/_astro/page.B1D-nYk3.js"></script></head> <body class="astro-uxe7q6yi"> <a href="#_top" class="astro-7lpm5qv4">Skip to content</a>  <div class="page sl-flex astro-2xv6dk2n"> <header class="header astro-2xv6dk2n"><div class="ai-banner astro-kggsjsm4" role="note" aria-label="AI documentation notice"> <span class="astro-kggsjsm4">🤖 Consolidated, AI-optimized Wizz Method docs: <a href="http://localhost:3000/llms-full.txt" class="astro-kggsjsm4">llms-full.txt</a>. Fetch this plain text file for complete context.</span> </div>  <div class="header sl-flex astro-3ef6ksr2"> <div class="title-wrapper sl-flex astro-3ef6ksr2"> <a href="/" class="site-title sl-flex astro-sv76zpkw">  <span class="astro-sv76zpkw" translate="no"> Wizz Method </span> </a>  </div> <div class="sl-flex print:hidden astro-3ef6ksr2"> <site-search class="astro-3ef6ksr2 astro-kbzrce66" data-translations="{&#34;placeholder&#34;:&#34;Search&#34;}"> <button data-open-modal disabled aria-label="Search" aria-keyshortcuts="Control+K" class="astro-kbzrce66"> <svg aria-hidden="true" class="astro-kbzrce66 astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.71 20.29 18 16.61A9 9 0 1 0 16.61 18l3.68 3.68a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.39ZM11 18a7 7 0 1 1 0-14 7 7 0 0 1 0 14Z"/></svg> <span class="sl-hidden md:sl-block astro-kbzrce66" aria-hidden="true">Search</span> <kbd class="sl-hidden md:sl-flex astro-kbzrce66" style="display: none;"> <kbd class="astro-kbzrce66">Ctrl</kbd><kbd class="astro-kbzrce66">K</kbd> </kbd> </button> <dialog style="padding:0" aria-label="Search" class="astro-kbzrce66"> <div class="dialog-frame sl-flex astro-kbzrce66">  <button data-close-modal class="sl-flex md:sl-hidden astro-kbzrce66"> Cancel </button> <div class="search-container astro-kbzrce66"> <div id="starlight__search" class="astro-kbzrce66"></div> </div> </div> </dialog> </site-search>  <script>
+	(() => {
+		const openBtn = document.querySelector('button[data-open-modal]');
+		const shortcut = openBtn?.querySelector('kbd');
+		if (!openBtn || !(shortcut instanceof HTMLElement)) return;
+		const platformKey = shortcut.querySelector('kbd');
+		if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
+			platformKey.textContent = '⌘';
+			openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
+		}
+		shortcut.style.display = '';
+	})();
+</script> <script type="module" src="/_astro/Search.astro_astro_type_script_index_0_lang.cjYDvRdi.js"></script>   </div> <div class="sl-hidden md:sl-flex print:hidden right-group astro-3ef6ksr2"> <div class="sl-flex social-icons astro-3ef6ksr2"> <a href="https://github.com/wizzcomms/wizz-method" rel="me" class="sl-flex astro-bgmygzip"><span class="sr-only astro-bgmygzip">GitHub</span><svg aria-hidden="true" class="astro-bgmygzip astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="dark" class="astro-nmwkdvwx">Dark</option><option value="light" class="astro-nmwkdvwx">Light</option><option value="auto" selected class="astro-nmwkdvwx">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  <script>
+	StarlightThemeProvider.updatePickers();
+</script> <script type="module">const r="starlight-theme",o=e=>e==="auto"||e==="dark"||e==="light"?e:"auto",c=()=>o(typeof localStorage<"u"&&localStorage.getItem(r));function n(e){typeof localStorage<"u"&&localStorage.setItem(r,e==="light"||e==="dark"?e:"")}const l=()=>matchMedia("(prefers-color-scheme: light)").matches?"light":"dark";function t(e){StarlightThemeProvider.updatePickers(e),document.documentElement.dataset.theme=e==="auto"?l():e,n(e)}matchMedia("(prefers-color-scheme: light)").addEventListener("change",()=>{c()==="auto"&&t("auto")});class s extends HTMLElement{constructor(){super(),t(c()),this.querySelector("select")?.addEventListener("change",a=>{a.currentTarget instanceof HTMLSelectElement&&t(o(a.currentTarget.value))})}}customElements.define("starlight-theme-select",s);</script> <starlight-lang-select><label style="--sl-select-width: 7em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select language</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path fill-rule="evenodd" d="M8.516 3a.94.94 0 0 0-.941.94v1.15H2.94a.94.94 0 1 0 0 1.882h7.362a7.422 7.422 0 0 1-1.787 3.958 7.42 7.42 0 0 1-1.422-2.425.94.94 0 1 0-1.774.627 9.303 9.303 0 0 0 1.785 3.043 7.422 7.422 0 0 1-4.164 1.278.94.94 0 1 0 0 1.881 9.303 9.303 0 0 0 5.575-1.855 9.303 9.303 0 0 0 4.11 1.74l-.763 1.525a.968.968 0 0 0-.016.034l-1.385 2.77a.94.94 0 1 0 1.683.841l1.133-2.267h5.806l1.134 2.267a.94.94 0 0 0 1.683-.841l-1.385-2.769a.95.95 0 0 0-.018-.036l-3.476-6.951a.94.94 0 0 0-1.682 0l-1.82 3.639a7.423 7.423 0 0 1-3.593-1.256 9.303 9.303 0 0 0 2.27-5.203h1.894a.94.94 0 0 0 0-1.881H9.456V3.94A.94.94 0 0 0 8.516 3Zm6.426 11.794a1.068 1.068 0 0 1-.02.039l-.703 1.407h3.924l-1.962-3.924-1.24 2.478Z" clip-rule="evenodd"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="/explanation/forensic-investigation/" class="astro-nmwkdvwx">English</option><option value="/vi-vn/explanation/forensic-investigation/" class="astro-nmwkdvwx">Tiếng Việt</option><option value="/zh-cn/explanation/forensic-investigation/" class="astro-nmwkdvwx">简体中文</option><option value="/fr/explanation/forensic-investigation/" class="astro-nmwkdvwx">Français</option><option value="/cs/explanation/forensic-investigation/" class="astro-nmwkdvwx">Čeština</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label> </starlight-lang-select><script type="module">class s extends HTMLElement{constructor(){super();const e=this.querySelector("select");e&&(e.addEventListener("change",t=>{t.currentTarget instanceof HTMLSelectElement&&(window.location.pathname=t.currentTarget.value)}),window.addEventListener("pageshow",t=>{if(!t.persisted)return;const n=e.querySelector("option[selected]")?.index;n!==e.selectedIndex&&(e.selectedIndex=n??0)}))}}customElements.define("starlight-lang-select",s);</script> </div> </div> </header> <nav class="sidebar print:hidden astro-2xv6dk2n" aria-label="Main"> <starlight-menu-button class="print:hidden astro-rcmu22v7"> <button aria-expanded="false" aria-label="Menu" aria-controls="starlight__sidebar" class="sl-flex md:sl-hidden astro-rcmu22v7"> <svg aria-hidden="true" class="open-menu astro-rcmu22v7 astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M3 8h18a1 1 0 1 0 0-2H3a1 1 0 0 0 0 2Zm18 8H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Zm0-5H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Z"/></svg> <svg aria-hidden="true" class="close-menu astro-rcmu22v7 astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="m13.41 12 6.3-6.29a1.004 1.004 0 1 0-1.42-1.42L12 10.59l-6.29-6.3a1.004 1.004 0 0 0-1.42 1.42l6.3 6.29-6.3 6.29a1 1 0 0 0 0 1.42.998.998 0 0 0 1.42 0l6.29-6.3 6.29 6.3a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.42L13.41 12Z"/></svg> </button> </starlight-menu-button> <script type="module">class s extends HTMLElement{constructor(){super(),this.btn=this.querySelector("button"),this.btn.addEventListener("click",()=>this.toggleExpanded());const t=this.closest("nav");t&&t.addEventListener("keyup",e=>this.closeOnEscape(e))}setExpanded(t){this.setAttribute("aria-expanded",String(t)),document.body.toggleAttribute("data-mobile-menu-expanded",t)}toggleExpanded(){this.setExpanded(this.getAttribute("aria-expanded")!=="true")}closeOnEscape(t){t.code==="Escape"&&(this.setExpanded(!1),this.btn.focus())}}customElements.define("starlight-menu-button",s);</script>   <div id="starlight__sidebar" class="sidebar-pane astro-2xv6dk2n"> <div class="sidebar-content sl-flex astro-2xv6dk2n"> <sl-sidebar-state-persist data-hash="0fp6vz6" class="astro-t57j3vat"> <script aria-hidden="true">
+		(() => {
+			try {
+				if (!matchMedia('(min-width: 50em)').matches) return;
+				/** @type {HTMLElement | null} */
+				const target = document.querySelector('sl-sidebar-state-persist');
+				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
+				if (!target || !state || target.dataset.hash !== state.hash) return;
+				window._starlightScrollRestore = state.scroll;
+				customElements.define(
+					'sl-sidebar-restore',
+					class SidebarRestore extends HTMLElement {
+						connectedCallback() {
+							try {
+								const idx = parseInt(this.dataset.index || '');
+								const details = this.closest('details');
+								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
+							} catch {}
+						}
+					}
+				);
+			} catch {}
+		})();
+	</script>  <ul class="top-level astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/" class="large astro-yhouv36n"> <span class="astro-yhouv36n">Welcome</span>  </a> </li><li class="astro-yhouv36n"> <a href="/roadmap/" class="large astro-yhouv36n"> <span class="astro-yhouv36n">Roadmap</span>  </a> </li><li class="astro-yhouv36n"> <details open class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">Tutorials</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="0"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/tutorials/getting-started/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Getting Started</span>  </a> </li> </ul>  </details> </li><li class="astro-yhouv36n"> <details class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">How-To Guides</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="1"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/how-to/install-bmad/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Install BMad</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/non-interactive-installation/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Non-Interactive Installation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/install-custom-modules/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Install Custom and Community Modules</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/upgrade-to-v6/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Upgrade to v6</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/get-answers-about-bmad/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Get Answers About BMad</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/quick-fixes/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Quick Fixes</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/established-projects/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Established Projects</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/customize-bmad/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Customize BMad</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/project-context/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Manage Project Context</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/shard-large-documents/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Document Sharding Guide</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/expand-bmad-for-your-org/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Expand BMad for Your Organization</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/use-web-bundles/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Use Web Bundles</span>  </a> </li> </ul>  </details> </li><li class="astro-yhouv36n"> <details open class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">Explanation</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="2"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/explanation/named-agents/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Named Agents</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/analysis-phase/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Analysis Phase: From Idea to Foundation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/brainstorming/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Brainstorming</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/advanced-elicitation/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Advanced Elicitation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/why-solutioning-matters/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Why Solutioning Matters</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/preventing-agent-conflicts/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Preventing Agent Conflicts</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/quick-dev/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Quick Dev</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/checkpoint-preview/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Checkpoint Preview</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/adversarial-review/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Adversarial Review</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/forensic-investigation/" aria-current="page" class="astro-yhouv36n"> <span class="astro-yhouv36n">Forensic Investigation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/party-mode/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Party Mode</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/project-context/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Project Context</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/established-projects-faq/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Established Projects FAQ</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/web-bundles/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Web Bundles</span>  </a> </li> </ul>  </details> </li><li class="astro-yhouv36n"> <details class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">Reference</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="3"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/reference/workflow-map/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Workflow Map</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/agents/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Agents</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/core-tools/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Core Tools</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/commands/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Skills</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/modules/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Official Modules</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/testing/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Testing Options</span>  </a> </li> </ul>  </details> </li> </ul>   <script aria-hidden="true">
+		(() => {
+			const scroller = document.getElementById('starlight__sidebar');
+			if (!window._starlightScrollRestore || !scroller) return;
+			scroller.scrollTop = window._starlightScrollRestore;
+			delete window._starlightScrollRestore;
+		})();
+	</script> </sl-sidebar-state-persist>  <div class="md:sl-hidden"> <div class="mobile-preferences sl-flex astro-lbnvevm2"> <div class="sl-flex social-icons astro-lbnvevm2"> <a href="https://github.com/wizzcomms/wizz-method" rel="me" class="sl-flex astro-bgmygzip"><span class="sr-only astro-bgmygzip">GitHub</span><svg aria-hidden="true" class="astro-bgmygzip astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="dark" class="astro-nmwkdvwx">Dark</option><option value="light" class="astro-nmwkdvwx">Light</option><option value="auto" selected class="astro-nmwkdvwx">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  <script>
+	StarlightThemeProvider.updatePickers();
+</script>  <starlight-lang-select><label style="--sl-select-width: 7em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select language</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path fill-rule="evenodd" d="M8.516 3a.94.94 0 0 0-.941.94v1.15H2.94a.94.94 0 1 0 0 1.882h7.362a7.422 7.422 0 0 1-1.787 3.958 7.42 7.42 0 0 1-1.422-2.425.94.94 0 1 0-1.774.627 9.303 9.303 0 0 0 1.785 3.043 7.422 7.422 0 0 1-4.164 1.278.94.94 0 1 0 0 1.881 9.303 9.303 0 0 0 5.575-1.855 9.303 9.303 0 0 0 4.11 1.74l-.763 1.525a.968.968 0 0 0-.016.034l-1.385 2.77a.94.94 0 1 0 1.683.841l1.133-2.267h5.806l1.134 2.267a.94.94 0 0 0 1.683-.841l-1.385-2.769a.95.95 0 0 0-.018-.036l-3.476-6.951a.94.94 0 0 0-1.682 0l-1.82 3.639a7.423 7.423 0 0 1-3.593-1.256 9.303 9.303 0 0 0 2.27-5.203h1.894a.94.94 0 0 0 0-1.881H9.456V3.94A.94.94 0 0 0 8.516 3Zm6.426 11.794a1.068 1.068 0 0 1-.02.039l-.703 1.407h3.924l-1.962-3.924-1.24 2.478Z" clip-rule="evenodd"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="/explanation/forensic-investigation/" class="astro-nmwkdvwx">English</option><option value="/vi-vn/explanation/forensic-investigation/" class="astro-nmwkdvwx">Tiếng Việt</option><option value="/zh-cn/explanation/forensic-investigation/" class="astro-nmwkdvwx">简体中文</option><option value="/fr/explanation/forensic-investigation/" class="astro-nmwkdvwx">Français</option><option value="/cs/explanation/forensic-investigation/" class="astro-nmwkdvwx">Čeština</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label> </starlight-lang-select> </div>  </div> </div> </div> </nav> <div class="main-frame astro-2xv6dk2n">  <script type="module">const a=document.getElementById("starlight__sidebar"),n=a?.querySelector("sl-sidebar-state-persist"),o="sl-sidebar-state",i=()=>{let t=[];const e=n?.dataset.hash||"";try{const s=sessionStorage.getItem(o),r=JSON.parse(s||"{}");Array.isArray(r.open)&&r.hash===e&&(t=r.open)}catch{}return{hash:e,open:t,scroll:a?.scrollTop||0}},c=t=>{try{sessionStorage.setItem(o,JSON.stringify(t))}catch{}},d=()=>c(i()),l=(t,e)=>{const s=i();s.open[e]=t,c(s)};n?.addEventListener("click",t=>{if(!(t.target instanceof Element))return;const e=t.target.closest("summary")?.closest("details");if(!e)return;const s=e.querySelector("sl-sidebar-restore"),r=parseInt(s?.dataset.index||"");isNaN(r)||l(!e.open,r)});addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&d()});addEventListener("pageHide",d);</script> <div class="lg:sl-flex astro-ppt5ty36"> <aside class="right-sidebar-container print:hidden astro-ppt5ty36"> <div class="right-sidebar astro-ppt5ty36"> <script type="module" src="/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.hwBsy0Mo.js"></script><script type="module" src="/_astro/TableOfContents.astro_astro_type_script_index_0_lang.FuRcXuRY.js"></script><div class="lg:sl-hidden astro-se4agvxv"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-c5ccmeve"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-c5ccmeve"><details id="starlight__mobile-toc" class="astro-c5ccmeve"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-c5ccmeve"><span class="toggle sl-flex astro-c5ccmeve">On this page<svg aria-hidden="true" class="caret astro-c5ccmeve astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></span><span class="display-current astro-c5ccmeve"></span></summary><div class="dropdown astro-c5ccmeve"><ul class="isMobile astro-xsqhb6qp" style="--depth: 0;"> <li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#_top" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Overview</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-problem-with-just-debug-it" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Problem With “Just Debug It”</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#evidence-grading" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Evidence Grading</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#stronghold-first" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Stronghold First</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#hypothesis-discipline" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Hypothesis Discipline</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#challenge-the-premise" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Challenge the Premise</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#a-calibrated-walk" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">A Calibrated Walk</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#methodology-lives-in-the-skill" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Methodology Lives in the Skill</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#what-you-get" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">What You Get</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-bigger-idea" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Bigger Idea</span> </a>  </li> </ul> </div></details></nav></mobile-starlight-toc></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-se4agvxv"><div class="sl-container astro-se4agvxv"><starlight-toc data-min-h="2" data-max-h="3"><nav aria-labelledby="starlight__on-this-page"><h2 id="starlight__on-this-page">On this page</h2><ul class="astro-xsqhb6qp" style="--depth: 0;"> <li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#_top" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Overview</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-problem-with-just-debug-it" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Problem With “Just Debug It”</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#evidence-grading" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Evidence Grading</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#stronghold-first" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Stronghold First</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#hypothesis-discipline" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Hypothesis Discipline</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#challenge-the-premise" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Challenge the Premise</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#a-calibrated-walk" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">A Calibrated Walk</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#methodology-lives-in-the-skill" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Methodology Lives in the Skill</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#what-you-get" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">What You Get</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-bigger-idea" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Bigger Idea</span> </a>  </li> </ul> </nav></starlight-toc></div></div> </div> </aside> <div class="main-pane astro-ppt5ty36">  <main data-pagefind-body class="astro-uxe7q6yi" lang="en" dir="ltr">    <div class="content-panel astro-aoj46c3a"> <div class="sl-container astro-aoj46c3a"> <h1 id="_top" class="astro-obdi53jg">Forensic Investigation</h1>  </div> </div>  <div class="content-panel astro-aoj46c3a"> <div class="sl-container astro-aoj46c3a"> <div class="sl-markdown-content"> <p>You hand <code dir="auto">bmad-investigate</code> a crash log, a stack trace, or just a “this used to work, now it doesn’t”. The skill takes
+over the investigator’s discipline for the duration of the run. It does not start fixing. It opens a case file.</p>
+<p>Every finding gets graded. Every hypothesis gets a status. Wrong turns are kept, not erased. The deliverable is a
+document another engineer can pick up cold.</p>
+<p>This page explains why investigation is its own discipline, and what the skill buys you that a regular dev workflow
+doesn’t.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-problem-with-just-debug-it">The Problem With “Just Debug It”</h2><a class="sl-anchor-link" href="#the-problem-with-just-debug-it"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “The Problem With “Just Debug It””</span></a></div>
+<p>Normal debugging blends three things: looking at evidence, reasoning about cause, and changing code to test the theory.
+When they’re blended, two failure modes show up.</p>
+<p>The first is <strong>narrative lock-in</strong>. The first plausible story becomes the working theory, and every observation gets
+bent to fit it. The bug stays unfixed until someone gives up and starts over. Hours later.</p>
+<p>The second is <strong>evidence amnesia</strong>. You traced something, ruled it out, but didn’t write down why. Two days later, with
+fresh eyes, you trace it again. Or worse, a colleague picks up the bug and re-runs the same dead end you already
+eliminated.</p>
+<p>The skill’s design is a direct response to both.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="evidence-grading">Evidence Grading</h2><a class="sl-anchor-link" href="#evidence-grading"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Evidence Grading”</span></a></div>
+<p>Every finding in an investigation is one of three things.</p>
+<ul>
+<li><strong>Confirmed.</strong> Directly observed in logs, code, or dumps; cited with a specific reference (a <code dir="auto">path:line</code>, a log
+timestamp, a commit hash). If someone asks “how do you know?”, you point at the citation.</li>
+<li><strong>Deduced.</strong> Logically follows from confirmed evidence; the reasoning chain is shown. If a step in the chain is wrong,
+the deduction is wrong, and you can see exactly which step.</li>
+<li><strong>Hypothesized.</strong> Plausible but unconfirmed. States what evidence would confirm or refute, and declares upfront what
+would close it. Hypotheses are explicitly <em>not facts</em>.</li>
+</ul>
+<p>The grading is not about being humble. It’s about making the case file readable. A reader can scan the Confirmed section
+to know what is true, the Deduced section to know what follows, and the Hypothesized section to know what is still open.
+Confusion between the three is the most common reason investigations spiral.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="stronghold-first">Stronghold First</h2><a class="sl-anchor-link" href="#stronghold-first"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Stronghold First”</span></a></div>
+<p>Investigation never starts from a theory. It starts from one piece of confirmed evidence and expands outward. That
+evidence might be a specific error message, a stack frame, or a timestamped log entry.</p>
+<p>This is the opposite of how investigations often go. Someone has a hunch, builds a theory, and then hunts for evidence
+that supports it. The hunch can be right; the <em>method</em> is fragile because it makes confirmation bias the default.</p>
+<p>A stronghold is a fact you can return to when reasoning gets murky. If a deduction takes you somewhere strange, you can
+walk it back to the stronghold and try a different branch. Without one, you don’t know which step to undo.</p>
+<p>When evidence is sparse, the skill says so and switches to hypothesis-driven exploration: form hypotheses from what’s
+available, identify what would test each, present a prioritized data-collection list. Missing evidence is itself a
+finding.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="hypothesis-discipline">Hypothesis Discipline</h2><a class="sl-anchor-link" href="#hypothesis-discipline"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Hypothesis Discipline”</span></a></div>
+<p>Hypotheses are never deleted from the case file. When evidence confirms or refutes one, its <strong>Status</strong> field updates
+from Open to Confirmed or Refuted, and a <strong>Resolution</strong> explains what evidence settled it.</p>
+<p>This rule has a real cost. Case files grow. The benefit is real too. The full reasoning history becomes part of the
+deliverable. Six months later, when a similar bug surfaces, the next investigator can read the original case file and
+see which paths were already eliminated and why. Without that history, every new investigator re-runs the same dead
+ends.</p>
+<p>It also disciplines the present-tense investigator. If you can’t delete a wrong hypothesis, you have to disprove it
+with cited evidence. Quietly dropping it when it becomes inconvenient is no longer an option.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="challenge-the-premise">Challenge the Premise</h2><a class="sl-anchor-link" href="#challenge-the-premise"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Challenge the Premise”</span></a></div>
+<p>The user’s description of the problem is a hypothesis, not a fact. “The cache is broken” is something a user <em>believes</em>.
+Before the skill builds an investigation around it, the technical claims are verified independently. If the evidence
+contradicts the premise, the report says so directly.</p>
+<p>This is the forensic instinct: the witness’s account is data, not truth. Sometimes the reported bug is real but
+mislabeled. Sometimes the described symptom is downstream of a different cause. Investigations that take the premise as
+gospel diagnose the wrong defect, and the bug returns in a slightly different form.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="a-calibrated-walk">A Calibrated Walk</h2><a class="sl-anchor-link" href="#a-calibrated-walk"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “A Calibrated Walk”</span></a></div>
+<p>The skill is one procedure, not two modes. It calibrates how much defect-chasing versus how much area-exploration the
+input demands, on a continuous scale.</p>
+<p>A symptom-driven case (a ticket, a crash, an error message, a “this used to work”) leans into hypothesis tracking,
+timeline reconstruction, and a fix direction. A no-symptom case (understanding a module before you touch it, evaluating
+reusability, building a mental model) leans into I/O mapping, control-flow filtering, and a verification plan. Most
+real cases sit somewhere between, and the case file reflects whichever balance the evidence required.</p>
+<p>The discipline is the same regardless of where on the scale a case lands: stronghold first, evidence grading, hypothesis
+tracking, never erase. The output is always at <code dir="auto">{implementation_artifacts}/investigations/{slug}-investigation.md</code>, with
+sections that don’t apply to a given case left empty or omitted.</p>
+<p>When a deep bug requires understanding a broader subsystem, the procedure folds in the I/O mapping, control-flow
+filtering, working-backward-from-outputs, and cross-component boundary tracing techniques inline. The area model lands
+in the same case file. There is no mode switch.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="methodology-lives-in-the-skill">Methodology Lives in the Skill</h2><a class="sl-anchor-link" href="#methodology-lives-in-the-skill"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Methodology Lives in the Skill”</span></a></div>
+<p>The investigator’s discipline is a property of the skill itself. Whoever invokes <code dir="auto">bmad-investigate</code> takes on the
+methodology and communication style for the run: clinical precision, evidence-first language, no hedging, case-file
+framing. When the skill ends, the caller returns to its prior voice. No persona swap, just a tone shift from the skill’s
+principles.</p>
+<p>This matters because investigation and implementation reward different instincts. Investigators are slow and precise.
+Implementers are fast and confident. The same brain doing both in one session tends to do neither well. The skill
+carves out the investigative posture inline, without a context switch to a separate identity.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="what-you-get">What You Get</h2><a class="sl-anchor-link" href="#what-you-get"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “What You Get”</span></a></div>
+<p>A completed investigation file:</p>
+<ul>
+<li>Separates Confirmed findings (with citations) from Deductions and Hypotheses</li>
+<li>Preserves all hypotheses ever formed, with their final Status and Resolution</li>
+<li>Reconstructs a timeline of events from multiple evidence sources</li>
+<li>Identifies data gaps and what they would resolve</li>
+<li>Provides actionable conclusions grounded in evidence</li>
+<li>Includes a reproduction plan when a root cause is identified</li>
+<li>Maintains an investigation backlog of paths still to explore</li>
+</ul>
+<p>Hand it to an engineer who was not present and they understand what happened, what is known, and what remains uncertain.
+That’s the bar.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-bigger-idea">The Bigger Idea</h2><a class="sl-anchor-link" href="#the-bigger-idea"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “The Bigger Idea”</span></a></div>
+<p>Most “AI debugging” today blends evidence, reasoning, and code changes into one stream of plausible-looking text. The
+signal is hard to find, the dead ends repeat, and the case file, if there is one, is a chat log nobody wants to read.</p>
+<p><code dir="auto">bmad-investigate</code> treats investigation as a discipline with its own deliverable. Evidence has a grade. Hypotheses have
+a status. Wrong turns are documented, not erased. The case file outlives the session.</p>
+<p>When the next bug shows up that looks like one you’ve seen before, you have somewhere to start that isn’t a blank
+prompt.</p> </div> <footer class="sl-flex astro-a726w4al"> <div class="meta sl-flex astro-a726w4al">   </div> <div class="pagination-links print:hidden astro-uu4deccg" dir="ltr">   </div>   </footer>  </div> </div>   </main> </div> </div>  </div> </div>  </body></html>

package/build/site/explanation/named-agents/index.html ADDED Viewed

@@ -0,0 +1,187 @@
+<!DOCTYPE html><html lang="en" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-uxe7q6yi"> <head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Named Agents | Wizz Method</title><link rel="canonical" href="http://localhost:3000/explanation/named-agents/"/><link rel="alternate" hreflang="en" href="http://localhost:3000/explanation/named-agents/"/><link rel="alternate" hreflang="vi-VN" href="http://localhost:3000/vi-vn/explanation/named-agents/"/><link rel="alternate" hreflang="zh-CN" href="http://localhost:3000/zh-cn/explanation/named-agents/"/><link rel="alternate" hreflang="fr-FR" href="http://localhost:3000/fr/explanation/named-agents/"/><link rel="alternate" hreflang="cs-CZ" href="http://localhost:3000/cs/explanation/named-agents/"/><link rel="sitemap" href="/sitemap-index.xml"/><link rel="shortcut icon" href="/wizz-icon-orange.svg" type="image/svg+xml"/><meta name="generator" content="Astro v5.18.1"/><meta name="generator" content="Starlight v0.37.5"/><meta property="og:title" content="Named Agents"/><meta property="og:type" content="article"/><meta property="og:url" content="http://localhost:3000/explanation/named-agents/"/><meta property="og:locale" content="en"/><meta property="og:description" content="Why BMad agents have names, personas, and customization surfaces — and what that unlocks compared to menu-driven or prompt-driven alternatives"/><meta property="og:site_name" content="Wizz Method"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Why BMad agents have names, personas, and customization surfaces — and what that unlocks compared to menu-driven or prompt-driven alternatives"/><meta name="ai-terms" content="AI-optimized documentation: http://localhost:3000/llms-full.txt (plain text, ~100k tokens, complete Wizz Method reference). Index: http://localhost:3000/llms.txt"/><meta name="llms-full" content="http://localhost:3000/llms-full.txt"/><meta name="llms" content="http://localhost:3000/llms.txt"/><script>
+	window.StarlightThemeProvider = (() => {
+		const storedTheme =
+			typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
+		const theme =
+			storedTheme ||
+			(window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
+		document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
+		return {
+			updatePickers(theme = storedTheme || 'auto') {
+				document.querySelectorAll('starlight-theme-select').forEach((picker) => {
+					const select = picker.querySelector('select');
+					if (select) select.value = theme;
+					/** @type {HTMLTemplateElement | null} */
+					const tmpl = document.querySelector(`#theme-icons`);
+					const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
+					if (newIcon) {
+						const oldIcon = picker.querySelector('svg.label-icon');
+						if (oldIcon) {
+							oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
+						}
+					}
+				});
+			},
+		};
+	})();
+</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M5 12a1 1 0 0 0-1-1H3a1 1 0 0 0 0 2h1a1 1 0 0 0 1-1Zm.64 5-.71.71a1 1 0 0 0 0 1.41 1 1 0 0 0 1.41 0l.71-.71A1 1 0 0 0 5.64 17ZM12 5a1 1 0 0 0 1-1V3a1 1 0 0 0-2 0v1a1 1 0 0 0 1 1Zm5.66 2.34a1 1 0 0 0 .7-.29l.71-.71a1 1 0 1 0-1.41-1.41l-.66.71a1 1 0 0 0 0 1.41 1 1 0 0 0 .66.29Zm-12-.29a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.71-.71a1.004 1.004 0 1 0-1.43 1.41l.73.71ZM21 11h-1a1 1 0 0 0 0 2h1a1 1 0 0 0 0-2Zm-2.64 6A1 1 0 0 0 17 18.36l.71.71a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.76-.66ZM12 6.5a5.5 5.5 0 1 0 5.5 5.5A5.51 5.51 0 0 0 12 6.5Zm0 9a3.5 3.5 0 1 1 0-7 3.5 3.5 0 0 1 0 7Zm0 3.5a1 1 0 0 0-1 1v1a1 1 0 0 0 2 0v-1a1 1 0 0 0-1-1Z"/></svg><svg aria-hidden="true" class="dark astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.64 13a1 1 0 0 0-1.05-.14 8.049 8.049 0 0 1-3.37.73 8.15 8.15 0 0 1-8.14-8.1 8.59 8.59 0 0 1 .25-2A1 1 0 0 0 8 2.36a10.14 10.14 0 1 0 14 11.69 1 1 0 0 0-.36-1.05Zm-9.5 6.69A8.14 8.14 0 0 1 7.08 5.22v.27a10.15 10.15 0 0 0 10.14 10.14 9.784 9.784 0 0 0 2.1-.22 8.11 8.11 0 0 1-7.18 4.32v-.04Z"/></svg><svg aria-hidden="true" class="auto astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg></template><link rel="stylesheet" href="/_astro/print.DNXP8c50.css" media="print"><link rel="stylesheet" href="/_astro/index.DdjI3lF_.css"><script type="module" src="/_astro/page.B1D-nYk3.js"></script></head> <body class="astro-uxe7q6yi"> <a href="#_top" class="astro-7lpm5qv4">Skip to content</a>  <div class="page sl-flex astro-2xv6dk2n"> <header class="header astro-2xv6dk2n"><div class="ai-banner astro-kggsjsm4" role="note" aria-label="AI documentation notice"> <span class="astro-kggsjsm4">🤖 Consolidated, AI-optimized Wizz Method docs: <a href="http://localhost:3000/llms-full.txt" class="astro-kggsjsm4">llms-full.txt</a>. Fetch this plain text file for complete context.</span> </div>  <div class="header sl-flex astro-3ef6ksr2"> <div class="title-wrapper sl-flex astro-3ef6ksr2"> <a href="/" class="site-title sl-flex astro-sv76zpkw">  <span class="astro-sv76zpkw" translate="no"> Wizz Method </span> </a>  </div> <div class="sl-flex print:hidden astro-3ef6ksr2"> <site-search class="astro-3ef6ksr2 astro-kbzrce66" data-translations="{&#34;placeholder&#34;:&#34;Search&#34;}"> <button data-open-modal disabled aria-label="Search" aria-keyshortcuts="Control+K" class="astro-kbzrce66"> <svg aria-hidden="true" class="astro-kbzrce66 astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.71 20.29 18 16.61A9 9 0 1 0 16.61 18l3.68 3.68a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.39ZM11 18a7 7 0 1 1 0-14 7 7 0 0 1 0 14Z"/></svg> <span class="sl-hidden md:sl-block astro-kbzrce66" aria-hidden="true">Search</span> <kbd class="sl-hidden md:sl-flex astro-kbzrce66" style="display: none;"> <kbd class="astro-kbzrce66">Ctrl</kbd><kbd class="astro-kbzrce66">K</kbd> </kbd> </button> <dialog style="padding:0" aria-label="Search" class="astro-kbzrce66"> <div class="dialog-frame sl-flex astro-kbzrce66">  <button data-close-modal class="sl-flex md:sl-hidden astro-kbzrce66"> Cancel </button> <div class="search-container astro-kbzrce66"> <div id="starlight__search" class="astro-kbzrce66"></div> </div> </div> </dialog> </site-search>  <script>
+	(() => {
+		const openBtn = document.querySelector('button[data-open-modal]');
+		const shortcut = openBtn?.querySelector('kbd');
+		if (!openBtn || !(shortcut instanceof HTMLElement)) return;
+		const platformKey = shortcut.querySelector('kbd');
+		if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
+			platformKey.textContent = '⌘';
+			openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
+		}
+		shortcut.style.display = '';
+	})();
+</script> <script type="module" src="/_astro/Search.astro_astro_type_script_index_0_lang.cjYDvRdi.js"></script>   </div> <div class="sl-hidden md:sl-flex print:hidden right-group astro-3ef6ksr2"> <div class="sl-flex social-icons astro-3ef6ksr2"> <a href="https://github.com/wizzcomms/wizz-method" rel="me" class="sl-flex astro-bgmygzip"><span class="sr-only astro-bgmygzip">GitHub</span><svg aria-hidden="true" class="astro-bgmygzip astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="dark" class="astro-nmwkdvwx">Dark</option><option value="light" class="astro-nmwkdvwx">Light</option><option value="auto" selected class="astro-nmwkdvwx">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  <script>
+	StarlightThemeProvider.updatePickers();
+</script> <script type="module">const r="starlight-theme",o=e=>e==="auto"||e==="dark"||e==="light"?e:"auto",c=()=>o(typeof localStorage<"u"&&localStorage.getItem(r));function n(e){typeof localStorage<"u"&&localStorage.setItem(r,e==="light"||e==="dark"?e:"")}const l=()=>matchMedia("(prefers-color-scheme: light)").matches?"light":"dark";function t(e){StarlightThemeProvider.updatePickers(e),document.documentElement.dataset.theme=e==="auto"?l():e,n(e)}matchMedia("(prefers-color-scheme: light)").addEventListener("change",()=>{c()==="auto"&&t("auto")});class s extends HTMLElement{constructor(){super(),t(c()),this.querySelector("select")?.addEventListener("change",a=>{a.currentTarget instanceof HTMLSelectElement&&t(o(a.currentTarget.value))})}}customElements.define("starlight-theme-select",s);</script> <starlight-lang-select><label style="--sl-select-width: 7em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select language</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path fill-rule="evenodd" d="M8.516 3a.94.94 0 0 0-.941.94v1.15H2.94a.94.94 0 1 0 0 1.882h7.362a7.422 7.422 0 0 1-1.787 3.958 7.42 7.42 0 0 1-1.422-2.425.94.94 0 1 0-1.774.627 9.303 9.303 0 0 0 1.785 3.043 7.422 7.422 0 0 1-4.164 1.278.94.94 0 1 0 0 1.881 9.303 9.303 0 0 0 5.575-1.855 9.303 9.303 0 0 0 4.11 1.74l-.763 1.525a.968.968 0 0 0-.016.034l-1.385 2.77a.94.94 0 1 0 1.683.841l1.133-2.267h5.806l1.134 2.267a.94.94 0 0 0 1.683-.841l-1.385-2.769a.95.95 0 0 0-.018-.036l-3.476-6.951a.94.94 0 0 0-1.682 0l-1.82 3.639a7.423 7.423 0 0 1-3.593-1.256 9.303 9.303 0 0 0 2.27-5.203h1.894a.94.94 0 0 0 0-1.881H9.456V3.94A.94.94 0 0 0 8.516 3Zm6.426 11.794a1.068 1.068 0 0 1-.02.039l-.703 1.407h3.924l-1.962-3.924-1.24 2.478Z" clip-rule="evenodd"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="/explanation/named-agents/" class="astro-nmwkdvwx">English</option><option value="/vi-vn/explanation/named-agents/" class="astro-nmwkdvwx">Tiếng Việt</option><option value="/zh-cn/explanation/named-agents/" class="astro-nmwkdvwx">简体中文</option><option value="/fr/explanation/named-agents/" class="astro-nmwkdvwx">Français</option><option value="/cs/explanation/named-agents/" class="astro-nmwkdvwx">Čeština</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label> </starlight-lang-select><script type="module">class s extends HTMLElement{constructor(){super();const e=this.querySelector("select");e&&(e.addEventListener("change",t=>{t.currentTarget instanceof HTMLSelectElement&&(window.location.pathname=t.currentTarget.value)}),window.addEventListener("pageshow",t=>{if(!t.persisted)return;const n=e.querySelector("option[selected]")?.index;n!==e.selectedIndex&&(e.selectedIndex=n??0)}))}}customElements.define("starlight-lang-select",s);</script> </div> </div> </header> <nav class="sidebar print:hidden astro-2xv6dk2n" aria-label="Main"> <starlight-menu-button class="print:hidden astro-rcmu22v7"> <button aria-expanded="false" aria-label="Menu" aria-controls="starlight__sidebar" class="sl-flex md:sl-hidden astro-rcmu22v7"> <svg aria-hidden="true" class="open-menu astro-rcmu22v7 astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M3 8h18a1 1 0 1 0 0-2H3a1 1 0 0 0 0 2Zm18 8H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Zm0-5H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Z"/></svg> <svg aria-hidden="true" class="close-menu astro-rcmu22v7 astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="m13.41 12 6.3-6.29a1.004 1.004 0 1 0-1.42-1.42L12 10.59l-6.29-6.3a1.004 1.004 0 0 0-1.42 1.42l6.3 6.29-6.3 6.29a1 1 0 0 0 0 1.42.998.998 0 0 0 1.42 0l6.29-6.3 6.29 6.3a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.42L13.41 12Z"/></svg> </button> </starlight-menu-button> <script type="module">class s extends HTMLElement{constructor(){super(),this.btn=this.querySelector("button"),this.btn.addEventListener("click",()=>this.toggleExpanded());const t=this.closest("nav");t&&t.addEventListener("keyup",e=>this.closeOnEscape(e))}setExpanded(t){this.setAttribute("aria-expanded",String(t)),document.body.toggleAttribute("data-mobile-menu-expanded",t)}toggleExpanded(){this.setExpanded(this.getAttribute("aria-expanded")!=="true")}closeOnEscape(t){t.code==="Escape"&&(this.setExpanded(!1),this.btn.focus())}}customElements.define("starlight-menu-button",s);</script>   <div id="starlight__sidebar" class="sidebar-pane astro-2xv6dk2n"> <div class="sidebar-content sl-flex astro-2xv6dk2n"> <sl-sidebar-state-persist data-hash="0fp6vz6" class="astro-t57j3vat"> <script aria-hidden="true">
+		(() => {
+			try {
+				if (!matchMedia('(min-width: 50em)').matches) return;
+				/** @type {HTMLElement | null} */
+				const target = document.querySelector('sl-sidebar-state-persist');
+				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
+				if (!target || !state || target.dataset.hash !== state.hash) return;
+				window._starlightScrollRestore = state.scroll;
+				customElements.define(
+					'sl-sidebar-restore',
+					class SidebarRestore extends HTMLElement {
+						connectedCallback() {
+							try {
+								const idx = parseInt(this.dataset.index || '');
+								const details = this.closest('details');
+								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
+							} catch {}
+						}
+					}
+				);
+			} catch {}
+		})();
+	</script>  <ul class="top-level astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/" class="large astro-yhouv36n"> <span class="astro-yhouv36n">Welcome</span>  </a> </li><li class="astro-yhouv36n"> <a href="/roadmap/" class="large astro-yhouv36n"> <span class="astro-yhouv36n">Roadmap</span>  </a> </li><li class="astro-yhouv36n"> <details open class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">Tutorials</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="0"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/tutorials/getting-started/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Getting Started</span>  </a> </li> </ul>  </details> </li><li class="astro-yhouv36n"> <details class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">How-To Guides</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="1"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/how-to/install-bmad/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Install BMad</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/non-interactive-installation/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Non-Interactive Installation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/install-custom-modules/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Install Custom and Community Modules</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/upgrade-to-v6/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Upgrade to v6</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/get-answers-about-bmad/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Get Answers About BMad</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/quick-fixes/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Quick Fixes</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/established-projects/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Established Projects</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/customize-bmad/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Customize BMad</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/project-context/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Manage Project Context</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/shard-large-documents/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Document Sharding Guide</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/expand-bmad-for-your-org/" class="astro-yhouv36n"> <span class="astro-yhouv36n">How to Expand BMad for Your Organization</span>  </a> </li><li class="astro-yhouv36n"> <a href="/how-to/use-web-bundles/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Use Web Bundles</span>  </a> </li> </ul>  </details> </li><li class="astro-yhouv36n"> <details open class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">Explanation</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="2"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/explanation/named-agents/" aria-current="page" class="astro-yhouv36n"> <span class="astro-yhouv36n">Named Agents</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/analysis-phase/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Analysis Phase: From Idea to Foundation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/brainstorming/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Brainstorming</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/advanced-elicitation/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Advanced Elicitation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/why-solutioning-matters/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Why Solutioning Matters</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/preventing-agent-conflicts/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Preventing Agent Conflicts</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/quick-dev/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Quick Dev</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/checkpoint-preview/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Checkpoint Preview</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/adversarial-review/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Adversarial Review</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/forensic-investigation/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Forensic Investigation</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/party-mode/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Party Mode</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/project-context/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Project Context</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/established-projects-faq/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Established Projects FAQ</span>  </a> </li><li class="astro-yhouv36n"> <a href="/explanation/web-bundles/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Web Bundles</span>  </a> </li> </ul>  </details> </li><li class="astro-yhouv36n"> <details class="astro-yhouv36n"> <summary class="astro-yhouv36n"> <span class="group-label astro-yhouv36n"> <span class="large astro-yhouv36n">Reference</span>  </span> <svg aria-hidden="true" class="caret astro-yhouv36n astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="3"></sl-sidebar-restore> <ul class="astro-yhouv36n"> <li class="astro-yhouv36n"> <a href="/reference/workflow-map/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Workflow Map</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/agents/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Agents</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/core-tools/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Core Tools</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/commands/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Skills</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/modules/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Official Modules</span>  </a> </li><li class="astro-yhouv36n"> <a href="/reference/testing/" class="astro-yhouv36n"> <span class="astro-yhouv36n">Testing Options</span>  </a> </li> </ul>  </details> </li> </ul>   <script aria-hidden="true">
+		(() => {
+			const scroller = document.getElementById('starlight__sidebar');
+			if (!window._starlightScrollRestore || !scroller) return;
+			scroller.scrollTop = window._starlightScrollRestore;
+			delete window._starlightScrollRestore;
+		})();
+	</script> </sl-sidebar-state-persist>  <div class="md:sl-hidden"> <div class="mobile-preferences sl-flex astro-lbnvevm2"> <div class="sl-flex social-icons astro-lbnvevm2"> <a href="https://github.com/wizzcomms/wizz-method" rel="me" class="sl-flex astro-bgmygzip"><span class="sr-only astro-bgmygzip">GitHub</span><svg aria-hidden="true" class="astro-bgmygzip astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="dark" class="astro-nmwkdvwx">Dark</option><option value="light" class="astro-nmwkdvwx">Light</option><option value="auto" selected class="astro-nmwkdvwx">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  <script>
+	StarlightThemeProvider.updatePickers();
+</script>  <starlight-lang-select><label style="--sl-select-width: 7em" class="astro-nmwkdvwx"> <span class="sr-only astro-nmwkdvwx">Select language</span> <svg aria-hidden="true" class="icon label-icon astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path fill-rule="evenodd" d="M8.516 3a.94.94 0 0 0-.941.94v1.15H2.94a.94.94 0 1 0 0 1.882h7.362a7.422 7.422 0 0 1-1.787 3.958 7.42 7.42 0 0 1-1.422-2.425.94.94 0 1 0-1.774.627 9.303 9.303 0 0 0 1.785 3.043 7.422 7.422 0 0 1-4.164 1.278.94.94 0 1 0 0 1.881 9.303 9.303 0 0 0 5.575-1.855 9.303 9.303 0 0 0 4.11 1.74l-.763 1.525a.968.968 0 0 0-.016.034l-1.385 2.77a.94.94 0 1 0 1.683.841l1.133-2.267h5.806l1.134 2.267a.94.94 0 0 0 1.683-.841l-1.385-2.769a.95.95 0 0 0-.018-.036l-3.476-6.951a.94.94 0 0 0-1.682 0l-1.82 3.639a7.423 7.423 0 0 1-3.593-1.256 9.303 9.303 0 0 0 2.27-5.203h1.894a.94.94 0 0 0 0-1.881H9.456V3.94A.94.94 0 0 0 8.516 3Zm6.426 11.794a1.068 1.068 0 0 1-.02.039l-.703 1.407h3.924l-1.962-3.924-1.24 2.478Z" clip-rule="evenodd"/></svg> <select autocomplete="off" class="astro-nmwkdvwx"> <option value="/explanation/named-agents/" class="astro-nmwkdvwx">English</option><option value="/vi-vn/explanation/named-agents/" class="astro-nmwkdvwx">Tiếng Việt</option><option value="/zh-cn/explanation/named-agents/" class="astro-nmwkdvwx">简体中文</option><option value="/fr/explanation/named-agents/" class="astro-nmwkdvwx">Français</option><option value="/cs/explanation/named-agents/" class="astro-nmwkdvwx">Čeština</option> </select> <svg aria-hidden="true" class="icon caret astro-nmwkdvwx astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label> </starlight-lang-select> </div>  </div> </div> </div> </nav> <div class="main-frame astro-2xv6dk2n">  <script type="module">const a=document.getElementById("starlight__sidebar"),n=a?.querySelector("sl-sidebar-state-persist"),o="sl-sidebar-state",i=()=>{let t=[];const e=n?.dataset.hash||"";try{const s=sessionStorage.getItem(o),r=JSON.parse(s||"{}");Array.isArray(r.open)&&r.hash===e&&(t=r.open)}catch{}return{hash:e,open:t,scroll:a?.scrollTop||0}},c=t=>{try{sessionStorage.setItem(o,JSON.stringify(t))}catch{}},d=()=>c(i()),l=(t,e)=>{const s=i();s.open[e]=t,c(s)};n?.addEventListener("click",t=>{if(!(t.target instanceof Element))return;const e=t.target.closest("summary")?.closest("details");if(!e)return;const s=e.querySelector("sl-sidebar-restore"),r=parseInt(s?.dataset.index||"");isNaN(r)||l(!e.open,r)});addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&d()});addEventListener("pageHide",d);</script> <div class="lg:sl-flex astro-ppt5ty36"> <aside class="right-sidebar-container print:hidden astro-ppt5ty36"> <div class="right-sidebar astro-ppt5ty36"> <script type="module" src="/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.hwBsy0Mo.js"></script><script type="module" src="/_astro/TableOfContents.astro_astro_type_script_index_0_lang.FuRcXuRY.js"></script><div class="lg:sl-hidden astro-se4agvxv"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-c5ccmeve"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-c5ccmeve"><details id="starlight__mobile-toc" class="astro-c5ccmeve"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-c5ccmeve"><span class="toggle sl-flex astro-c5ccmeve">On this page<svg aria-hidden="true" class="caret astro-c5ccmeve astro-zf5byosl" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></span><span class="display-current astro-c5ccmeve"></span></summary><div class="dropdown astro-c5ccmeve"><ul class="isMobile astro-xsqhb6qp" style="--depth: 0;"> <li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#_top" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Overview</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-three-legged-stool" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Three-Legged Stool</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#what-named-agents-buy-you" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">What Named Agents Buy You</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-activation-flow" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Activation Flow</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#why-not-just-a-menu" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Why Not Just a Menu?</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#why-not-just-a-blank-prompt" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Why Not Just a Blank Prompt?</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#customization-as-a-first-class-citizen" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Customization as a First-Class Citizen</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-bigger-idea" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Bigger Idea</span> </a>  </li> </ul> </div></details></nav></mobile-starlight-toc></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-se4agvxv"><div class="sl-container astro-se4agvxv"><starlight-toc data-min-h="2" data-max-h="3"><nav aria-labelledby="starlight__on-this-page"><h2 id="starlight__on-this-page">On this page</h2><ul class="astro-xsqhb6qp" style="--depth: 0;"> <li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#_top" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Overview</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-three-legged-stool" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Three-Legged Stool</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#what-named-agents-buy-you" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">What Named Agents Buy You</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-activation-flow" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Activation Flow</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#why-not-just-a-menu" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Why Not Just a Menu?</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#why-not-just-a-blank-prompt" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Why Not Just a Blank Prompt?</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#customization-as-a-first-class-citizen" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">Customization as a First-Class Citizen</span> </a>  </li><li class="astro-xsqhb6qp" style="--depth: 0;"> <a href="#the-bigger-idea" class="astro-xsqhb6qp" style="--depth: 0;"> <span class="astro-xsqhb6qp" style="--depth: 0;">The Bigger Idea</span> </a>  </li> </ul> </nav></starlight-toc></div></div> </div> </aside> <div class="main-pane astro-ppt5ty36">  <main data-pagefind-body class="astro-uxe7q6yi" lang="en" dir="ltr">    <div class="content-panel astro-aoj46c3a"> <div class="sl-container astro-aoj46c3a"> <h1 id="_top" class="astro-obdi53jg">Named Agents</h1>  </div> </div>  <div class="content-panel astro-aoj46c3a"> <div class="sl-container astro-aoj46c3a"> <div class="sl-markdown-content"> <p>You say “Hey Mary, let’s brainstorm,” and Mary activates. She greets you by name, in the language you configured, with her distinctive persona. She reminds you that <code dir="auto">bmad-help</code> is always available. Then she skips the menu entirely and drops straight into brainstorming — because your intent was clear.</p>
+<p>This page explains what’s actually happening and why BMad is designed this way.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-three-legged-stool">The Three-Legged Stool</h2><a class="sl-anchor-link" href="#the-three-legged-stool"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “The Three-Legged Stool”</span></a></div>
+<p>BMad’s agent model rests on three primitives that compose:</p>
+<table><thead><tr><th>Primitive</th><th>What it provides</th><th>Where it lives</th></tr></thead><tbody><tr><td><strong>Skill</strong></td><td>Capability — a discrete thing the assistant can do (brainstorm, draft a PRD, implement a story)</td><td><code dir="auto">.claude/skills/{skill-name}/SKILL.md</code> (or your IDE’s equivalent)</td></tr><tr><td><strong>Named agent</strong></td><td>Persona continuity — a recognizable identity that wraps a menu of related skills with consistent voice, principles, and visual cues</td><td>Skills whose directory starts with <code dir="auto">bmad-agent-*</code></td></tr><tr><td><strong>Customization</strong></td><td>Makes it yours — overrides that reshape an agent’s behavior, add MCP integrations, swap templates, layer in org conventions</td><td><code dir="auto">_bmad/custom/{skill-name}.toml</code> (committed team overrides) and <code dir="auto">.user.toml</code> (personal, gitignored)</td></tr></tbody></table>
+<p>Pull any leg away and the experience collapses:</p>
+<ul>
+<li>Skills without agents → capability lists the user has to navigate by name or code</li>
+<li>Agents without skills → personas with nothing to do</li>
+<li>No customization → every user gets the same out-of-box behavior, forcing forks for any org-specific need</li>
+</ul>
+<div class="sl-heading-wrapper level-h2"><h2 id="what-named-agents-buy-you">What Named Agents Buy You</h2><a class="sl-anchor-link" href="#what-named-agents-buy-you"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “What Named Agents Buy You”</span></a></div>
+<p>BMad ships six named agents, each anchored to a phase of the BMad Method:</p>
+<table><thead><tr><th>Agent</th><th>Phase</th><th>Module</th></tr></thead><tbody><tr><td>📊 <strong>Mary</strong>, Business Analyst</td><td>Analysis</td><td>market research, brainstorming, product briefs, PRFAQs</td></tr><tr><td>📚 <strong>Paige</strong>, Technical Writer</td><td>Analysis</td><td>project documentation, diagrams, doc validation</td></tr><tr><td>📋 <strong>John</strong>, Product Manager</td><td>Planning</td><td>PRD creation, epic/story breakdown, implementation readiness</td></tr><tr><td>🎨 <strong>Sally</strong>, UX Designer</td><td>Planning</td><td>UX design specifications</td></tr><tr><td>🏗️ <strong>Winston</strong>, System Architect</td><td>Solutioning</td><td>technical architecture, alignment checks</td></tr><tr><td>💻 <strong>Amelia</strong>, Senior Engineer</td><td>Implementation</td><td>story execution, quick-dev, code review, sprint planning, <a href="/explanation/forensic-investigation/">forensic investigation</a></td></tr></tbody></table>
+<p>They each have a hardcoded identity (name, title, domain) and a customizable layer (role, principles, communication style, icon, menu). You can rewrite Mary’s principles or add menu items; you can’t rename her — that’s deliberate. Brand recognition survives customization so “hey Mary” always activates the analyst, regardless of how a team has shaped her behavior.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-activation-flow">The Activation Flow</h2><a class="sl-anchor-link" href="#the-activation-flow"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “The Activation Flow”</span></a></div>
+<p>When you invoke a named agent, eight steps run in order:</p>
+<ol>
+<li><strong>Resolve the agent block</strong> — merge the shipped <code dir="auto">customize.toml</code> with team and personal overrides, via a Python resolver using stdlib <code dir="auto">tomllib</code></li>
+<li><strong>Execute prepend steps</strong> — any pre-flight behavior the team configured</li>
+<li><strong>Adopt persona</strong> — hardcoded identity plus customized role, communication style, principles</li>
+<li><strong>Load persistent facts</strong> — org rules, compliance notes, optionally files loaded via a <code dir="auto">file:</code> prefix (e.g., <code dir="auto">file:{project-root}/docs/project-context.md</code>)</li>
+<li><strong>Load config</strong> — user name, communication language, output language, artifact paths</li>
+<li><strong>Greet</strong> — personalized, in the configured language, with the agent’s emoji prefix so you can see at a glance who’s speaking</li>
+<li><strong>Execute append steps</strong> — any post-greet setup the team configured</li>
+<li><strong>Dispatch or present the menu</strong> — if your opening message maps to a menu item, go directly; otherwise render the menu and wait for input</li>
+</ol>
+<p>Step 8 is where intent meets capability. “Hey Mary, let’s brainstorm” skips rendering because <code dir="auto">bmad-brainstorming</code> is an obvious match for <code dir="auto">BP</code> on Mary’s menu. If you say something ambiguous, she asks once, briefly, not as a confirmation ritual. If nothing fits, she continues the conversation normally.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="why-not-just-a-menu">Why Not Just a Menu?</h2><a class="sl-anchor-link" href="#why-not-just-a-menu"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Why Not Just a Menu?”</span></a></div>
+<p>Menus force the user to meet the tool halfway. You have to remember that brainstorming lives under code <code dir="auto">BP</code> on the analyst agent, not the PM agent, and know which persona owns which capabilities. That’s cognitive overhead the tool is making you carry.</p>
+<p>Named agents invert it. You say what you want, to whom, in whatever words feel natural. The agent knows who they are and what they do. When your intent is clear enough, they just go.</p>
+<p>The menu is still there as a fallback — show it when you’re exploring, skip it when you’re not.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="why-not-just-a-blank-prompt">Why Not Just a Blank Prompt?</h2><a class="sl-anchor-link" href="#why-not-just-a-blank-prompt"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Why Not Just a Blank Prompt?”</span></a></div>
+<p>Blank prompts assume you know the magic words. “Help me brainstorm” might work, but “let’s ideate on my SaaS idea” might not, and the results depend on how you phrased the ask. You become responsible for prompt engineering.</p>
+<p>Named agents add structure without closing off freedom. The persona stays consistent, the capabilities are discoverable, and <code dir="auto">bmad-help</code> is always one command away. You don’t have to guess what the agent can do, and you don’t need a manual to use it either.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="customization-as-a-first-class-citizen">Customization as a First-Class Citizen</h2><a class="sl-anchor-link" href="#customization-as-a-first-class-citizen"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Customization as a First-Class Citizen”</span></a></div>
+<p>The customization model is what lets this scale beyond a single developer.</p>
+<p>Every agent ships a <code dir="auto">customize.toml</code> with sensible defaults. Teams commit overrides to <code dir="auto">_bmad/custom/bmad-agent-{role}.toml</code>. Individuals can layer personal preferences in <code dir="auto">.user.toml</code> (gitignored). The resolver merges all three at activation time with predictable structural rules.</p>
+<p>Most users never hand-author these files. The <code dir="auto">bmad-customize</code> skill walks through picking the target, choosing agent vs workflow scope, authoring the override, and verifying the merge — so the customization surface stays accessible to anyone who understands their intent, not just those fluent in TOML.</p>
+<p>Concrete example: a team commits a single file telling Amelia to always use the Context7 MCP tool for library docs and to fall back to Linear when a story isn’t in the local epics list. Every dev workflow Amelia dispatches (dev-story, quick-dev, create-story, code-review) inherits that behavior, with no source edits or per-workflow duplication required.</p>
+<p>There’s also a second customization surface for <em>cross-cutting</em> concerns: the central <code dir="auto">_bmad/config.toml</code> and <code dir="auto">_bmad/config.user.toml</code> (both installer-owned, rebuilt from each module’s <code dir="auto">module.yaml</code>) plus <code dir="auto">_bmad/custom/config.toml</code> (team, committed) and <code dir="auto">_bmad/custom/config.user.toml</code> (personal, gitignored) for overrides. This is where the <strong>agent roster</strong> lives — the lightweight descriptors that roster consumers like <code dir="auto">bmad-party-mode</code>, <code dir="auto">bmad-retrospective</code>, and <code dir="auto">bmad-advanced-elicitation</code> read to know who’s available and how to embody them. Rebrand an agent org-wide with a team override; add fictional voices (Kirk, Spock, a domain expert persona) as personal experiments via the <code dir="auto">.user.toml</code> override — without touching any skill folder. The per-skill file shapes how Mary <em>behaves</em> when she activates; the central config shapes how other skills <em>see</em> her when they look at the field.</p>
+<p>For the full customization surface and worked examples, see:</p>
+<ul>
+<li><a href="/how-to/customize-bmad/">How to Customize BMad</a> — the reference for what’s customizable and how merge works</li>
+<li><a href="/how-to/expand-bmad-for-your-org/">How to Expand BMad for Your Organization</a> — five worked recipes spanning agent-wide rules, workflow conventions, external publishing, template swaps, and agent roster customization</li>
+<li><code dir="auto">bmad-customize</code> skill — the guided authoring helper that turns intent into a correctly-placed, verified override file</li>
+</ul>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-bigger-idea">The Bigger Idea</h2><a class="sl-anchor-link" href="#the-bigger-idea"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “The Bigger Idea”</span></a></div>
+<p>Most AI assistants today are either menus or prompts, and both shift cognitive load onto the user. Named agents plus customizable skills let you talk to a teammate who already knows the work, and let your organization shape that teammate without forking.</p>
+<p>The next time you type “Hey Mary, let’s brainstorm” and she just gets on with it, notice what didn’t happen. There was no slash command, no menu to navigate, no awkward reminder of what she can do. That absence is the design.</p> </div> <footer class="sl-flex astro-a726w4al"> <div class="meta sl-flex astro-a726w4al">   </div> <div class="pagination-links print:hidden astro-uu4deccg" dir="ltr">   </div>   </footer>  </div> </div>   </main> </div> </div>  </div> </div>  </body></html>