pi_mcps/zoo_backup/work/rules/skills/skill-domain-lookup.md

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

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

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)

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

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)

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

6. Search Wiki (if page ID not known)

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

Or browse by category:

get-category-members(category="Meldeverfahren")

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

7. Search Confluence

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

Or broader:

search_confluence_by_cql("text ~ '<topic keywords>'")

8. Search Bitbucket (for code-level context)

# 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)

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:

# 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)