Merge pull request #1382 from constructive-io/feat/restore-starter-kits-skill

feat(skills): restore constructive-starter-kits router; skip workflows on docs-only edits

Author: pyramation

.agents/skills/constructive-starter-kits.zip

@@ -0,0 +1,55 @@
+---
+name: constructive-starter-kits
+description: Scaffold new Constructive projects with pgpm init — workspace/module templates (PGPM and PNPM variants), the Next.js app boilerplate, custom template repositories, and boilerplate authoring. Use when asked to "create a new project", "scaffold a workspace", "scaffold a module", "create a starter kit", "start a boilerplate", "set up a Next.js app", "author a custom boilerplate template", "create a template repository", or "run pgpm init non-interactively in CI".
+compatibility: pgpm CLI, Node.js 22+
+metadata:
+  author: constructive-io
+  version: "1.0.0"
+---
+
+# Constructive Starter Kits
+
+Project scaffolding for Constructive, powered by `pgpm init` — create workspaces, modules, and full-stack apps from boilerplate templates, and author your own templates.
+
+This is a **thin router**. The authoritative content lives in the `pgpm` skill's project-scaffolding references (single source of truth — this skill only makes it discoverable under starter-kit/boilerplate/scaffold trigger phrases). Read the reference matching your task.
+
+## When to Apply
+
+Use this skill when:
+- Scaffolding a new workspace or module with `pgpm init`
+- Setting up a Constructive Next.js frontend application
+- Using custom template repositories (`--repo` / `--template`)
+- Authoring new boilerplate templates (`.boilerplate.json`)
+- Running non-interactive `pgpm init` for CI/CD
+
+## Quick Start
+
+```bash
+# Create a PGPM workspace + module
+pgpm init -w
+
+# Create a Next.js app from template
+pgpm init -w --repo constructive-io/sandbox-templates --template nextjs/constructive-app
+
+# Create a pure TypeScript (PNPM) workspace
+pgpm init workspace --dir pnpm
+```
+
+## Reference Guide
+
+All detailed content lives in the `pgpm` skill's references:
+
+| Reference | Topic | Consult When |
+|-----------|-------|--------------|
+| [../pgpm/references/starter-kits.md](../pgpm/references/starter-kits.md) | `pgpm init` templates and scaffolding | Creating new workspaces, modules, or Next.js apps; template matrix; non-interactive flags |
+| [../pgpm/references/nextjs-app.md](../pgpm/references/nextjs-app.md) | Constructive Next.js app boilerplate | Setting up the frontend app, project structure, auth flows, SDK generation |
+| [../pgpm/references/template-authoring.md](../pgpm/references/template-authoring.md) | Custom boilerplate authoring | Creating `.boilerplate.json`, placeholder system, question config, resolvers |
+| [../pgpm/references/cli.md](../pgpm/references/cli.md) | Full `pgpm init` flag reference | Looking up every init flag and option |
+| [../pgpm/references/workspace.md](../pgpm/references/workspace.md) | Workspace/module structure | Understanding what a scaffolded workspace/module contains |
+
+## Cross-References
+
+Related skills:
+- `pgpm` — Database migrations and module management (what you do after scaffolding); owns the references above
+- `constructive-cli` — Generated CLI commands and scaffolding
+- `constructive-setup` — Monorepo setup and local development environment

.agents/skills/constructive-starter-kits/SKILL.md

@@ -385,6 +385,7 @@ Consult these reference files for detailed documentation on specific topics:
 ## Cross-References
 
 Related skills:
+- `constructive-starter-kits` — Project scaffolding router (`pgpm init` templates, Next.js boilerplate, template authoring); surfaces the Project Scaffolding references above under starter-kit/boilerplate trigger phrases
 - `constructive-testing` — PostgreSQL testing patterns (RLS, seeding, snapshots, JWT context)
 - `constructive-setup` — Monorepo setup and local development environment
 - `constructive-cli` — Generated CLI commands and scaffolding

.agents/skills/pgpm.zip

@@ -6,6 +6,8 @@ on:
       - main
       - v1
       - release/*
+    paths-ignore:
+      - '**.md'
   workflow_dispatch: {}
 
 concurrency:

.agents/skills/pgpm/SKILL.md

@@ -5,6 +5,7 @@ on:
     paths:
       - 'examples/**'
       - 'graphql/codegen/**'
+      - '!**/*.md'
   workflow_dispatch:
 
 jobs:

.github/workflows/docker-constructive.yaml

@@ -6,6 +6,8 @@ name: Notify E2E Tests
 on:
   push:
     branches: [main]
+    paths-ignore:
+      - '**.md'
 
 jobs:
   trigger-tests:

.github/workflows/examples-integration.yaml

@@ -4,10 +4,14 @@ on:
     branches:
       - main
       - v1
+    paths-ignore:
+      - '**.md'
   pull_request:
     branches:
       - main
       - v1
+    paths-ignore:
+      - '**.md'
   workflow_dispatch:
   workflow_call:
 

.github/workflows/notify-e2e.yml

@@ -144,6 +144,7 @@ The `.agents/skills/` directory contains tooling-focused skills for this monorep
 | Skill | Description | When to Use |
 |-------|-------------|-------------|
 | `pgpm` | PostgreSQL Package Manager — migrations, CLI, Docker, CI/CD, project scaffolding, table creation rules, DB export | Database migrations, workspace/module creation, `pgpm init`, deploy/revert |
+| `constructive-starter-kits` | Project scaffolding router — `pgpm init` templates, Next.js app boilerplate, custom template repos, boilerplate authoring (routes to the `pgpm` skill's scaffolding references) | Creating a new project, scaffolding a workspace/module, starting a boilerplate, setting up a Next.js app, authoring templates |
 | `constructive-pnpm` | PNPM workspace management — monorepo config, dist-folder publishing with makage/lerna, dependency management | Configuring pnpm workspaces, publishing packages, managing monorepo dependencies |
 | `constructive-setup` | Monorepo setup — install dependencies, start PostgreSQL, bootstrap users, build, run tests, local email services | Setting up the development environment, local dev, full pipeline |
 | `constructive-testing` | PostgreSQL testing frameworks — pgsql-test, drizzle-orm-test, supabase-test | Writing database tests, testing RLS policies, seeding test data |