llm-wiki-research

Files (1)

• SKILL.md

SKILL.md (first lines)

# LLM Wiki Research

Sub-skill of llm-wiki-pm. Handles research sprints, competitive deep dives, and auto-enrichment of stub entities. Every fetched source goes through the core ingest capture step, so privacy filtering and raw/ logging happen correctly.

**WebFetch note:** use `WebFetch` freely to preview a page. Before you save a source to raw/, apply the privacy filter from the core ingest guide.

## Orient First

Orient per AGENTS.md before any writes:

1. Read `$WIKI/SCHEMA.md`
2. Read `$WIKI/index.md`
3. Read last 20-30 lines of `$WIKI/log.md`
4. Read `$WIKI/overview.md`

Research sprints may create many pages. Get user confirmation before creating 10+ pages; below that, write and report.

## Wiki Path Resolution

```bash
WIKI=$(cat .wiki-path 2>/dev/null | tr -d '[:space:]')
CONF='${user_config.wiki_path}'; case "$CONF" in '${'*) CONF= ;; esac  # plugin option, if set
WIKI=${WIKI:-${CONF:-${WIKI_PATH:-}}}
[ -z "$WIKI" ] && [ -f SCHEMA.md ] && WIKI=$(pwd)  # cwd only if it is already a wiki
```

## Source Capture

For each source, fetch it (`WebFetch`) and capture it with the core skill's Ingest step ① (`llm-wiki-pm/references/ingest-guide.md`: route to `raw/<subdir>/`, apply the privacy filter, dedup by URL). Use the saved `raw/<subdir>/<slug>.md` path for synthesis and `[source: ...]` markers. For 4+ sources, a general-purpose subagent can fetch and save them in parallel; give it the ingest-guide rules.

---

## Operation 1: Research Sprint

**Trigger:** "research sprint on [topic]", "deep research on [topic]"

**① Define scope**

Confirm with user:
- What is the topic / question to answer?
- Target depth: surface / standard / deep
- Time budget (number of sources)

**② Wiki-first**

```bash
grep -r "<topic>" $WIKI --include="*.md" -l
```

Read all relevant pages. Surface: "Wiki has N relevant pages. Here's what we already know: [...]. Gaps: [...]."

**③ Research plan**

Present 3-5 specific sources to fetch — name each, why it's relevant, what question it answers. Typical: analyst reports, company pages, recent press, whitepapers, industry forums. Get user confirmation before fetching.

**④ Capture sources**

For each confirmed source, fetch it and save it to raw/ (see Source Capture).

If a fetch fails (404, paywall, timeout), note it and continue. Collect all raw/ paths before writing.

**⑤ Synthesize**

Read all fetched raw files. Extract entities, claims, data points. Cross-reference against existing wiki pages. Distinguish:
- Confirmed (claim now in 2+ independent sources)
- New (single source, not yet corroborated)
- Contradicts wiki (surface the conflict explicitly)

**⑥ File findings**

Create/update wiki pages per core ingest discipline: inline provenance, coverage markers, confidence levels, min 2 outbound wikilinks, backlink audit.

Produce a synthesis page at `queries/research-<topic>-<YYYY-MM-DD>/research-<topic>-<YYYY-MM-DD>.md` (the page is named after its folder so its slug matches):

```markdown
---
title: "Research Sprint: <Topic>"
created: YYYY-MM-DD
type: query
tags: [<relevant tags>]
sources: [<raw slugs fetched>]
---

## Scope
Question: [...]  Depth: [...]  Sources: N

## What We Knew
[Pre-sprint wiki state summary]

## What We Learned
[Net-new findings with inline citations]

## Confirmations
[Claims now corroborated by 2+ sources]

## Contradictions
[Conflicts with existing wiki pages — cite both sides]

## Still Unknown
[Gaps that fetching didn't resolve]

## Pages Created/Updated
- [[slug]]: [brief note]
```

**⑦ Surface delta**

What did we learn that we didn't know? What did it confirm? What's still unknown? Any contradictions with the wiki?

**⑧ Log**

```
## [YYYY-MM-DD] research-sprint | topic: <X> | sources: N | pages created/updated: N
```

---

## Operation 2: Competitive Deep Dive

From anh-chu/llm-wiki-pm, MIT.

More from anh-chu/llm-wiki-pm