skill-projectos-monorepo

name	SKILL-projectos-monorepo
description	Contract-first, LLM-optimized monorepo scaffold Use when: (1) calling its 64 API functions, (2) configuring projectos-monorepo, (3) understanding its 62 type definitions, (4) working with its 1 classes, (5) user mentions "projectos-monorepo" or asks about its API.

projectos-monorepo

Contract-first, LLM-optimized monorepo scaffold

Quick Start

npm install projectos-monorepo

const paths = resolveAppPaths('myapp');
console.log(paths.data); // ~/.local/share/myapp

API

Function	Description
createFileWriter()	Create a FileWriter rooted at rootDir.
capitalize()
entityName()	Derive singular entity name from a domain name (e.g., "thoughts" - "Thought").
schemaFileName()	Derive schema filename from domain (e.g., "thoughts" - "thought").
generateDomainSchema()	Generate a Zod schema file + barrel for a domain. Produces: domain/entity.schema.ts and domain/index.ts
generateContractsIndex()	Generate the contracts barrel index that re-exports all domains.
generatePackage()	Generate a workspace package (package.json + tsconfig.json).
generateRouteFile()	Generate a Hono CRUD route file backed by Drizzle.
generateApiEntry()	Generate the Hono API entry point.
generateRootConfigs()	Generate all root config files (tsconfig, turbo, biome, gitignore, etc).
generateAgentsMd()	Generate AGENTS.md with full project documentation.
generateManifest()	Generate the LLM-readable project manifest.
generateDatabasePackage()	Generate the full database package with Drizzle ORM + SQLite.
generateFrontendPackage()	Generate a full SvelteKit 5 + DaisyUI frontend package.
resolveAppPaths()	Resolve platform-specific application paths for the given app name.
...	49 more — see API reference

Configuration

import type { ConfigOptions } from "projectos-monorepo";

const config: Partial<ConfigOptions> = {
  // The configuration namespace name, used to derive the default env prefix.
  name: "...",
  // The Zod schema used to validate the merged configuration.
  schema: { /* ... */ },
  // Default values to use when environment variables are not set.
  defaults: { /* ... */ },
  // The prefix for environment variable names (e.g. `'APP'` maps `dbHost` to `APP_DB_HOST`).
  envPrefix: "...",
  // A custom environment variable source to read from instead of `process.env`.
  env: { /* ... */ },
};

See references/CONFIGURATION.md for full details.

Key Types

• FileWriter — Tracked file writer that creates parent dirs and records all written paths.
• AppPaths — XDG-compliant application filesystem paths.
• ShutdownHandler — Async callback invoked when a termination signal is received.
• PidManager — Manages a PID file to ensure single-instance daemon execution.
• ShutdownStep — A named cleanup step executed during graceful shutdown.
• ShutdownController — Orchestrates an ordered sequence of shutdown steps.
• ServiceContext — Runtime context provided to each service during initialization.
• ServiceCommand — A command exposed by a service for remote invocation via the transport layer.
• Service — Lifecycle interface for a managed daemon service.
• ServiceRegistry — Central registry for managing service lifecycle, routing, and health reporting.

References

• references/CONFIGURATION.md — Full config options
• references/API-REFERENCE.md — Signatures, parameters, examples