COBOL Knowledge Graph analysis and debugging toolkit. Use this skill when working with Neo4j queries, debugging pipeline issues, analyzing COBOL programs, or running common development tasks for this project.
This skill provides commands and workflows for the COBOL Agentic Knowledge Graph project.
This project builds a knowledge graph from legacy COBOL codebases using:
uv run python -c "
from cobol_agentic_kg.utils.neo4j_client import Neo4jClient
client = Neo4jClient()
result = client.run_query('MATCH (n) RETURN labels(n)[0] as label, count(*) as count ORDER BY count DESC')
for r in result: print(f'{r[\"label\"]}: {r[\"count\"]}')
client.close()
"
List all programs:
MATCH (p:Program) RETURN p.name, p.type, p.complexity ORDER BY p.name
Find program dependencies:
MATCH (p:Program)-[:CALLS]->(called:Program)
WHERE p.name = 'PROGRAM_NAME'
RETURN p.name, called.name
Find data flow:
MATCH (p:Program)-[:USES]->(d:DataItem)
WHERE p.name = 'PROGRAM_NAME'
RETURN d.name, d.type, d.level
Find JCL jobs for a program:
MATCH (j:Job)-[:EXECUTES]->(p:Program)
WHERE p.name = 'PROGRAM_NAME'
RETURN j.name, j.description
Find copybooks used:
MATCH (p:Program)-[:INCLUDES]->(c:Copybook)
WHERE p.name = 'PROGRAM_NAME'
RETURN c.name
uv run streamlit run cobol_agentic_kg/ui/app.py
uv run pytest cobol_agentic_kg/tests/ -v
uv run python cobol_agentic_kg/evals/run_all_evals.py
neo4j status or check Docker.env has correct NEO4J_URI, NEO4J_USER, NEO4J_PASSWORDbolt://localhost:7687.env for OPENAI_API_KEY, GROQ_API_KEY, or GOOGLE_API_KEYllama-3.1-70b-versatile modeluv run python cobol_agentic_kg/test_groq_setup.pycobol_agentic_kg/agents/parsing.py for COBOL parsercobol_agentic_kg/agents/jcl_parser.py for JCL parsercobol_agentic_kg/agents/copybook_parser.py for copybook parsercobol_agentic_kg/
├── agents/ # LangChain agents
│ ├── parsing.py # COBOL parser
│ ├── jcl_parser.py # JCL parser
│ ├── copybook_parser.py # Copybook parser
│ ├── validation.py # Validation agent
│ ├── enrichment.py # Enrichment agent
│ ├── graph_builder.py # Neo4j graph builder
│ ├── cypher_gen.py # Cypher query generator
│ ├── retrieval.py # RAG retrieval
│ ├── tech_debt_analyzer.py # Tech debt analysis
│ ├── modernization.py # Modernization recommendations
│ └── translation.py # Code translation
├── config/
│ └── settings.py # Configuration
├── utils/
│ ├── neo4j_client.py # Neo4j connection
│ ├── llm_factory.py # Multi-LLM support
│ └── state.py # LangGraph state
├── workflows/
│ └── orchestrator.py # Pipeline orchestration
├── ui/
│ └── app.py # Streamlit UI
└── evals/ # Evaluation suite
When debugging or making changes:
workflows/orchestrator.pyagents/graph_builder.pyagents/cypher_gen.pyutils/state.pyui/app.py