chravel-architecture-audit

Audit ChravelApp architecture for module integrity, data access, and critical flows.

2|1|Updated Jun 21, 2025
One-click install
npx skills add https://github.com/MeechYourGoals/Chravel --skill chravel-architecture-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chravel-architecture-audit
Source: https://github.com/MeechYourGoals/Chravel/tree/main/.claude/skills/chravel-architecture-audit
Command: npx skills add https://github.com/MeechYourGoals/Chravel --skill chravel-architecture-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the need for a structured and thorough audit of the ChravelApp's architecture, identifying potential issues like boundary violations, layering problems, and technical debt.

Core Features & Use Cases

  • Feature Module Integrity Check: Assesses if features are self-contained and properly organized.
  • Data Access Pattern Analysis: Reviews how data is accessed, particularly Supabase queries and state management.
  • Page/Component Separation Audit: Examines the division of responsibilities between pages and components.
  • Type Architecture Review: Checks for consistent and well-defined type definitions.
  • Critical Path Assessment: Evaluates the architecture of key user flows like trip loading, chat, payments, and AI integration.
  • Use Case: Before planning a major new feature, use this Skill to understand the existing architecture, identify potential refactoring needs, and ensure the new feature integrates cleanly.

Quick Start

Use the chravel-architecture-audit skill to perform a comprehensive audit of the ChravelApp's current structure.

Frequently Asked Questions about chravel-architecture-audit

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

FAQPage Schema
How do I audit feature module integrity and check for architectural boundary violations?

To audit feature module integrity, you assess whether features are self-contained and properly organized to detect boundary violations and layering problems. This structural review ensures modules maintain strict separation of concerns across the codebase.

What is the best way to review data access patterns and Supabase queries for technical debt?

Reviewing data access patterns involves analyzing how Supabase queries and state management are implemented to identify structural technical debt. This process exposes inefficient data retrieval layers and improper state handling within your application.

How do I evaluate page and component separation to prevent layering problems in my application?

Evaluating page and component separation requires examining the division of responsibilities between page-level logic and UI components. This architectural audit identifies structural layering problems and ensures clean separation of concerns across the view layer.

Can I use an architecture audit to plan new feature development for critical user flows?

Yes, an architecture audit is applicable for planning new feature development by evaluating critical path flows like trip loading, chat, and payments. It helps assess technical health and ensures new features integrate cleanly without increasing structural debt.

When do I need a type architecture review for my application's codebase?

You need a type architecture review when checking for consistent and well-defined type definitions across your application's codebase. This audit identifies type inconsistencies that cause integration issues and compound technical debt during feature expansion.