project-architecture

Document monorepo architecture with HTTP-only service communication and shared Supabase database management.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/MuhamadTAH/Pird --skill project-architecture-muhamadtah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-architecture
Source: https://github.com/MuhamadTAH/Pird/tree/main/.claude/skills/project-architecture
Command: npx skills add https://github.com/MuhamadTAH/Pird --skill project-architecture-muhamadtah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide to the project's architecture, ensuring clear structure and efficient communication between services.

Core Features & Use Cases

  • Project Overview: Describes the project structure, services, and their deployment locations.
  • Domain Split: Defines two main domains for customer-facing and operations interfaces.
  • HTTP-Only Communication: Enforces service communication via HTTP only, promoting scalability.
  • Shared Database: Outlines the use of a single Supabase project with table ownership by services.
  • Service Best Practices: Establishes conventions for service READMEs, environment variable management, and migration handling.

Quick Start

Consult the project-architecture skill to understand the project structure and inter-service communication patterns before developing a new service.

Frequently Asked Questions about project-architecture

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

FAQPage Schema
How do I structure a monorepo project with multiple services?

To structure a monorepo project, define a clear overview of services and their deployment locations, split domains for customer-facing and operations interfaces, and establish conventions for service READMEs and environment variable management.

What is the best way to handle inter-service communication in a scalable architecture?

The best way to handle inter-service communication is by enforcing HTTP-only communication between services, which promotes scalability and ensures clear, efficient data exchange across the monorepo architecture.

How does shared database management work in a multi-service monorepo?

Shared database management uses a single Supabase project where individual services maintain ownership of specific tables, ensuring structured data access while enforcing strict migration handling practices.

Can I use a single Supabase project for multiple backend services?

Yes, you can use a single Supabase project for multiple backend services by assigning table ownership to individual services, which maintains clear boundaries and enforces strict database management practices.

What conventions do I need to follow when adding a new service to the monorepo?

When adding a new service, you must follow established best practices including creating service READMEs, managing environment variables correctly, handling database migrations, and enforcing HTTP-only communication protocols.

Why does a monorepo architecture split customer-facing and operations domains?

A monorepo architecture splits customer-facing and operations domains to ensure a clear project structure, allowing distinct interfaces to be developed, deployed, and scaled independently while maintaining shared database practices.