Conducks
CONDUCKSPROTOCOL

The Engineering
Constitution

Encode senior judgment into your codebase. Mandatory structural logic for AI agents and human teams.

Kinetic Architecture Mirror
View

Structural Intelligence

Structural
Intelligence

Conducks transforms your source code into a kinetic map of behavioral edges, functional bridges, and structural gravity.

Tree-sitter
Gnosis Engine
01

Gnosis Engine

Regex-based semantic extraction that recovers structural connectivity when traditional parsers fail. Achieves 100% resilience across all supported languages.

02

Weighted Dijkstra

Calculate functional bridges between symbols using physics-based weights. Identifies critical paths and bottleneck risks across your entire dependency graph.

03

GVR Refactoring

Graph-Verified Renames. Safeguards your architecture by validating renames across all proven callers with zero-touch propagation.

Detailed Mirror Analysis
View

Kinetic Detail

Kinetic
Detail

The detailed mirror view exposes the underlying synapses of your codebase, revealing the functional bridges and behavioral edges that define your system's structural integrity.

Granular Mapping

Decompose complex inheritance chains and import graphs into actionable structural intelligence.

Sidebar Intelligence

Instant access to symbol gravity, risk scores, and blast radius metrics directly within the visual interface.

Workspace

Unified
Workspace

The Conducks Pulse engine synchronizes your IDE with the structural graph in real-time. Detect architectural drift as it happens.

Real-Time Sync

Changes in your editor are instantly reflected in the synapse, updating gravity and risk scores automatically.

Drift Detection

Conducks alerts you when a new import violates the predefined structural constitution of your repository.

Engineering Workspace
View

Taxonomy

9-Layer
Taxonomy

Conducks maps every construct across all languages to a universal structural hierarchy, from ecosystems to atomic data points.

Universal Taxonomy Map
View
L0
Ecosystem
Cross-Repo
L1
Repository
Services
L2
Namespace
Modules
L3
Unit
Files
L4
Infra
Routes
L5
Structure
Classes
L6
Behavior
Methods
L7
Atom
Variables
L8
Data
Records

Language Support

Universal
Language Support

Unified structural mapping for cross-language agents.

FeatureTypeScriptPythonGoRustJavaC++
Imports
Named Bindings
Exports
Heritage
Type Annotations
Constructor Inference
Config
Frameworks
Entry Points

Governance

Agentic
Governance

The Conducks MCP server provides agents with the 6-signal risk decomposition of any symbol. Empower your AI to make senior-level decisions.

Risk Decomposition

Gravity, Complexity, Entropy, Churn, FanOut, and Debt are distilled into a single actionable risk score.

Cerebral Circuits

Agents can trace granular execution flows to understand exactly how data pulses through your system.

Agent Governance Hub
View

Architecture

Three-Layer
Architecture

Intelligence Layer

25 CLI commands and 9 unified MCP tools providing analysis, metrics, and kinetic governance.

Reflection Layer

Language-specific lenses powered by 14 Tree-sitter grammars and the Gnosis Regex fallback engine.

Core Layer

Atomic DuckDB storage, weighted graph pathfinding, and the structural registry hub.

Intelligence
Reflection
Core Synapse

Roadmap

What's Next

Our roadmap to the ultimate agentic governance platform.

Completed

Production TS / Python / Go
Real-time Kinetic Mirror
9 Unified MCP Tools
Gnosis Fallback Engine

In Progress

Query Template Library (19 templates)
Filter Builder for conducks_query
DAAC Community Clustering UI

Planned

import type Edge Detection (GVR gap)
Dynamic Dispatch Resolver
Deep Traversal Precompute

Get Started

Initialization

Deploy the Conducks Protocol to your local environment in seconds.

01

Build

$ git clone https://github.com/Conducks/conducks
$ cd conducks/conducks
$ npm install && npm run build
02

Connect

{
"mcpServers": {
"conducks": {
"command": "node",
"args": ["/absolute/path/to/conducks/conducks/build/index.js"]
}
}
}

Build
Better

GitHub Source