ship-protocol

Success Heuristics for Intelligent Programming

-brightgreen?style=for-the-badge) [](https://www.npmjs.com/package/@vibeatlas/ship-protocol) [](LICENSE)

---

70% of AI coding tasks fail. Current tools focus on tokens and cost, not outcomes.

• Trust in AI-generated code dropped from 43% to 33%
• 30.5% of AI suggestions contain errors
• 66% of developers frustrated by "almost right" code
• No universal metric for AI coding reliability

SHIP Protocol provides a universal reliability score for AI-assisted development.

SHIP Score = (Confidence × 0.40) + (Focus × 0.30) + (Context × 0.20) + (Efficiency × 0.10)

One number (0-100) that tells you: Will this AI task succeed?

---

npm install @vibeatlas/ship-protocol

import {
  createShipRequest,
  calculateShipScore,
  interpretShipScore,
  getShieldsIoBadgeUrl
} from '@vibeatlas/ship-protocol';

// Create a SHIP request
const request = createShipRequest({
  files: [
    {
      path: 'src/main.ts',
      content: '// your code here',
      language: 'typescript',
      size_bytes: 1024
    }
  ],
  prompt: 'Add error handling to the API endpoints'
});

// Calculate SHIP Score
const score = calculateShipScore(
  92,  // confidence
  88,  // focus
  85,  // context
  75   // efficiency
);

console.log(`SHIP Score: ${score.score} (${score.grade})`);
// Output: SHIP Score: 89 (A)

// Get interpretation
const interpretation = interpretShipScore(score.score);
console.log(interpretation.summary);
// Output: High reliability - Production ready

// Generate badge URL
const badgeUrl = getShieldsIoBadgeUrl(score.score, 'for-t