jmagly/research-quickref

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

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 "<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 neighbors traversal.

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>"