ifixkart-admin/workflows/sharable/generic/update-graphify.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

159 lines
3.9 KiB
Markdown

---
description: Updates the Graphify knowledge graph to reflect recent code changes
---
## Update Graphify Knowledge Graph
This workflow updates the Graphify knowledge graph to ensure AI assistants have the latest code structure and relationships for accurate code discovery and context.
### Prerequisites
Graphify must be installed. Choose one method:
**Global Install (Python 3.10+):**
```bash
pip install graphifyy
```
**uvx (no Python version requirement):**
```bash
brew install uv
```
### Steps
1. **Check installation method**
Determine which method you're using:
- If `graphify` command works → global install
- If you need `uvx --from graphifyy graphify` → uvx method
2. **Update the graph (incremental)**
For small to medium code changes, run an incremental update:
**Global install:**
```bash
graphify update .
```
**uvx:**
```bash
uvx --from graphifyy graphify update .
```
This only re-indexes changed files and is much faster than a full rebuild.
3. **Full rebuild (if needed)**
Perform a full rebuild if:
- Major refactoring occurred
- Graph queries return stale information
- After pulling large changes from remote
- Graphify output seems corrupted
**Global install:**
```bash
rm -rf graphify-out/
graphify update .
```
**uvx:**
```bash
rm -rf graphify-out/
uvx --from graphifyy graphify update .
```
4. **Verify the update**
Check that the graph was updated successfully:
- The `graphify-out/` directory should have recent modification times
- Run a test query: `graphify query "where is OrderDetails used"` (or uvx equivalent)
- If the query returns relevant results, the update was successful
### When to Run This Workflow
Run this workflow after:
- Completing a feature implementation
- Major refactoring across multiple files
- Adding new components or services
- Changing file structure or moving files
- Pulling significant changes from the repository
### IDE Integration
This repo supports two IDE configurations: Devin (`.devin/`) and Kiro (`.kiro/`).
#### Kiro
**If using global install:**
```bash
graphify kiro install
```
**If using uvx:**
```bash
uvx --from graphifyy graphify kiro install
```
This creates:
- `.kiro/skills/graphify/SKILL.md` — the `/graphify` skill
- `.kiro/steering/graphify.md` — always-on steering that makes Kiro query the graph first
Kiro will now automatically use the knowledge graph for every interaction.
#### Devin
Devin reads the `.devin/context/` and `.devin/rules/` directories. The graphify context file at `.devin/context/graphify.md` provides usage patterns for Devin's AI assistant. No installation needed — Devin automatically reads the context file.
#### Other Supported IDEs
**If using global install:**
```bash
graphify install --platform <name>
```
**If using uvx:**
```bash
uvx --from graphifyy graphify install --platform <name>
```
Platform options: `claude`, `codex`, `opencode`, `aider`, `cursor`, `gemini`, `trae`, `hermes`, `kiro`, `pi`, `devin`
### Troubleshooting
**Command not found:**
- Global: `pip install graphifyy`
- uvx: `brew install uv`
**Python version too old (3.9):**
- Use uvx method instead of global install
**Graph still seems outdated:**
- Delete `graphify-out/` and do a full rebuild
### Quick Reference
| Scenario | Global Install | uvx |
| ------------- | ------------------------------------------- | ---------------------------------------------------------------- |
| Small changes | `graphify update .` | `uvx --from graphifyy graphify update .` |
| Major changes | `rm -rf graphify-out/ && graphify update .` | `rm -rf graphify-out/ && uvx --from graphifyy graphify update .` |
| Test query | `graphify query "question"` | `uvx --from graphifyy graphify query "question"` |