Installs into .claude/skills of the current project.
Are you the author of Layout Explainer?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/goldziher-layout-explainer)
---
name: layout-explainer
description: "Explain this project's directory layout. Use when asked where code lives; not for build instructions."
---
# Repository Layout
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 1
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 2
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 3
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 4
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 5
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 6
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
## Background 7
## Core Go CLI
- `cmd/ai-rulez/main.go`: boots the CLI and injects the version string.
- `cmd/commands/`: Cobra command implementations (`generate`, `validate`, `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.
