---
name: gdd-graphify
description: "Manage the Graphify knowledge graph for the current project. Build, query, status, diff. When available, design-planner and design-integration-checker use the graph for pre-search consultation."
---

# gdd-graphify

Thin command wrapper around the get-design-done (GDD) graphify tools integration.

## Usage

```
/get-design-done graphify build          # Build or rebuild the knowledge graph
/get-design-done graphify query <term>   # Query graph for a node and neighbors
/get-design-done graphify status         # Check graph age, enabled, node count
/get-design-done graphify diff           # Show topology changes since last build
```

## Behavior

1. Read `.design/STATE.md` to check `graphify` status in `<connections>`.
2. Check `graphify.enabled` in `.design/config.json` via a direct file read (per D-09 - no `config-get` CLI subcommand):
   ```
   node -e "try{const c=JSON.parse(require('fs').readFileSync('.design/config.json','utf8'));process.stdout.write(String(c.graphify?.enabled===true))}catch{process.stdout.write('false')}"
   ```
3. If not enabled, print:
   ```
   "Graphify is not enabled. Edit `.design/config.json` to set `graphify.enabled: true`."
   "Then run {{command_prefix}}graphify build to generate the knowledge graph."
   ```
   STOP.
4. Execute the requested subcommand via the native CLI:
   - build:  `node "${CLAUDE_PLUGIN_ROOT}/bin/gdd-graph" build`
   - query:  `node "${CLAUDE_PLUGIN_ROOT}/bin/gdd-graph" query "<term>" --budget 2000`
   - status: `node "${CLAUDE_PLUGIN_ROOT}/bin/gdd-graph" status`
   - diff:   `node "${CLAUDE_PLUGIN_ROOT}/bin/gdd-graph" diff`
5. After `build` completes, update `.design/STATE.md` `<connections>`: `graphify: available`

## Required Reading

- `.design/STATE.md` - for graphify status in `<connections>`
- `.design/config.json` - for `graphify.enabled` flag

## Notes

- Graphify is optional. The native CLI ships with the plugin at `${CLAUDE_PLUGIN_ROOT}/bin/gdd-graph` (no external install - Node only).
- Graph is stored at `.design/graph/graph.json` (Ajv-validated against `scripts/lib/graph/schema.json`).
- Graph covers source code (`src/`, `components/`). It does NOT index `.design/` artifacts by default.
- Use `query` with node IDs from the graph schema: `component:<name>`, `token:color/<name>`, `decision:D-<nn>`, etc.