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.
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:
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:
$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:
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.mdproject-query-pack.mddecisions.mdonly for explicit human decisionsidea-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 LinkorTranslation Link - change lifecycle, lineage, confidence, scope, or human review
Output
End with:
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 |