# Repository Layout

> Repository Layout

- Skill: `goldziher/repository-layout` (Agent Skill)
- Install (CLI): `npx skillmds@latest add goldziher/repository-layout`
- Raw SKILL.md: https://api.skillmd.com/api/skills/goldziher/repository-layout/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: goldziher (https://skillmd.com/u/goldziher)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/goldziher/repository-layout

---


# Repository Layout

## Core Go CLI

- `cmd/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `migrate`, `mcp`, CRUD helpers).
- `internal/`: service packages for config loading, generator, templates, includes, CRUD, MCP, validator, logger, and migration.

## Multi-runtime Wrappers

- `release/npm` and `release/pypi`: JavaScript and Python entry points backed by the Go binary.
- `package.json` and `pyproject.toml`: publish metadata for npm and PyPI wrappers.
- Homebrew distribution is managed via a tap outside this repository.

## Documentation & Tooling

- `docs/`, `site/`, and `mkdocs.yaml`: user-facing documentation and site generation.
- `schema/`: JSON schemas for configuration and MCP files.
- `tests/`: fixtures, integration, e2e, and platform coverage.