← ClaudeAtlas

argumentationlisted

Construct well-structured arguments using the hypothesis-argument-example triad. Covers formulating falsifiable hypotheses, building logical arguments (deductive, inductive, analogical, evidential), providing concrete examples, and steelmanning counterarguments. Use when writing or reviewing PR descriptions that propose technical changes, justifying design decisions in ADRs, constructing substantive code review feedback, or building a research argument or technical proposal.
pjt222/agent-almanac · ★ 33 · AI & Automation · score 81
Install: claude install-skill pjt222/agent-almanac
# Construct Arguments Build rigorous arguments from hypothesis through reasoning to concrete evidence. Every persuasive technical claim follows the same triad: a clear hypothesis states *what* you believe, an argument explains *why* it holds, and examples prove *that* it holds. This skill teaches you to apply that structure to code reviews, design decisions, research writing, and any context where claims need justification. ## When to Use - Writing or reviewing a PR description that proposes a technical change - Justifying a design decision in an ADR (Architecture Decision Record) - Constructing feedback in a code review that goes beyond "I don't like this" - Writing a research argument or technical proposal - Challenging or defending an approach in a technical discussion ## Inputs - **Required**: A claim or position that needs justification - **Required**: Context (code review, design decision, research, documentation) - **Optional**: Audience (peer developers, reviewers, stakeholders, researchers) - **Optional**: Counterarguments or alternative positions to address - **Optional**: Evidence or data available to support the claim ## Procedure ### Step 1: Formulate the Hypothesis State your claim as a clear, falsifiable hypothesis. A hypothesis is not an opinion or a preference -- it is a specific assertion that can be tested against evidence. 1. Write the claim in one sentence 2. Apply the falsifiability test: can someone prove this wrong with evidence? 3. Scope it n