monorepo-spec-kit-structure

Define a consistent monorepo layout with Spec-Kit config and layered CLAUDE.md files.

1|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/mub7865/Hackathone-2 --skill monorepo-spec-kit-structure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monorepo-spec-kit-structure
Source: https://github.com/mub7865/Hackathone-2/tree/main/.claude/skills/monorepo-spec-kit-structure
Command: npx skills add https://github.com/mub7865/Hackathone-2 --skill monorepo-spec-kit-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes monorepo structure and Spec-Kit usage so AI-driven projects can locate specs, code, and guidance without guesswork.

Core Features & Use Cases

  • Clear top-level layout guidance: /.spec-kit, /specs, /frontend, /backend, and optional /infra.
  • Organize specs under /specs with subfolders (overview, architecture, features, api, database, ui, infra) and keep .spec-kit/config.yaml in sync.
  • Layer CLAUDE.md at root, frontend, and backend to avoid conflicts; provides templates and examples for adoption.

Quick Start

Organize your repository into a spec-driven monorepo by creating /.spec-kit, /specs (with standard subfolders), /frontend, /backend, and optional /infra, and add layered CLAUDE.md files per layer.

Frequently Asked Questions about monorepo-spec-kit-structure

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

FAQPage Schema
How do I structure a monorepo for spec-driven AI development?

The monorepo layout uses /.spec-kit, /specs, /frontend, and /backend at the top level. Specs are organized into subfolders like architecture, features, and api, ensuring the folder structure aligns with your .spec-kit/config.yaml configuration.

What is the best way to organize specs in a monorepo using Spec-Kit?

Organize specs in a /specs directory with standard subfolders such as overview, architecture, features, api, database, ui, and infra. You must keep this folder structure synchronized with your .spec-kit/config.yaml file to maintain alignment.

How do I layer CLAUDE.md files across frontend and backend directories?

Layer CLAUDE.md files by placing them at the repository root, and separately inside the /frontend and /backend directories. This layering prevents guidance conflicts and provides context-specific instructions for each application layer.

Does Spec-Kit require a specific folder layout for the specs directory?

Spec-Kit expects the specs directory to contain standard subfolders including overview, architecture, features, api, database, ui, and infra. The layout must align with the .spec-kit/config.yaml file to ensure correct spec placement and retrieval.

When do I need an /infra folder in a spec-driven monorepo?

An /infra folder is optional in a spec-driven monorepo layout. You add it when your project requires dedicated infrastructure-as-code or deployment configurations to be stored alongside your frontend, backend, and specs directories.