Recoleta
GitHub
Source note

The Polyglot Protocol – senior-engineer guardrails for AI coding agents

Authors
sabirsemerkant
Source
Hacker News
Published
Collection
Software Intelligence
AI Coding AgentsCode GenerationPolyglot CodebasesAgent ValidationSoftware Quality
Open GitHubMarkdown source

Summary

The Polyglot Protocol gives AI coding agents a shared engineering checklist for multi-language repositories. It targets safer code generation through repository discovery, language choice rules, dependency checks, testing, security review, and final validation.

Problem

  • AI coding agents often guess APIs, package names, flags, and project conventions, which can produce code that looks valid but fails review or runtime checks.
  • Multi-language repositories raise the risk because the agent must choose the right language, preserve local patterns, and handle different runtimes and toolchains.
  • Teams lose time repeating standards that the agent should apply before writing code.

Approach

  • The project packages a portable skill for Codex, Claude Code, OpenCode, and custom coding-agent workflows.
  • The protocol requires repository discovery before implementation, then applies rules for language choice, dependency discipline, security, testing, validation, and final review.
  • It provides dedicated guidance for 22 languages, including TypeScript, Python, Rust, SQL, Java, Go, Swift, Kotlin, C++, and Zig.
  • It tells agents to verify tooling and API claims against local code or official docs, and to label unsupported checks with evidence.
  • A local script, scripts/validate-workspace.py, checks the protocol workspace.

Results

  • The excerpt reports no benchmarked agent-performance gains, no task-success rate, and no comparison against baseline prompting.
  • The project reports workspace validation: PASS and language guidance validation: PASS with a current score of 100/100.
  • The repository includes guidance for 22 languages and 22 language README files.
  • It lists 11 operational files for workflow, validation, and rules.
  • It includes adapters for 3 named coding environments: Codex, Claude Code, and OpenCode.

Link