reference-project-synthesizer
Reference Project Synthesizer
Convert source cards into project decisions. This skill answers: What does this source mean for our project?
Use after reference-reading-summarizer has produced a source card. Do not repeatedly re-read raw sources unless the card is insufficient or low confidence.
Skill Directory Layout
<installed-skill-dir>/
├── SKILL.md
├── references/
│ └── project-link-routing.md
└── templates/
└── project-use-note.md
Core Contract
- Read project memory before linking a source to claims, experiments, risks, implementation, collaborator actions, or writing.
- Use source cards as compressed inputs. Raw source files and raw reading trajectories stay out of project memory.
- Stronger reasoning is required when the source changes a claim, baseline, benchmark, novelty boundary, implementation plan, collaborator commitment, or project seed.
- Every project implication should link to a source card, confidence level, and target memory object.
- Do not promote a cheap skim into a project decision without marking uncertainty or requesting deeper reading.
Inputs
Prefer:
reference/cards/<source-id>.mdreference/.agent/source-index.mdreference/.agent/processing-status.md- backward-compatible
reference/.agent/reference-index.mdandreading-status.md memory/current-status.mdmemory/claim-board.mdmemory/evidence-board.mdmemory/risk-board.mdmemory/action-board.mdpaper/.agent/writing-contract.mdcode/.agent/benchmark-plan.mdor equivalent, when present
Model Routing
Read references/project-link-routing.md.
- Tier 2 normal main model: routine project-use notes, citation placement, writing-pattern routing, structured feedback actions.
- Tier 3 strong/deep model: closest-work risk, must-have baseline, benchmark protocol, core algorithm/theory impact, project seed, conflicted collaborator feedback, final positioning.
- Do not use cheap sidecar output as the final authority for project decisions.
Workflow
- Locate the project root and existing memory.
- Read the relevant source card and its confidence/provenance.
- Identify requested synthesis mode:
- claim support or challenge
- baseline implication
- benchmark/task/protocol implication
- method/theory implication
- implementation implication
- writing pattern
- citation placement
- collaborator feedback/action
- project spec/constraint
- project seed
- reviewer-risk or novelty boundary
- Create or update
reference/project-use/<source-id>.mdfromtemplates/project-use-note.md. - Write only durable conclusions into project memory:
- claim/evidence/risk/action/provenance boards
- decision log or project current status
- paper writing contract or style memory
- code benchmark/baseline/implementation plan
- If the card is too weak, route back to
reference-reading-summarizerwith the required reading mode.
Output Rules
Each project-use note should include:
- one-line project relevance
- supported or challenged claims
- baseline, benchmark, implementation, or spec implications
- algorithm/theory implications
- writing/citation implications
- collaborator actions if relevant
- risks and actions
- confidence and required follow-up
End with the closure audit:
Goal: What project question did this source help answer?
Answer: What did we learn?
Path: Which card, sections/files, and memory objects support this?
Correctness: Why should we trust it, and what needs deeper reading?
Next: What changes in the project?
More from a-green-hand-jack/ml-research-skills
project-init
Initialize an ML research project control root. Use for paper/code/slides repos, shared memory, GitHub Project alignment, agent guidance, worktree policy, and lifecycle handoffs.
38project-sync
Sync verified code-side experiment results into paper memory. Use when logs, reports, run docs, or user-confirmed metrics should become paper-facing evidence.
36add-git-tag
Create annotated Git milestone tags. Use when completing a phase, releasing a version, or marking a research checkpoint.
36update-docs
Refresh project documentation after code changes. Use after implementing features, changing behavior, or preparing a milestone commit.
36new-workspace
Create Git branches or worktrees for research code and paper versions. Use for experiments, baselines, rebuttal fixes, arXiv/camera-ready branches, and worktree memory.
36init-latex-project
Initialize a LaTeX academic paper project. Use for new conference or journal papers needing templates, macros, venue preambles, and writing guidance.
36