# Monorepo Structure

> Monorepo structure and package organization

- Skill: `majiayu000/monorepo-structure-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/monorepo-structure-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/monorepo-structure-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/monorepo-structure-3

---


# Repository Structure Rules

## Monorepo Organization

This is a monorepo for API client modules.

### Module Structure
```
package/
└── {vendor}/
    └── {module}/
        ├── api.yml
        ├── connectionProfile.yml
        ├── connectionState.yml
        ├── src/
        ├── test/
        └── package.json
```

### Types Repository (Optional)
- **Location**: `/types/` submodule
- **Contents**:
  - `types-core` - Core definitions
  - `types-{vendor}` - Vendor types
  - `types-core-{lang}` - Language-specific core
  - `types-{vendor}-{lang}` - Language-specific vendor

## File Paths

- Always use absolute paths
- Get root with `pwd` command
- Never use relative imports across modules
- Respect module boundaries

## Dependencies

- Each module is independent
- Share only through types repository
- No cross-module imports
- Version everything properly