principle-state-the-claim-first
WHEN starting a task, fix or benchmark; NOT for read-only explanation or recording the pre-change state; records the falsifiable claim the work must support before the first change.
- License 许可
- MIT
- 所属仓库
- mintuz/skills
- 最近更新
- 2026-11-10
- Stars
- ★ 35
- Forks
- 7
01 前言 Front Matter
- name
- principle-state-the-claim-first
- description
- WHEN starting a task, fix or benchmark; NOT for read-only explanation or recording the pre-change state; records the falsifiable claim the work must support before the first change.
03 SKILL.md 正文
State the claim first
Write the claim you expect to make before you work or measure, so the checks test a sentence rather than a hope.
- Before the first edit, run or measurement, write the claim in the words you would report: the subject, the observable result, the condition or workload, and the threshold or direction. For example: "CSV export is 30% faster at p50 on the 60k-row dataset", or "after a restart with an existing state file, the service starts and keeps its data".
- Make it falsifiable. Name the observation that would show it false. A goal such as "make it faster" or "improve stability" is not yet a claim; turn it into one before starting, even when asked to start immediately.
- Keep suspected causes separate from the claim. A hunch about the mechanism is a hypothesis to test; the claim is the outcome the work must make true.
- Design the checks to test that sentence. Report whether the evidence supports, narrows or refutes it.
Distinct from: principle-define-done (a checkable completion criterion for any multi-step deliverable), principle-capture-the-baseline (recording the pre-change state), principle-prove-it-works (verifying the result after the work).
Done: the falsifiable claim, with its refuting observation, is recorded before the first change.
04 同仓库更多 Skills
xstate
WHEN React state changes in response to an external answer — async submit, in-flight or loading flags, retries, cancellation, polling, optimistic updates, stale responses — or to an interaction with an interruptible middle, such as a drag or a gesture; or WHEN building, reviewing, testing, or visualising XState 5 actors and @xstate/react integrations; NOT for a value one event sets completely, such as a text draft, a focus flag, or a plain open and closed toggle; models typed lifecycles and renders legal Mermaid stateDiagram-v2 charts.
web-design
WHEN refining UI layout, typography, color, or polish; NOT code implementation; provides concise principles for intentional, legible design.
tailwind
WHEN building design systems or component libraries with Tailwind CSS; covers design tokens, CVA patterns and dark mode.
refactoring
WHEN you need a plan to refactor, restructure, or clean up working code and the test result is known, either green or a recorded failing set; NOT for new feature delivery or any behavior change; reversible-baseline safety with prioritized improvements.
react
WHEN building or changing React components, pages, hooks, effects, or apps, including edits to existing components; NOT for test code (react-testing) or styling (css, tailwind); enforces scalable architecture, state management, API layer, performance patterns.
react-testing
WHEN testing React components/hooks/context with React Testing Library; NOT e2e; covers renderHook, providers, forms, and anti-patterns.