sync-audit

Detect drift between backend routes and frontend API functions.

Updated Dec 14, 2025
One-click install
npx skills add https://github.com/toobutta/maptelli --skill sync-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-audit
Source: https://github.com/toobutta/maptelli/tree/main/.claude/skills/sync-audit
Command: npx skills add https://github.com/toobutta/maptelli --skill sync-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects structural drift between the Maptelli backend and frontend, ensuring routes, API functions, schemas, and task configurations stay in sync across releases.

Core Features & Use Cases

  • Cross-checks backend routes against frontend API calls
  • Schema alignment verification between Pydantic models and TypeScript interfaces
  • Celery beat schedule coherence and environment variable documentation

Quick Start

Run the audit after a feature-ship or release to verify alignment between backend and frontend code.

Frequently Asked Questions about sync-audit

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

FAQPage Schema
How do I detect API drift between frontend and backend codebases?

To detect API drift between frontend and backend codebases, analyze backend routes and frontend API calls to ensure structural alignment. This process cross-checks schemas, tasks, and environment variables to output an actionable report for release gating.

What is codebase drift and how does it affect schema alignment?

Codebase drift occurs when backend routes and frontend API functions fall out of sync, causing schema alignment issues. It identifies mismatches between Pydantic models and TypeScript interfaces to prevent integration failures across releases.

Can I use a codebase audit for pre-ship validation before a release?

Yes, you can use a codebase audit for pre-ship validation. By running the audit after a feature-ship, it verifies backend route and frontend API call alignment, producing a structured report suitable for release gating.

How do I verify Celery beat schedule coherence and environment variable documentation?

Verify Celery beat schedule coherence and environment variable documentation by analyzing the repository for task configurations and env docs. The audit checks this coherence alongside schema alignment to ensure full structural sync.

What's the best way to cross-check backend routes against frontend API calls?

The best way to cross-check backend routes against frontend API calls is running a structural drift audit. It analyzes both codebases across the repository, identifying mismatches in routes, schemas, and tasks to generate an actionable report.