Skip to content

QZhang2111/Research-Pilot / skills/project-evidence-synthesis

project-evidence-synthesis

Verified

Use when a set of sources, dossiers, graph records, or experiment notes must be synthesized into project understanding, evidence pressure, uncertainty, and optional strict-review graph proposals.

FileKindSize
SKILL.mdskill md2.7 KB
---
name: project-evidence-synthesis
description: Use when a set of sources, dossiers, graph records, or experiment notes must be synthesized into project understanding, evidence pressure, uncertainty, and optional strict-review graph proposals.
argument-hint: "[workspace path] [project id] [paper ids or dossier paths]"
---

# Project Evidence Synthesis

This skill turns multiple sources into project-level understanding. It is not a literature review for humans. It is an agent-facing synthesis step before delta proposals.

## Boundary

Do not approve sources. Do not mark sources project-core/global-core. Do not mutate strict graph truth directly.

Allowed:

- compare sources;
- extract agreement/conflict;
- identify evidence pressure;
- record normal project memory updates;
- propose strict-review graph deltas only when needed;
- recommend natural next prompts.

## Required Reads

Read:

```text
$WORKSPACE/wiki/projects/$PROJECT/project-query-pack.md
$WORKSPACE/wiki/projects/$PROJECT/project-understanding-graph.md if present
$WORKSPACE/wiki/_system/workflows/project-evidence-synthesis.md
$WORKSPACE/wiki/_system/workflows/delta-update-protocol.md
```

Then query current graph:

```bash
python3 "$PLUGIN_ROOT/tools/graph_query_cli.py" summary --repo "$WORKSPACE" --project "$PROJECT" --json
python3 "$PLUGIN_ROOT/tools/graph_query_cli.py" open --repo "$WORKSPACE" --project "$PROJECT" --json
```

Use project-local paper dossiers when available:

```text
$WORKSPACE/wiki/projects/$PROJECT/papers/<paper-id>/index.md
```

## Synthesis Model

Separate:

- `Question`: what project question each source affects.
- `Claim`: what project judgment becomes stronger, weaker, narrower, or obsolete.
- `Evidence`: result, benchmark, dataset, metric, qualitative finding, or experimental observation.
- `Warrant`: why the evidence supports the claim.
- `Limitation`: boundary that blocks overclaim.
- `Evidence Need`: missing proof required before the claim should strengthen.
- `Next Action`: search, deep read, experiment, delta, or park.

## Evidence Strength

Use conservative labels:

- `direct`: source directly tests the project claim.
- `analogical`: source supports a similar mechanism or setting.
- `enabling`: source provides method/dataset/tool needed to test.
- `negative`: source challenges or bounds claim.
- `weak`: useful but indirect, qualitative, or under-specified.

## Required Output Sections

```markdown
# Project Evidence Synthesis

## Current Project State
## Source Set
## Agreement and Conflict
## Claim/Evidence Table
## Evidence Pressure
## Project Understanding Update
## Optional Strict Review
## Human Gate
## Next Natural Prompts
```

## Stop Point

Stop before applying strict-review graph changes unless the human explicitly accepts a D* delta.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall