Wikantik Platform Development Hub: Architecture, MCP Protocols, and Agent Briefings

Part of the Simple Agility stack. Coding agents working on the Wikantik repository (jspwiki) start sessions with get_briefing(clusters=["wikantik-development"], prompt="<task>") (SA-13) and coordinate cross-repo changes through SimpleAgilityAgentCoordination (SA-9). Runtime logging and metrics follow the SimpleAgilityTelemetryContract (SA-5, SA-6), with per-item checklists on SimpleAgilityTelemetryAdoption and sequencing on SimpleAgilityRoadmap.

Wikantik is a knowledge platform and agentic-memory engine designed to bridge human technical authoring with autonomous AI coding agents. It is a modernized Java 25 fork of the Apache JSPWiki engine with a React single-page UI, Lucene and dense-vector hybrid search, an LLM-extracted Knowledge Graph with an Apache Jena SPARQL ontology, and Model Context Protocol (MCP) tool surfaces. It serves both as a wiki and as a retrieval engine for AI agent sessions.

This hub details Wikantik platform internals, MCP integration patterns, search pipeline architectures, feature design records, and developer and release guides.


1. Quick-Reference: Wikantik Architecture Stack

LayerTechnologiesPrimary functionality
Agent surfaceMCP servers /wikantik-admin-mcp (29 tools) and /knowledge-mcp (22 read-only tools when fully wired); OpenAPI tool server /tools/* (2 tools)Authoring, curation, retrieval, session briefings
Knowledge GraphLLM-extracted entities and edges in PostgreSQL (kg_* tables); Apache Jena RDF/OWL ontology with read-only SPARQLEntity curation, traversal, ontology queries
Hybrid searchApache Lucene BM25 plus dense embeddings (pgvector, lucene-hnsw or in-memory), fused with Reciprocal Rank Fusion; BM25-only fallback when the embedder is downPage search and cited context bundles
Storage and versioningFile-system page provider with per-page version history (VersioningFileProvider); PostgreSQL for users, groups, policy grants, knowledge and embeddings, with the schema defined only by bin/db/migrations/V*.sqlVersion history, diffs, durable metadata
Web UI and REST APIJava 25, Tomcat 11, React single-page app built with Vite; REST under /api/* and /admin/*Reading, editing, curation, administration

2. Core Subsystems & Developer Guides

I. Start here

II. Agent Integration & MCP Tools

III. Knowledge Graph & Semantic Metadata

IV. Search & Retrieval Quality

V. Feature Design Records

VI. Build, Release & Operations

VII. Administrator Guides

Additional Cluster Reference Pages