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

3.9 KiB

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+):

pip install graphifyy

uvx (no Python version requirement):

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:

    graphify update .
    

    uvx:

    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:

    rm -rf graphify-out/
    graphify update .
    

    uvx:

    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:

graphify kiro install

If using uvx:

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:

graphify install --platform <name>

If using uvx:

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"