argumentation

Solid

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.

AI & Automation 26 stars 4 forks Updated today MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
48
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
pjt222
Repository
pjt222/agent-almanac
Created
1 years ago
Last Updated
today
Language
R
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category