Skip to content
Development
Agent

weak-vs-strong-summary

The same PR, summarized two ways. The weak version is what you get from skimming the title and the last commit. The strong version comes from reading the full `base...HEAD` diff and applying the risk taxonomy. The contrast shows the specific habits that separate a useful summary

From plugin
skills
954 skills54 agents

Claude Code

$ npx -y skills add vanara-agents/skills --agent claude-code

Agent definition

weak-vs-strong-summary.md

Weak vs Strong Summary

The same PR, summarized two ways. The weak version is what you get from skimming the title and the last commit. The strong version comes from reading the full `base...HEAD` diff and applying the risk taxonomy. The contrast shows the specific habits that separate a useful summary from a useless one.

The PR: a branch titled **"fix: handle empty cart"** with four commits.

---

Weak summary (avoid)

## PR Summary โ€” fix: handle empty cart

**Summary**
This PR fixes a bug where the cart didn't handle the empty case. It updates the checkout code to be
more robust. Looks good overall.

**Risk areas**
- Some changes to the checkout flow.

**Test plan**
- [ ] Test the cart.
- [ ] Make sure checkout works.

**Why it fails:**

  • **Summarized from the title/last commit**, not the diff. The last commit was "handle empty cart,"

but commit 2 on the branch also changed the discount calculation โ€” invisible here.

  • **Invents a verdict** ("Looks good overall") โ€” orientation is not approval.
  • **No anchors.** "Some changes to the checkout flow" tells the reviewer nothing about where to look.
  • **Vague test plan.** "Test the cart" names no input, no edge case, no path.
  • **Silent on the real risk** (a pricing change) and on missing tests.

---

Strong summary (target)

## PR Summary โ€” fix: handle empty cart

**Summary**
Fixes a crash when checking out an empty cart (`checkout/total.js:18` now returns 0 instead of
dereferencing `items[0]`). Beyond the stated fix, commit 2 also changes discount rounding in
`checkout/discount.js:33` from `Math.round` to `Math.floor` โ€” a real pricing behavior change the PR
title doesn't mention, and the first thing a reviewer should scrutinize. Net +47/-12 across 3 files;
no new tests were added.

**Risk areas**
- `checkout/discount.js:33` โ€” discount now rounds *down* instead of to-nearest; every discounted
  order's total shifts by up to a cent. Money math change, unrelated to the empty-cart fix โ€” confirm
  it's intentional and expected by finance/accounting.
- `checkout/total.js:18` โ€” the empty-cart guard returns `0`; verify downstream code treats a `0`
  total as valid (not as "unpriced") so it doesn't skip payment or tax steps.
- No test file touched โ€” neither the crash fix nor the rounding change has a regression test.

**Test plan**
- [ ] Checkout an empty cart โ†’ returns total 0, no crash (regression test for the reported bug).
- [ ] Discounted order โ†’ total uses floor rounding as intended; compare against a known expected
      value (covers the unannounced pricing change).
- [ ] A `0` total order flows through payment/tax steps correctly and isn't dropped as "unpriced."

**Why it works:** it read the whole branch (caught the commit-2 pricing change the title hid), anchored every claim to a `file:line`, led with the highest-consequence change (money math), stayed neutral (no "looks good"), and turned each risk into a concrete, input-specific test โ€” including the missing regression tests it flagged.

Read more
@vanara-agents
Ships withskills

๐Ÿ’ Free agents, skills & packs for Claude Code One subscription. An army of Claude Code agents. 30 production-grade agents, skills, and packs for Claude Code โ€” free, Apache-2.0, install with one command.

917 skills54 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
9
Star history of vanara-agents/skills on GitHub, a chart by star-history.com

Other agents on skills.

AGENT

AGENT

Agent

Use when designing a new HTTP/GraphQL API or changing an existing one โ€” modeling resources, defining endpoint contracts, choosingโ€ฆ

review-notes

review-notes

Agent

This shows how the api-designer agent reviews a flawed draft. Findings are severity-ranked so the implementer fixes theโ€ฆ

contract-and-openapi

contract-and-openapi

Agent

The contract is the deliverable. Express it as an **OpenAPI 3.1** document so it is human-readable *and* machine-checkable. Thisโ€ฆ

design-checklist

design-checklist

Agent

Run through this before declaring an API contract done. It is ordered the way you should *design*: resources first, cross-cuttingโ€ฆ

versioning-and-evolution

versioning-and-evolutiโ€ฆ

Agent

APIs are forever once published: a consumer you've never met may depend on any field you expose. Design so you can **add withoutโ€ฆ

pr-comment-template

pr-comment-template

Agent

Copy-paste templates for leaving review comments. Keep each comment to one finding: an anchor, the problem, and the fix.

More agents from other plugins.

a11y-architect
Auto-invoked

a11y-architect

Agent

Accessibility Architect specializing in WCAG 2.2 compliance for Web and Native platforms. Use PROACTIVELY when designing UIโ€ฆ

ecc12d293k
@affaan-m@affaan-mInstall Agent
analyze-pass-impact

analyze-pass-impact

Agent

Analyzes how a specific topic affects a group of compiler passes. Used by the /plan-update skill to parallelize research acrossโ€ฆ

react1d252k
@facebook@facebookInstall Agent
orchestrator

orchestrator

Agent

- If the user makes a simple request (such as asking for the time) which you can fulfill by running a terminal command (such asโ€ฆ

codex1d135k
@openai@openaiInstall Agent
cavecrew-builder

cavecrew-builder

Agent

Surgical 1-2 file edit. Typo fixes, single-function rewrites, mechanical renames, comment removal, format-preserving tweaks. Hardโ€ฆ

caveman2d119k
@juliusbrussee@juliusbrusseeInstall Agent

Questions about weak-vs-strong-summary.

Which coding agents can use weak-vs-strong-summary?
weak-vs-strong-summary installs in Claude Code and Cursor: each loads subagents from .claude/agents, so copy the file there. Flowy's auto-invocation runs in Claude Code only.