playbooks

home / skills / greyhaven-ai / claude-code-config / project-scaffolding

project-scaffolding skill

/grey-haven-plugins/core/skills/project-scaffolding

This skill helps you generate production-ready Grey Haven stack project scaffolds with best practices and configurable templates for rapid startup.

npx playbooks add skill greyhaven-ai/claude-code-config --skill project-scaffolding

Review the files below or copy the command above to add this skill to your agents.

Files (14)
SKILL.md
1.5 KB
---
name: grey-haven-project-scaffolding
description: "Generate production-ready project scaffolds for Grey Haven stack with Cloudflare Workers, React + TypeScript, Python + Pydantic, PlanetScale, proper structure, and configuration. Use when starting new projects, creating microservices, setting up monorepo workspaces, initializing projects, or when user mentions 'new project', 'project scaffold', 'project template', 'project setup', 'bootstrap project', 'project starter', or 'initialize project'."
# v2.0.43: Skills to auto-load for scaffolding
skills:
  - grey-haven-code-style
  - grey-haven-project-structure
  - grey-haven-database-conventions
# v2.0.74: Tools for project scaffolding
allowed-tools:
  - Read
  - Write
  - Bash
  - Glob
  - TodoWrite
---

# Project Scaffolding Skill

Generate production-ready project scaffolds for Grey Haven stack (Cloudflare Workers, React + TypeScript, Python + Pydantic, PlanetScale).

## Description

Rapid project initialization with best practices, proper structure, and configuration for Grey Haven technology stack.

## What's Included

- **Examples**: Full-stack app scaffolds, API-only projects, frontend templates
- **Reference**: Project structure conventions, configuration guides
- **Templates**: Project templates for different stacks
- **Checklists**: Scaffold verification, deployment readiness

## Use When

- Starting new projects
- Creating microservices
- Setting up monorepo workspaces

## Related Agents

- `project-scaffolder`

**Skill Version**: 1.0

Overview

This skill generates production-ready project scaffolds for the Grey Haven stack, combining Cloudflare Workers, React + TypeScript, Python + Pydantic, and PlanetScale. It produces opinionated directory layouts, configuration files, and deployment-ready scripts so teams can start building immediately. The scaffolds include frontend, backend, and infra pieces tuned for monorepos and microservices.

How this skill works

Provide a target project type (full-stack, API-only, frontend-only), optional monorepo layout, and preferences (database, deployment target, auth). The skill assembles templates: TypeScript React frontend, Python services with Pydantic models, Cloudflare Worker endpoints, PlanetScale schema and migration hints, plus CI/CD config and environment management. It validates scaffold rules and returns a checklist for verification and deployment readiness.

When to use it

  • Starting a new Grey Haven project from scratch
  • Bootstrapping a microservice with Cloudflare Workers and Python APIs
  • Initializing a monorepo workspace with shared libs and consistent configs
  • Creating a frontend + backend full-stack starter with TypeScript and Pydantic
  • Preparing a production-ready project template for team onboarding

Best practices

  • Choose the smallest viable scaffold and iterate: start API-only or frontend-only if unsure
  • Standardize environment variables and secrets management (development vs production)
  • Include type-safe contracts: OpenAPI or typed interfaces to sync frontend and backend
  • Add migrations and schema versioning for PlanetScale and test them in CI
  • Commit a verification checklist and minimal demo seed data with the scaffold

Example use cases

  • Generate a full-stack app: React + TypeScript frontend, Cloudflare Worker API, Python service for heavy logic, PlanetScale schema and migrations
  • Create an API-only microservice with Python + Pydantic, Cloudflare Workers as edge routers, and CI that deploys to Workers
  • Initialize a monorepo: shared components, backend packages, workspace tooling, and consistent lint/format configs
  • Bootstrap a frontend starter with Vite, TypeScript, Tailwind, and sample typed API calls wired to the Worker endpoint
  • Produce a production-ready starter that includes CI/CD pipelines, database migration hooks, and a deployment checklist

FAQ

Can I customize the scaffold templates?

Yes. Templates are opinionated but designed to be edited. You can swap frameworks, adjust configs, or remove components before committing.

Does the scaffold include CI/CD and deployment scripts?

Yes. It includes example CI workflows, deployment scripts for Cloudflare Workers, and guidelines to run PlanetScale migrations in CI.