Skip to content

feat(newtab): Add hnt-backend-investigation skill - #32

Draft
mmiermans wants to merge 10 commits into
mozilla:mainfrom
mmiermans:add-hnt-backend-investigation-skill
Draft

feat(newtab): Add hnt-backend-investigation skill#32
mmiermans wants to merge 10 commits into
mozilla:mainfrom
mmiermans:add-hnt-backend-investigation-skill

Conversation

@mmiermans

@mmiermans mmiermans commented Jul 30, 2026

Copy link
Copy Markdown

Adds hnt-backend-investigation to the newtab plugin: a diagnostic workflow for Home New Tab backend incidents across Merino, the curated corpus, admin-api, the article crawler, and the ML section pipeline. Its output is an evidence-backed FINDINGS.md carrying a root cause and quantified impact. Two reference files hold the detail: references/data-sources.md for how to reach each system plus the data traps that silently produce wrong answers, and references/failure-modes.md for failure classes, invariants to check, and falsification moves. Table shapes, GCP project ids, the Merino corpus endpoint, and the Zyte API parameters were each verified against the live systems and the service repos. Docs/skill only; no code changes.

Testing steps:

  • Install this branch and run Claude Code from any directory
  • Invoke the skill with something like "newtab DE sections look empty, investigate"
  • It should pick an investigation directory, confirm the symptom against live data before theorizing, and raise a DEV: task for anything it cannot reach (corpus MySQL needs VPN, for instance) rather than stopping to wait
  • Check the FINDINGS.md it writes, where every number should be reproducible from the queries saved alongside it

@mmiermans
mmiermans force-pushed the add-hnt-backend-investigation-skill branch from 3dd3157 to d0e16f9 Compare July 30, 2026 17:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant