feat: add build flow specs for 9 languages/tools

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

@@ -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

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

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

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

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)

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

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

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

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