jmagly 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 <type> <name>. Never use find, ls, Glob, or direct Read on <provider>/skills/ paths — those reflect the kernel-pivot deploy state, not the full surface.
aiwg discover "<phrase>" # find — returns ranked candidates
aiwg show skill <name> # 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
- Identify the capability domain the user's need belongs to
- Pick a curated phrase from that domain (or paraphrase the user's words)
- Run
aiwg discover "<phrase>"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, acquire PDFs, 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 |
| 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
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
aiwg discover "induct research source" # → induct-research (score 1.00)
aiwg discover "research document summary" # → research-document
Quality assessment
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
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
aiwg discover "research query corpus" # → research-query (score 0.90)
aiwg discover "research status" # → research-status
Health, snapshot & archive
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
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)
├── 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 (citation-network nodes)PROF-[POFG]-<slug>— entity profiles (people / orgs / funders / groups)- Both ID spaces are first-class in
aiwg index neighborstraversal.
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
aiwg discover "<your need, paraphrased>" --limit 5
Anti-pattern: don't enumerate
If a user asks "what research skills are available?", do not list from this skill. Run:
aiwg discover --type skill --limit 20 "<their interest area>"