--- name: research-quickref namespace: aiwg platforms: [all] kernel: true description: AUTO-INVOKE when user mentions research, paper, citation, GRADE, corpus, provenance, literature review, induct paper, induct media, video/audio research, timestamp citations, evidence, bibliography. Research framework quick reference — discovery phrases for corpus inception, paper and media acquisition, GRADE quality, citation graphs, provenance-tracked synthesis. --- # Research Framework — Quick Reference This is your always-loaded directory for the AIWG **research-complete** framework. It does **not** list every skill. Instead, it teaches the framework's mental model and gives you **curated search phrases** that map to `aiwg discover` lookups. ## Canonical access pattern: discover → show When you find a candidate via `aiwg discover`, fetch its body with `aiwg show --body`. **Never** use `find`, `ls`, `Glob`, or direct `Read` on `/skills/` paths — those reflect the kernel-pivot deploy state, not the full surface. ```bash aiwg discover "" # find — returns ranked candidates aiwg show skill --body # fetch — streams the SKILL.md body ``` If your platform's Skill tool errors on a non-kernel skill (expected — most aren't kernel), the fallback is `aiwg show`, never filesystem browsing. Last-resort if `aiwg` itself is broken: read directly from `$AIWG_ROOT/agentic/code/...` (the canonical corpus, always present). ## How to use this quickref `aiwg show ` returns a metadata card. Inspect its outline, then fetch a needed `--section "Heading"` or use `--body` for the full instructions. Fetch required rules with `--rules --with-rule-bodies` before governed work. 1. Identify the **capability domain** the user's need belongs to 2. Pick a **curated phrase** from that domain (or paraphrase the user's words) 3. Run `aiwg discover ""` and surface the top match (or top-3) to the user **Do not enumerate skills from memory.** Discovery is the lookup surface. ## What this framework is for Research workflow automation. Builds and maintains a citation-graphed research corpus: discover papers and time-based media, acquire PDFs or media/transcripts, induct sources with structured analysis, assess quality via GRADE, build citation networks, query with grounded answers, and archive with W3C PROV provenance. ## Capability domains | Domain | Covers | |---|---| | **Discovery & acquisition** | Find papers across academic databases, download PDFs, extract metadata | | **Induction & summarization** | Bring sources into the corpus with structured analysis and literature notes | | **Time-based media** | Induct videos, lectures, podcasts, interviews, transcript sidecars, timestamp citations | | **Quality assessment** | GRADE methodology — assess study design, sample size, conflicts, peer review | | **Citation graphs** | Build/maintain citation networks, detect gaps, traverse with `aiwg index neighbors` | | **Querying the corpus** | Grounded answers with inline REF-XXX citations | | **Health & integrity** | Lint corpus, snapshot state, archive with provenance | ## Curated discovery phrases ### Discovery & acquisition ```bash aiwg discover "research workflow" # → research-workflow (score 1.00) aiwg discover "research discover" # → research-discover aiwg discover "acquire research papers" # → research-acquire aiwg discover "best practices audit" # → best-practices-audit ``` ### Induction & summarization ```bash aiwg discover "induct research source" # → induct-research (score 1.00) aiwg discover "research document summary" # → research-document ``` ### Time-based media ```bash aiwg discover "induct media research source" # → induct-media aiwg discover "video audio research induction" # → induct-media / transcribe-media aiwg discover "timestamp citation transcript" # → induct-media / citation-guard aiwg discover "media REF template" # → source-types / induct-media ``` ### Quality assessment ```bash aiwg discover "GRADE source quality" # → grade-on-ingest / quality-assess aiwg discover "research quality audit" # → research-quality-audit aiwg discover "GRADE distribution report" # → grade-report ``` ### Citation graphs ```bash aiwg discover "citation network" # → corpus-index-build / citation-backfill aiwg discover "verify citations" # → verify-citations (score 1.00) aiwg discover "research gap detection" # → research-gap-detect aiwg discover "citation guard" # → citation-guard aiwg discover "format citation" # → research-cite ``` ### Querying the corpus ```bash aiwg discover "research query corpus" # → research-query (score 0.90) aiwg discover "research status" # → research-status ``` ### Health, snapshot & archive ```bash aiwg discover "snapshot the corpus" # → corpus-snapshot (score 1.00) aiwg discover "corpus export" # → corpus-export aiwg discover "research archive" # → research-archive aiwg discover "research lint" # → research-lint ``` ### Provenance ```bash aiwg discover "create provenance record" # → provenance-create / auto-provenance aiwg discover "query provenance chain" # → provenance-query / provenance-report aiwg discover "validate provenance" # → provenance-validate ``` ## Corpus directory layout Research artifacts go under `.aiwg/research/`: ``` .aiwg/research/ ├── findings/ # REF-XXX literature notes (one per source) ├── citations/ # Citation sidecars (REF-XXX-citations.md) ├── sources/ # Acquired papers (PDFs, metadata) ├── media/ # Time-based media archive policy records │ ├── video/ # `media/video/` copied or LFS-managed video when permitted │ ├── audio/ # `media/audio/` copied or LFS-managed audio when permitted │ └── transcripts/ # `media/transcripts/` timestamped transcript sidecars ├── profiles/ # Entity profiles │ ├── people/ # PROF-P-* author/researcher profiles │ ├── orgs/ # PROF-O-* organizations │ ├── funders/ # PROF-F-* funding bodies │ └── groups/ # PROF-G-* research groups └── reports/ # GRADE distributions, gap reports, snapshots ``` ## ID conventions - `REF-NNN` — research papers or media sources (citation-network nodes) - `PROF-[POFG]-` — entity profiles (people / orgs / funders / groups) - `PROF-S-` — source/curator profiles for feeds, channels, or accounts - Both ID spaces are first-class in `aiwg index neighbors` traversal. ## Timestamp citations For media REFs, cite transcript-verified moments instead of page numbers: ```text @.aiwg/research/findings/REF-XXX.md @ HH:MM:SS - "exact transcript quote" ``` The timestamp must exist in the transcript sidecar, and the quote must match the transcript exactly. Use `induct-media` for media-curator acquisition handoff and record whether the source media is copied, stored through LFS/object storage, or tracked as a hash-only record. ## GRADE methodology Quality grading is opinionated and built-in. When inducting: - Apply quality assessment at ingest - Tag with HIGH / MODERATE / LOW / VERY LOW per GRADE - Higher-quality sources earn lower hedging in synthesis; LOW/VERY LOW require explicit hedging in any output ## When the curated phrases don't fit ```bash aiwg discover "" --limit 5 ``` ## Anti-pattern: don't enumerate If a user asks "what research skills are available?", **do not list from this skill**. Run: ```bash aiwg discover --type skill --limit 20 "" ``` --- Source attribution: jmagly Original project: https://github.com/jmagly/aiwg/blob/bc0cd4d707708593ef15781cb9d38364ea29bdd5/agentic/code/frameworks/research-complete/skills/research-quickref/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2024 Joe Magly Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: jmagly Original project: https://github.com/jmagly/aiwg/blob/bc0cd4d707708593ef15781cb9d38364ea29bdd5/agentic/code/frameworks/research-complete/skills/research-quickref/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Education & Research Roles: Academic Writer, Data Analyst, Researcher Specialties: Specialty not specified Tools: Tool not specified Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 7e4044d7551b0d9cf42eaeed102a723250f2825b3eb29665184b80386bb46e90