evidence-based-development

Enforce file:line citations for code review claims with P1/P2/P3 prioritization.

6|2|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/synaptiai/synapti-marketplace --skill evidence-based-development
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: evidence-based-development
Source: https://github.com/synaptiai/synapti-marketplace/tree/main/plugins/flow/skills/evidence-based-development
Command: npx skills add https://github.com/synaptiai/synapti-marketplace --skill evidence-based-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures development recommendations and code-review decisions are grounded in verifiable evidence so teams stop relying on assumptions or unsourced confidence and instead act on cited facts.

Core Features & Use Cases

  • Mandatory Citations: Requires file:line references for any behavioral claim about code to make findings traceable and reviewable.
  • Prioritized Findings: Classifies issues as P1/P2/P3 so reviewers and engineers know what must be fixed immediately versus later.
  • Assertion / Evidence / Verified Pattern: Enforce a reproducible workflow where every non-trivial claim is stated, supported with evidence, and then verified by reading code or running tests.
  • Use Case: During a pull request review, produce a findings-first summary listing P1 regressions with exact file:line citations, then propose targeted fixes and verification steps.

Quick Start

Review the target files, cite each finding with file:line evidence, prioritize issues as P1/P2/P3, and propose verified remediation steps.

Frequently Asked Questions about evidence-based-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce evidence-based code review for pull requests?▼

Evidence-based code review enforces verifiable findings by requiring exact file:line citations for all behavioral claims. It applies an assertion-evidence-verified pattern to pull request analysis, ensuring recommendations are grounded in source files rather than unsourced confidence.

What is the assertion-evidence pattern for verifying code review findings?▼

The assertion-evidence pattern is a reproducible workflow where every non-trivial claim is stated, supported with file:line evidence, and then verified by reading code or running tests. This traceable process ensures development decisions rely on cited facts instead of assumptions.

How do I prioritize code review findings during PR analysis?▼

Prioritize code review findings by classifying issues as P1, P2, or P3. This severity ranking tells reviewers and engineers what regressions must be fixed immediately versus later, enabling a findings-first summary with targeted fixes and verification steps.

Can I use file:line citations to verify behavioral claims across repositories?▼

Yes, you can use file:line citations to verify behavioral claims across repositories and PR workflows. The evidence-first approach requires reading source files and citing exact locations, making all development recommendations traceable and reviewable.

Does evidence-based development require specific testing frameworks to verify claims?▼

Evidence-based development does not require specific testing frameworks; it verifies claims through direct code inspection or running existing tests. The workflow focuses on reading source files and citing exact file:line locations to validate behavioral assertions during code review.