Skip to content

QZhang2111/Research-Pilot / skills/project-understanding-update

project-understanding-update

Verified

Use when a research project needs normal project memory updated from human intent, sources, evidence pressure, experiment results, or direction changes; strict graph review is optional advanced mode.

FileKindSize
SKILL.mdskill md3.0 KB
---
name: project-understanding-update
description: Use when a research project needs normal project memory updated from human intent, sources, evidence pressure, experiment results, or direction changes; strict graph review is optional advanced mode.
argument-hint: "[workspace path] [project id]"
---

# Project Understanding Update

This skill preserves and updates project understanding. It is not a paper search skill and not a graph mutation shortcut.

## Boundary

Human intent is first-class input.

Normal project understanding updates should be recorded through Research Pilot project memory / UnderstandingUpdate / typed dataset tools. The agent may classify, preserve, compare, and propose. It must not silently convert a human idea into a confirmed claim, project decision, or strict graph truth.

Strict graph-level changes use Delta Update Protocol only when the user asks for strict review or a formal Q/C/E/W/L/RL/TL change is being accepted:

```text
input
-> classify meaning
-> normal project memory update
-> optional strict-review D* proposal
-> dry-run
-> human accept/reject/park/revise
-> append accepted graph event only after approval
```

## Required Reads

Before changing project understanding, read:

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

Also query current graph when graph events exist:

```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
```

## Input Classification

Classify the user's input before writing:

- `observation`: project-relevant fact or pattern.
- `intuition`: taste, hunch, or research direction.
- `question`: new or reframed question.
- `claim`: contestable project judgment.
- `evidence_pressure`: accumulated evidence suggests Q/C update.
- `limitation_pressure`: repeated caveat weakens or bounds a claim.
- `search_need`: project now needs papers for a missing support.
- `experiment_need`: project now needs generated evidence.
- `boundary`: do-not-assume or do-not-learn constraint.
- `decision`: human project decision.

## Safe Updates

Direct markdown updates are allowed for workspace memory and reports:

- `overview.md`
- `project-query-pack.md`
- `decisions.md` only for explicit human decisions
- `idea-board.md`
- generated reports/snapshots if rebuilt

Graph truth changes require D*:

- add/refine/split/merge/retire `Question`
- add/refine/split/merge/retire `Claim`
- add `Evidence`, `Warrant`, `Limitation`
- add/update `Reasoning Link` or `Translation Link`
- change lifecycle, lineage, confidence, scope, or human review

## Output

End with:

```text
Update type:
Project memory:
Strict review:
Human gate:
Next natural prompt:
```

If no durable update is needed, say so and explain why.
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall