# Skill: domain-lookup

Structured domain knowledge search across all PAISY knowledge sources.

## Invoked by

Any mode (📋 Planner, ❓ Ask, 🔍 Reviewer, 💻 Code)

## Required Inputs

| Input | Source | Example |
|-------|--------|---------|
| `TOPIC` | Domain topic or question | `"EuBP Archivierung"`, `"DSAK Änderungserkennung"`, `"Fehlzeiten DBFZ"` |
| `CONTEXT` | Additional context (optional) | `"for ESIDEPAISY-12081"`, `"Oracle migration syntax"` |

## Output

- Structured summary with sources cited
- New findings stored in BigMind for future reuse

## Steps

### 1. Search BigMind facts

```python
memory_search_facts("<2-3 keywords from TOPIC>")
```

FTS5 rule: AND-matches every token. Max 3 short keywords. Long queries return 0 results.

### 2. Search BigMind chunks

```python
memory_search_chunks("<2-3 keywords from TOPIC>")
```

Check for past decisions, code snippets, or session notes related to the topic.

### 3. Semantic search (if 1+2 return nothing)

```python
memory_search_semantic("<natural language description of what you're looking for>")
```

Use this when keyword search fails — it matches by meaning, not exact words.

### 4. Check ADP Docs Wiki index

```python
memory_search_facts("<topic> adpdocs")
```

Known page IDs (from BigMind `adpdocs-index` facts):
- EAU → 25123 | EuBP → 26666 | DaBPV → 27242 | DSBD → 26747 | DSAK → 26748
- DSVV → 18714 | RvBEA → 21174 | EEL → 2724 | ELStAM → 2737 | DEÜV → 5876
- Programmabläufe → 15201 | Einzelaufrufe BATCH → 15250 | Umgebungsvariablen → 22767
- PAISY verwalten → 15180 | Datenbanken verwalten → 15184 | Fehlermeldungen → 15196

### 5. Fetch Wiki page (if page ID known)

```python
set-wiki(uri="mcp://wikis/adpdocs.de.adp.com")
get-page(title="<page title>")
```

### 6. Search Wiki (if page ID not known)

```python
set-wiki(uri="mcp://wikis/adpdocs.de.adp.com")
search-page(query="<domain keywords>")
```

Or browse by category:
```python
get-category-members(category="Meldeverfahren")
```

Key categories: `Meldeverfahren`, `Verwalterhandbuch`, `Batchabläufe`, `Client Server (CS)`, `PAISYadvanced`, `Installationshandbuch für Windows und UNIX`

### 7. Search Confluence

```python
search_confluence_by_cql("text ~ '<topic keywords>' AND space = 'ESIDEPAISY'")
```

Or broader:
```python
search_confluence_by_cql("text ~ '<topic keywords>'")
```

### 8. Search Bitbucket (for code-level context)

```python
# Check recent PRs for related changes
list_prs_for_repository(project_key="ESIDEPAISY", repo_slug="paisy", status="MERGED")

# Or find a specific file
find_file(project_key="ESIDEPAISY", repo_slug="paisy", file_path="<path>", branch="current")
```

### 9. Web scraper (last resort only)

```python
webscraper_fetch(url="<relevant URL>")
```

**Only use if all previous sources returned nothing.** Never skip to webscraper if BigMind or Wiki MCP can answer.

### 10. Store new findings

After finding useful information, immediately store it:

```python
# For Wiki page discoveries
memory_store_fact(
    category="adpdocs-index",
    fact=f"ADP Docs Wiki: '<page title>' (Page ID: {page_id}) — <brief description of content>"
)

# For domain knowledge
memory_store_fact(
    category="codebase",
    fact=f"<domain topic>: <key finding>. Source: <where it came from>"
)

# For detailed findings
memory_append_chunk(
    session_id=SESSION_ID,
    content=f"Domain lookup for '{TOPIC}':\n<detailed findings with sources>",
    flag_reason="domain knowledge"
)
```

## Expected Output

- Structured answer with cited sources
- Priority: BigMind facts → BigMind chunks → ADP Docs Wiki → Confluence → Bitbucket → webscraper
- New findings stored in BigMind for future lookups

## Error Handling

| Error | Resolution |
|-------|------------|
| BigMind FTS returns 0 | Reduce to 2 keywords, try synonyms, then use semantic search |
| Wiki page not found | Try `search-page` with different keywords, or browse category members |
| Confluence returns nothing | Broaden CQL query, remove space filter |
| All sources empty | Report "no information found" honestly — don't fabricate answers |
| Wiki connection error | Ensure `set-wiki` was called first with correct URI |

## Search Strategy Tips

- **German domain terms** often work better than English: `Fehlzeiten` not `absences`, `Lohnkonto` not `payroll account`
- **Abbreviations** are common: `DSAK`, `DSBD`, `DSVV`, `EuBP`, `DaBPV`, `RvBEA`, `EEL`
- **PAISY program names** are searchable: `PAI022`, `PAI028`, `PAI030`, `PAIBATCH`
- **Error codes** from PAISY start with `F;` — search for the specific code in Wiki Fehlermeldungen page (15196)

## Language

- Search queries: match the source language (German for Wiki/Confluence, English for code)
- Output summary: match the user's language
- Stored facts: English (BigMind convention)