From fe98fccdeba838e4789b1a2628f42d3fbff72c71 Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Tue, 17 Mar 2026 22:31:41 +0000
Subject: [PATCH] feat: add build flow specs for 9 languages/tools
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

flows/git.md — commit workflow
flows/go.md — build, vet, test, tidy
flows/php.md — pint, phpstan, pest, audit
flows/ts.md — tsc, eslint, test, build
flows/cpp.md — cmake configure, build, test
flows/py.md — venv, ruff, pytest
flows/docker.md — build, smoke test, compose
flows/npm.md — lint, test, build, publish
flows/release.md — tag, push, artefacts, downstream deps

Each flow is a reminder of the standard build sequence for that stack.

Co-Authored-By: Virgil <virgil@lethean.io>
---
 pkg/prompts/lib/flows/cpp.md     | 6 ++++++
 pkg/prompts/lib/flows/docker.md  | 7 +++++++
 pkg/prompts/lib/flows/git.md     | 7 +++++++
 pkg/prompts/lib/flows/go.md      | 7 +++++++
 pkg/prompts/lib/flows/npm.md     | 8 ++++++++
 pkg/prompts/lib/flows/php.md     | 7 +++++++
 pkg/prompts/lib/flows/py.md      | 7 +++++++
 pkg/prompts/lib/flows/release.md | 9 +++++++++
 pkg/prompts/lib/flows/ts.md      | 7 +++++++
 9 files changed, 65 insertions(+)
 create mode 100644 pkg/prompts/lib/flows/cpp.md
 create mode 100644 pkg/prompts/lib/flows/docker.md
 create mode 100644 pkg/prompts/lib/flows/git.md
 create mode 100644 pkg/prompts/lib/flows/go.md
 create mode 100644 pkg/prompts/lib/flows/npm.md
 create mode 100644 pkg/prompts/lib/flows/php.md
 create mode 100644 pkg/prompts/lib/flows/py.md
 create mode 100644 pkg/prompts/lib/flows/release.md
 create mode 100644 pkg/prompts/lib/flows/ts.md

diff --git a/pkg/prompts/lib/flows/cpp.md b/pkg/prompts/lib/flows/cpp.md
new file mode 100644
index 0000000..2798dcd
--- /dev/null
+++ b/pkg/prompts/lib/flows/cpp.md
@@ -0,0 +1,6 @@
+# C++ Build Flow
+
+1. `cmake -B build -DCMAKE_BUILD_TYPE=Release` — configure
+2. `cmake --build build -j$(nproc)` — compile
+3. `ctest --test-dir build` — run tests
+4. `cmake --build build --target install` — install
diff --git a/pkg/prompts/lib/flows/docker.md b/pkg/prompts/lib/flows/docker.md
new file mode 100644
index 0000000..c74dea5
--- /dev/null
+++ b/pkg/prompts/lib/flows/docker.md
@@ -0,0 +1,7 @@
+# Docker Build Flow
+
+1. `docker build -t app:local .` — build image
+2. `docker run --rm app:local /bin/sh -c "echo ok"` — smoke test
+3. `docker compose up -d` — start services
+4. `docker compose ps` — verify health
+5. `docker compose logs --tail=20` — check logs
diff --git a/pkg/prompts/lib/flows/git.md b/pkg/prompts/lib/flows/git.md
new file mode 100644
index 0000000..19bf0f9
--- /dev/null
+++ b/pkg/prompts/lib/flows/git.md
@@ -0,0 +1,7 @@
+# Git Flow
+
+1. `git status` — check working tree
+2. `git diff --stat` — review changes
+3. `git add` — stage files (specific, not -A)
+4. `git commit -m "type(scope): description"` — conventional commit
+5. `git push origin main` — push to forge
diff --git a/pkg/prompts/lib/flows/go.md b/pkg/prompts/lib/flows/go.md
new file mode 100644
index 0000000..80c8c4f
--- /dev/null
+++ b/pkg/prompts/lib/flows/go.md
@@ -0,0 +1,7 @@
+# Go Build Flow
+
+1. `go build ./...` — compile all packages
+2. `go vet ./...` — static analysis
+3. `go test ./... -count=1 -timeout 120s` — run tests
+4. `go test -cover ./...` — check coverage
+5. `go mod tidy` — clean dependencies
diff --git a/pkg/prompts/lib/flows/npm.md b/pkg/prompts/lib/flows/npm.md
new file mode 100644
index 0000000..805e834
--- /dev/null
+++ b/pkg/prompts/lib/flows/npm.md
@@ -0,0 +1,8 @@
+# npm Package Flow
+
+1. `npm ci` — clean install
+2. `npm run lint` — lint
+3. `npm test` — tests
+4. `npm run build` — build
+5. `npm pack --dry-run` — verify package contents
+6. `npm publish` — publish (tag releases only)
diff --git a/pkg/prompts/lib/flows/php.md b/pkg/prompts/lib/flows/php.md
new file mode 100644
index 0000000..4253c0a
--- /dev/null
+++ b/pkg/prompts/lib/flows/php.md
@@ -0,0 +1,7 @@
+# PHP Build Flow
+
+1. `composer install --no-interaction` — install deps
+2. `./vendor/bin/pint --test` — check formatting (PSR-12)
+3. `./vendor/bin/phpstan analyse` — static analysis
+4. `./vendor/bin/pest --no-interaction` — run tests
+5. `composer audit` — security check
diff --git a/pkg/prompts/lib/flows/py.md b/pkg/prompts/lib/flows/py.md
new file mode 100644
index 0000000..284a7d2
--- /dev/null
+++ b/pkg/prompts/lib/flows/py.md
@@ -0,0 +1,7 @@
+# Python Build Flow
+
+1. `python -m venv .venv && source .venv/bin/activate` — virtualenv
+2. `pip install -e ".[dev]"` — install with dev deps
+3. `ruff check .` — lint
+4. `ruff format --check .` — format check
+5. `pytest` — run tests
diff --git a/pkg/prompts/lib/flows/release.md b/pkg/prompts/lib/flows/release.md
new file mode 100644
index 0000000..14e2764
--- /dev/null
+++ b/pkg/prompts/lib/flows/release.md
@@ -0,0 +1,9 @@
+# Release Flow
+
+1. Update version in source files
+2. Update CHANGELOG.md
+3. `git tag vX.Y.Z` — tag
+4. `git push origin main --tags` — push with tags
+5. Build release artefacts (platform-specific)
+6. Create Forge/GitHub release with artefacts
+7. Update downstream go.mod dependencies
diff --git a/pkg/prompts/lib/flows/ts.md b/pkg/prompts/lib/flows/ts.md
new file mode 100644
index 0000000..f0ab87b
--- /dev/null
+++ b/pkg/prompts/lib/flows/ts.md
@@ -0,0 +1,7 @@
+# TypeScript Build Flow
+
+1. `npm ci` — install deps (clean)
+2. `npx tsc --noEmit` — type check
+3. `npx eslint .` — lint
+4. `npm test` — run tests
+5. `npm run build` — production build