chore: re-source plugin from npx bmad-method install (v6.5.0.1)

[tgorka]

Summary

Architectural refactor — no upstream version change. The plugin is
now a thin wrapper around the official
npx bmad-method install --tools claude-code output, replacing the
multi-source git-clone-based sync pipeline that drifted in several
specific ways from the canonical upstream install (audited in detail
in docs/plan-npx-resync.md).

Drift fixed

Symptom	Before	After
customize.toml files	79	90
Total skills	93	102
Research skills layout	nested skills/research/<name>/	flat skills/<name>/
TEA + GDS agent skills	flat .md in agents/	full skill dirs in skills/
gds-document-project	missing	present
skills/workflows/*.md stray files	shipped	gone
Zombie agents (Bob/Quinn-as-QA/Barry/BMad Master)	shipped	gone

What's deleted

• 16 scripts (sync-upstream-content.ts, sync-all.ts,
  generate-{agents,skills,agent-manifest}.ts,
  clean-orphaned-skills.ts, find-orphan-files.ts,
  bump-{core,module}.ts, lib/path-rewriter.ts,
  lib/workflow-iterator.ts, 7 lib/checks/*.ts files) — −3455 net
  lines.
• plugins/bmad/agents/ (22 files) — agents are skills now.
• plugins/bmad/_shared/ and plugins/bmad/templates/ — replaced by
  per-skill resources/templates.

What's new

• scripts/sync-from-installer.ts — single new script, ~220 lines.
  Runs the installer, wipes the plugin tree, copies .claude/skills/*
  into plugins/bmad/skills/, bumps all version anchors.
• docs/plan-npx-resync.md — migration plan (kept for historical
  reference).
• bun run sync is now the single sync command. No separate generate
  steps. No multi-source sync. No bumps to chase.

Verification

• bun run typecheck passes
• bun run lint passes
• bun run validate passes (now: version consistency + skills/
  sanity check)
• bun test — 6 pass, 0 fail, all tests refreshed for
  v6.5.0+ skill names
• Sandbox install via claude plugin marketplace add produces
  a byte-identical 1392-file tree (verified by sha256sum diff)
• Smoke test: /bmad:bmad-help, /bmad:bmad-customize,
  /bmad:bmad-create-prd, /bmad:bmad-tea,
  /bmad:gds-create-gdd all load correctly

Commit structure

5 atomic commits, each its own concern:

1. feat(scripts): add installer-based sync (replaces multi-source sync)
2. chore: regenerate plugin tree from npx bmad-method@6.5.0 install
3. refactor(scripts): retire multi-source sync (-3455 lines)
4. docs: refresh README/AGENTS/sync docs for installer-based pipeline
5. docs: changelog for v6.5.0.1 (installer-based sync refactor)

Migration notes for downstream consumers

Anyone with the plugin already installed should refresh:

claude plugin uninstall bmad@bmad-method
claude plugin install bmad@bmad-method

Agent-picker affordance change: agents are skills now, invoke as
/bmad:bmad-agent-pm, /bmad:bmad-tea, etc. instead of "Use the pm
agent…".

🤖 Generated with Claude Code

---

Summary by cubic

Refactors the plugin to source content directly from the official npx bmad-method install --tools claude-code output, replacing the multi-source sync. Ships 102 skills (agents-as-skills), simplifies sync to one script, and bumps the plugin to v6.5.0.1 with no upstream BMAD version change.

• Refactors

  • Make the installer the single source of truth; the plugin is now a thin wrapper.
  • Add scripts/sync-from-installer.ts; wire bun run sync to it; remove 16 obsolete scripts (~−3455 LOC).
  • Regenerate plugins/bmad/skills/ from installer; remove plugins/bmad/agents/, _shared/, and templates/.
  • Fix prior drift: skills 93 → 102, customize.toml 79 → 90, flat skill layout, add gds-document-project, remove stray/zombie files.
  • Update config loaders to {project-root}/_bmad/*/config.yaml (replaces .claude/bmad.local.md across skills).
  • Add TEA knowledge resources and new manifests; refresh docs; bump versions to 6.5.0.1; ignore .upstream-install/.

• Migration

  • Reinstall to refresh content: claude plugin uninstall bmad@bmad-method && claude plugin install bmad@bmad-method.
  • Agents are skills now; invoke via /bmad:bmad-agent-pm, /bmad:bmad-tea, etc.
  • If you customized .claude/bmad.local.md, move settings to {project-root}/_bmad/{module}/config.yaml.

^{Written for commit daabf83. Summary will update on new commits. Review in cubic}