inline-type-signatures
Inline Type Signatures (Zero-JSDoc Redundancy Protocol)
Overview
A pervasive token inefficiency in AI-generated code is Type Duplication: the model writes native TypeScript or Python type annotations, and then immediately repeats the exact same information inside a verbose 10-line JSDoc or Sphinx docstring (@param {string} userId - The ID of the user, @returns {Promise<boolean>} Whether the operation succeeded).
Duplicating type signatures across both syntax and comments burns 50 to 100 redundant tokens per function. In a 500-line service file, type duplication accounts for 2,000+ wasted tokens that clutter the IDE and drift out of sync over time.
The Inline Type Signature Protocol establishes the compiler's type system as the single source of truth - using concise inline type hints and restricting docstrings strictly to non-obvious business rationale.