borghei/Claude-Skills / research/dossier
dossier
VerifiedStructured intelligence dossiers on companies, people, markets, or domains, with source triangulation and fact/inference discipline. Use when preparing a deal-prep dossier, executive briefing, or due-diligence overview.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.9 KB |
| assets/research_note_template.md | markdown | 760 B |
| assets/sample_research_note.md | markdown | 1.9 KB |
| references/dossier-frameworks-and-structure.md | markdown | 6.3 KB |
| references/fact-vs-inference-discipline.md | markdown | 6.0 KB |
| references/repo-research-notes.md | markdown | 5.2 KB |
| references/source-triangulation-and-reliability.md | markdown | 6.7 KB |
| scripts/dossier_outline_generator.py | script | 8.4 KB |
| scripts/fact_inference_separator.py | script | 7.6 KB |
| scripts/research_note_checker.py | script | 7.5 KB |
| scripts/source_triangulation_validator.py | script | 7.7 KB |
assets/sample_research_note.md
View on GitHub# Research note: does the payments API allow idempotent retries on refunds?
**Status:** answered · **Date:** 2026-11-08 · **Question owner:** payments team
**Informs:** `docs/specs/refund-retries.md`
## Question
Can our refund worker safely retry a refund call after a timeout without risking a double
refund, and for how long does the provider remember an idempotency key?
## Answer
Yes, if every refund request carries an `Idempotency-Key` header; the provider returns the
original response for a repeated key instead of creating a second refund [1]. Keys are kept
for 24 hours, so a retry must happen inside that window or be reconciled by hand [1].
## Findings
- The refund endpoint accepts the `Idempotency-Key` header on POST requests [1].
- A repeated key with a different request body is rejected with HTTP 409 rather than processed [1][2].
- Our current client library sets the header only for charges, not for refunds [3].
- The client library added refund support for idempotency keys in its 4.2 release [4].
- A widely shared blog post claims keys last seven days, which contradicts the provider docs [5].
## Inference
The worker should generate one key per refund intent and persist it before the first call,
because a key generated per attempt defeats the protection. This follows from [1] and [3]
but is our design conclusion, not a provider statement.
## Open questions
- Does the 24-hour window restart on each retry, or run from the first request? The docs do not say; ask provider support.
## Sources
[1] https://docs.example-payments.com/api/idempotency (accessed 2026-11-08)
[2] https://docs.example-payments.com/api/errors#409 (accessed 2026-11-08)
[3] src/payments/client.py at commit 4f9e2c1, function `post_refund`
[4] https://github.com/example-payments/client-python/releases/tag/v4.2.0 (v4.2.0)
[5] https://medium.com/@someone/idempotency-keys-explained (accessed 2026-11-08) — secondary, contradicted by [1]
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |