> For the complete documentation index, see [llms.txt](https://docs.biobox.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biobox.io/guide/how-to/ask-biobox-with-claude/tools/get-concept-guidance.md).

# get\_concept\_guidance — Get guidance for a concept

Get guidance for a concept

Get guidance for a concept

## What it does

Get the DB-authored guidance playbooks scoped to a specific concept (by dbLabel).

**When to use:** you've settled on a concept (dbLabel) and want any org guidance attached to it.

**When NOT to use:** you're matching guidance by intent phrase or multiple concepts — use find\_guidance.

**Parameters:**

* `dbLabel` — the concept's graph dbLabel (e.g. "DiffExpDataset").

**Returns:** An object { playbooks, count }. Each playbook is { uuid, kind, title, instructions, triggers, conceptDbLabels, relationshipTypes, propertyUsages, subgraphUuids, groundingBxql, bxql, cypher, enabled }. Treat `conceptDbLabels`/`relationshipTypes` as REFERENCES to hydrate from the ontology (pull each concept's real properties and each relationship's valid endpoints/forQL from the schema tools), NOT snapshots. `propertyUsages` is an optional grounding-key hint (which Concept.property to filter on; defaults to displayName). `groundingBxql` is a narrower discovery path to run FIRST to enumerate the distinct grounding values, then inject them into `bxql`. `bxql` is a SCAFFOLD to adapt (inject grounded filters, add question-specific constraints), not a literal. `instructions` is the org's guidance to follow; `cypher` is an optional snippet. Newest playbooks first.

## Parameters

| Parameter | Type   | Required | Description                                          |
| --------- | ------ | -------- | ---------------------------------------------------- |
| `dbLabel` | string | yes      | the concept's graph dbLabel (e.g. "DiffExpDataset"). |

## Response

```ts
_(identity shaper — response = the handler result; see the tool source.)_
```

## Example

```json
// get_concept_guidance({"dbLabel":"Disease"})
{
  "dbLabel": "Disease"
}
```

Response (arrays truncated):

```json
{
  "playbooks": [
    {
      "uuid": "a98x1DQsb2CyfFMcc-PqY",
      "kind": "intent",
      "title": "Cell lines by gene dependency / effect score (DepMap), + diseases they model",
      "instructions": "Use for questions about cell lines with a gene dependency and/or effect score (DepMap-style), and optionally the diseases those cell lines model. The score thresholds come from the question. Filter on…",
      "triggers": [
        "dependency",
        "dependency score",
        "effect score",
        "… 4 more"
      ],
      "conceptDbLabels": [
        "Gene",
        "CellLine",
        "Disease"
      ],
      "relationshipTypes": [
        "has dependency",
        "models disease"
      ],
      "propertyUsages": [
        "Gene.displayName",
        "has dependency.dependency_score",
        "has dependency.effect_score"
      ],
      "subgraphUuids": [],
      "groundingBxql": "(g:Gene {displayName = \"MTOR\"})<- has dependency <-(c:CellLine)",
      "bxql": "(g:Gene {displayName = \"MTOR\"})<- has dependency {effect_score < 0 & dependency_score > 0.5} <-(c:CellLine)-> models disease ->(d:Disease)",
      "cypher": null,
      "enabled": true
    },
    {
      "uuid": "3hyIxPUQHozHNEVz7MEkg",
      "kind": "intent",
      "title": "Differentially expressed genes by disease (bulk, no cell type)",
      "instructions": "Use when the question asks for genes differentially expressed in a disease but does NOT mention a cell type. The bxql is a scaffold to adapt. Grounding flow: (1) run groundingBxql to enumerate the Dis…",
      "triggers": [
        "differentially expressed",
        "differential expression",
        "upregulated genes",
        "… 1 more"
      ],
      "conceptDbLabels": [
        "DifferentialExpressionDataset",
        "Disease",
        "Gene"
      ],
      "relationshipTypes": [
        "differentially expresses",
        "studies condition"
      ],
      "propertyUsages": [
        "Disease.displayName"
      ],
      "subgraphUuids": [],
      "groundingBxql": "(d:DifferentialExpressionDataset)-> studies condition ->(di:Disease)",
      "bxql": "(g:Gene)<- differentially expresses <-(d:DifferentialExpressionDataset)-> studies condition ->(di:Disease)",
      "cypher": null,
      "enabled": true
    },
    {
      "uuid": "wAKnkxZI9sA15pq6zI7Hc",
      "kind": "intent",
      "title": "Differentially expressed genes by disease × cell type (single-cell)",
      "instructions": "Use when the question asks for genes differentially expressed in a disease AND names a cell type / population (single-cell). The bxql is a scaffold to adapt. Grounding flow: (1) run groundingBxql to e…",
      "triggers": [
        "differentially expressed",
        "differential expression",
        "cell population",
        "… 3 more"
      ],
      "conceptDbLabels": [
        "CellType",
        "ScDiffExpDataset",
        "Disease",
        "… 1 more"
      ],
      "relationshipTypes": [
        "analyzes celltype",
        "studies condition",
        "differentially expresses"
      ],
      "propertyUsages": [
        "CellType.displayName",
        "Disease.displayName"
      ],
      "subgraphUuids": [],
      "groundingBxql": "(input:CellType)<- analyzes celltype <-(d:ScDiffExpDataset)-> studies condition ->(di:Disease)",
      "bxql": "(input:CellType)<- analyzes celltype <-(d:ScDiffExpDataset)-> studies condition ->(di:Disease) + (d:ScDiffExpDataset)-> differentially expresses ->(g:Gene)",
      "cypher": null,
      "enabled": true
    }
  ],
  "count": 3
}
```