protocol-alignment

Compare cc-office protocol files against the VS Code Extension surface to detect alignment gaps.

11|2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/recca0120/code-quest --skill protocol-alignment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: protocol-alignment
Source: https://github.com/recca0120/code-quest/tree/main/.claude/skills/protocol-alignment
Command: npx skills add https://github.com/recca0120/code-quest --skill protocol-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Protocol drift between cc-office and the real Claude Code VS Code Extension can silently break event handling and control-request behavior, making sessions unreliable and permissions incorrect.

Core Features & Use Cases

  • Protocol surface comparison: Compares cc-office’s protocol implementation against the extension’s extracted event/subtype surface to quantify coverage.
  • Coverage matrix updates: Produces an alignment/gap report using statuses like ✅ Implemented, ⚠️ Partial, and ❌ Missing, so you can track changes across extension releases.
  • Real JSON validation workflow: Uses real captured NDJSON samples as ground truth to confirm schema accuracy and support test-fixure generation.

Quick Start

Ask the skill to compare the cc-office protocol implementation (claude-schemas.ts, claude.ts, claude-adapter.ts) against references/extension-surface.md and update references/coverage-matrix.md.

Frequently Asked Questions about protocol-alignment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect protocol drift between my implementation and the Claude Code VS Code extension?

To detect protocol drift, compare your event and control_request implementation against the extension's extracted protocol surface. This generates a structured coverage matrix identifying gaps using statuses like Implemented, Partial, and Missing.

What is a protocol coverage matrix and how does it track event schema alignment?

A protocol coverage matrix tracks event schema alignment by mapping CLI-to-server and server-to-CLI paths against the real extension surface. It outputs a structured gap status per event, subtype, and control_request to quantify completeness.

How do I validate Zod schemas using real NDJSON samples from Claude Code?

Validate Zod schemas by using real captured NDJSON samples as ground truth. This confirms schema accuracy and detects behavioral differences after extension updates by testing actual event data against your defined protocol structures.

Can I audit protocol event and subtype completeness after a VS Code extension update?

Yes, you can audit protocol completeness after an update by comparing your three protocol files against the extracted extension surface. This comparison reveals behavioral differences and missing event subtypes across communication paths.

Does protocol alignment require specific files to compare coverage gaps?

Yes, protocol alignment requires focusing the comparison on three specific cc-office protocol files: claude-schemas.ts, claude.ts, and claude-adapter.ts. It also uses extracted extension protocol surfaces and real JSON samples as references.

Why does protocol drift break control_request behavior in Claude Code sessions?

Protocol drift breaks control_request behavior because implementation differences silently corrupt event handling and permissions. Comparing your protocol against the real extension surface detects these gaps and prevents unreliable sessions.