---
name: advanced-workflows
description: Multi-tool orchestration patterns for BK operations
---

# Advanced BK Workflows

Multi-tool patterns for efficient knowledge retrieval and management.

## Core Patterns

### Progressive Library Exploration

```
1. list_stores() → identify target store
2. search(query, detail='minimal', stores=[target]) → scan summaries
3. get_full_context(top_result_ids) → deep dive on best matches
```

### Add Library + Wait for Index

```
1. create_store(url, name) → job_id
2. check_job_status(job_id) → poll every 15-30s
3. When completed: search(query, stores=[name]) → verify
```

### Progressive Detail Strategy

```
1. search(query, detail='minimal', limit=20) → ~100 tokens/result
2. Filter by score (>0.7 = strong match)
3. get_full_context(top_3_ids) → saves ~80% context
4. If nothing relevant: refine query and retry
```

### Cross-Library Comparison

```
1. search(query, limit=10) → searches ALL stores
2. Review store distribution
3. Narrow: search(query, stores=['lib1', 'lib2'], limit=15)
```

## Best Practices

1. **Start with detail='minimal'** — summaries first, full context selectively
2. **Monitor background jobs** — don't search until indexing completes
3. **Use intent parameter** — 'find-implementation' vs 'find-usage' vs 'find-documentation'
4. **Filter by stores** — faster, more focused results
5. **Check scores** — >0.7 strong match, <0.5 likely noise

Detailed examples and error recovery: [references/examples.md](references/examples.md)