pre-implement-spec

Analyze technical specifications for backward compatibility, risks, and gaps.

1.6k|354|Updated Sep 10, 2025
One-click install
npx skills add https://github.com/open-mercato/open-mercato --skill pre-implement-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pre-implement-spec
Source: https://github.com/open-mercato/open-mercato/tree/main/.ai/skills/pre-implement-spec
Command: npx skills add https://github.com/open-mercato/open-mercato --skill pre-implement-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill proactively identifies potential issues, risks, and gaps in a technical specification before any code is written, preventing costly rework and ensuring backward compatibility.

Core Features & Use Cases

  • Backward Compatibility Audit: Checks against 13 contract surface categories to find breaking changes.
  • Spec Completeness Check: Verifies all essential sections are present in the specification.
  • AGENTS.md Compliance: Ensures adherence to project coding standards and best practices.
  • Risk Assessment: Identifies technical, integration, and dependency risks.
  • Gap Analysis: Pinpoints missing information crucial for implementation.
  • Use Case: Before starting development on a new API endpoint, use this Skill to analyze its specification, ensuring it won't break existing clients and that all necessary details (like error handling and data models) are included.

Quick Start

Analyze the specification located at '/specs/new-user-api.md' to identify any backward compatibility issues or missing sections.

Frequently Asked Questions about pre-implement-spec

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

FAQPage Schema
How do I check a technical specification for backward compatibility issues before coding?

To check a technical specification for backward compatibility, analyze it against 13 contract surface categories to identify breaking changes before development begins. This process audits API endpoints and module structures to ensure existing clients remain unaffected by new implementations.

What is specification gap analysis and when do I need it?

Specification gap analysis is the process of pinpointing missing information crucial for implementation before coding starts. You need this pre-implementation assessment when preparing new API endpoints to verify that essential sections like error handling and data models are fully detailed.

How do I identify technical and integration risks in a software specification?

To identify technical and integration risks in a software specification, perform a pre-implementation risk assessment using a comprehensive checklist. This evaluation detects dependency vulnerabilities and structural issues across contract surfaces, data handling, and security protocols.

Can I verify if my API spec meets project coding standards and AGENTS.md compliance?

Yes, you can verify API spec compliance by checking the technical specification against your project's AGENTS.md file. This ensures the proposed implementation adheres to established coding standards and best practices before any development work starts.

What is the best way to audit a spec for missing sections and security issues?

The best way to audit a spec for missing sections and security issues is to execute a completeness check covering contract surfaces, data handling, and UI conventions. This generates a detailed readiness report highlighting gaps and security risks proactively.

When should I not use pre-implementation specification analysis?

Pre-implementation specification analysis should not be used after development has already begun, as its purpose is to prevent costly rework proactively. It is ineffective for already deployed codebases requiring post-implementation code review rather than spec readiness evaluation.