Guides

In-depth guides on software development, AI integration, and building products with modern technologies.

Why AgentKits Memory's Hybrid Search Has to Solve Japanese Twice
Guides

Why AgentKits Memory's Hybrid Search Has to Solve Japanese Twice

BM25 misses meaning. Vector search misses exact error strings. AgentKits Memory fuses both — but for Japanese, Chinese, and Korean queries, the keyword half of that fusion needs a second decision underneath it.

agentkitssearchrag
Most COBOL Modernization Tools Stop at the Program. The Batch Job That Calls It Is Where Migrations Actually Break.
Guides

Most COBOL Modernization Tools Stop at the Program. The Batch Job That Calls It Is Where Migrations Actually Break.

Dependency-mapping tools built around COBOL treat JCL as a thin wrapper — a job name and some DD statements. But condition-code branching, PROC nesting, and GDG generation windows carry real control flow of their own, and it's routinely left out of the graph. Why Legacy Dragon parses JCL as a first-class language in the same AST, not metadata bolted on afterward.

legacy-dragonjclmainframe
AgentKits Marketing Has 28 Skills. It Never Loads More Than Five.
Guides

AgentKits Marketing Has 28 Skills. It Never Loads More Than Five.

The Marketing Kit's skills-registry.json catalogs 28 skills across five categories with a full dependency graph. Its own internal research doc names the reason for capping what gets loaded at once: 'context rot.' Here's how the shipped selector actually works, and why it's simpler than the research proposal that led to it.

agentkitscontext-engineeringai-agents
Japan's ¥12 Trillion Legacy-System Warning Isn't a COBOL-Skills Story. It's an Encoding Story.
Guides

Japan's ¥12 Trillion Legacy-System Warning Isn't a COBOL-Skills Story. It's an Encoding Story.

METI's 2025 digital cliff warning gets read as workforce attrition and rip-and-replace math. The failure mode that actually corrupts migrations first is smaller and easier to miss: EBCDIC and Shift-JIS don't even agree on whether letters or numbers sort first. Why Legacy Dragon treats character encoding as a parsing-layer concern, not a pre-processing step bolted on later.

legacy-dragoncobolmainframe
Two Plugins Live Inside AgentKits Marketing. Its Marketplace Listing Shows One.
Guides

Two Plugins Live Inside AgentKits Marketing. Its Marketplace Listing Shows One.

Open the agentkits-marketing repo's plugins/ folder and you'll find two self-contained products — Content Factory and Campaign Manager, each with its own commands, agents, and roadmap. Open marketplace.json and there's exactly one installable plugin. Here's what that gap says about where the kit is headed, and why it fits a wider shift away from monolithic tool bundles.

agentkitsplugin-architecturemarketplace
The Engineer Kit Has More Skills Than the Marketing Kit and Still Isn't Live
Guides

The Engineer Kit Has More Skills Than the Marketing Kit and Still Isn't Live

AgentKits shipped its Marketing Kit first — 18 agents, 93 commands, 28 skills, tagged Ready. The Engineer Kit sits right next to it on the homepage with a bigger skill count (40) and a yellow Preparing badge. Why build the coding-agent kit second, into a market that's already full of coding agents?

agentkitsengineer-kitroadmap
The Translator Is an Agent Too: How AgentKits Localizes Its Own Docs
Guides

The Translator Is an Agent Too: How AgentKits Localizes Its Own Docs

AgentKits ships its README and 23-module training course in ten languages — not through a translation vendor, but through a Node.js tool built on the Claude Agent SDK that the team also open-sourced on its own. Here's how the pipeline actually works, and why an LLM is the right tool for this specific job.

agentkitslocalizationclaude-agent-sdk
410 Million Reasons Not to Upload: PrivateAI and the Shadow AI Problem
Guides

410 Million Reasons Not to Upload: PrivateAI and the Shadow AI Problem

ChatGPT alone triggered over 410 million DLP policy violations in 2025. Most of that leakage isn't malicious — it's employees doing normal work through tools that happen to have a server in the loop. Here's why PrivateAI's browser-only architecture sidesteps the problem structurally.

privateaiprivacyshadow-ai
The Compliance Case for AI That Never Touches a Server
Guides

The Compliance Case for AI That Never Touches a Server

WebGPU finally makes browser-based AI fast, and a wave of 2026 data-localization law makes it valuable. Why on-device tools like PrivateAI are arriving at the right moment.

privateaiprivacywebgpu
Certain vs Optional: How Zunavi Decides What to Trust
Guides

Certain vs Optional: How Zunavi Decides What to Trust

Zunavi's feature flags don't just turn features on and off — they draw an explicit line between capabilities that are reliable today and ones that are still assistive and require human verification. Here's why that distinction is enforced twice.

zunavimanufacturingfeature-flags
Why We're Rebuilding Zunavi's Drawing Ledger From Scratch
Guides

Why We're Rebuilding Zunavi's Drawing Ledger From Scratch

The legacy system behind Zunavi tracked the 'latest' drawing revision by deleting and reinserting rows. Here's why that pattern breaks, and how PostgreSQL, Prisma, and a single boolean flag replace it for good.

zunavimanufacturingpostgresql
AI-Assisted Parsing for Legacy Code Modernization
Guides

AI-Assisted Parsing for Legacy Code Modernization

Why parsing is the bottleneck in legacy modernization projects, and how AST-based tools built for COBOL, JCL, PL/I, and other mainframe-era languages change the economics.

legacy-modernizationcobolast