QZhang2111/Research-Pilot / skills/project-understanding-update
project-understanding-update
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.0 KB |
SKILL.md
View on GitHub---
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |