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.