Skip to content

codellm-devkit/cldk-forge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

cldk-forge

The forge where CodeLLM-DevKit (CLDK) gets built: a Claude Code plugin of agent skills for extending CLDK — build a new language's backend analyzer, wire it into the SDKs, and grow it through the analysis levels: symbol table, call graph, and native dataflow.

Install

/plugin marketplace add codellm-devkit/cldk-forge
/plugin install cldk-forge@codellm-devkit

Then just describe the task — "add Rust support to CLDK", "build a codeanalyzer for Kotlin", "wire the Go analyzer into python-sdk", "add dataflow analysis to codeanalyzer-go" — and the matching skill triggers.

Skills

Build and release the backend analyzer codeanalyzer-<lang> for a new language: a guided decision on the backend tooling (parser, resolver, packaging), then a modular analyzer scaffolded and verified stage by stage, shipped as a thin PyPI wheel + GitHub Release binaries + Homebrew formula via tag-triggered releases.

The analysis levels it owns:

Level What Cost
1 Symbol table + resolver-based call graph → canonical analysis.json Cheap, always built
2 Framework-based call-graph enrichment (Joern/WALA/SVF) Heavy, flag-gated
3 Native dataflow: CFG/DFG/PDG/SDG built from the language's own AST, with slicing and taint as queries Heavy, in-process, flag-gated

Also covered: the optional Neo4j projection (--emit neo4j — Cypher snapshot or live Bolt push, with the CPG as the level-3 overlay), deterministic parallelism (-j), testing gates and fixture design, and the analyzer README + CLAUDE.md agent guide as standing deliverables.

Key references: backend-recipe.md, tooling-menu.md, canonical-schema.md, dataflow-graphs.md (+ its construction / substrate-menu / issue-template companions), neo4j-projection.md, packaging-and-release.md.

Wire an existing analyzer into a CLDK frontend SDK — today the Python SDK: the CLDK.<lang>() factory method, a per-language backend ABC with a local codeanalyzer backend and an optional read-only Neo4j backend, Pydantic models that validate against the analyzer's analysis.json, and mocked + E2E + backend-contract tests. The facade's query surface is designed interactively (every divergence decided with you), then encoded per SDK.

Typical flow

  1. codeanalyzer-backend → a working, released codeanalyzer-<lang> (level 1, optionally level 2) with a validated schema contract.
  2. cldk-sdk-frontend → the language reachable via CLDK.<lang>(project_path=...).
  3. When ready for dataflow: instantiate dataflow-issue-template.md as the level-3 epic on the analyzer repo (worked example: codeanalyzer-go#3) and build it stage by stage.

Layout

.claude-plugin/          # plugin + marketplace manifests
skills/
  codeanalyzer-backend/  # SKILL.md + references/ (the specs the skill reads on demand)
  cldk-sdk-frontend/     # SKILL.md + references/

Reference analyzers this skillset anchors on: codeanalyzer-java, codeanalyzer-python, codeanalyzer-typescript.

About

Agent skills for extending and maintaining CodeLLM-DevKit (CLDK)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors