Perform code optimization and document cleanup (#1)

## Summary
- add repository-wide quality tooling and verification scaffolding, including CI workflows, pnpm workspace setup, ESLint/Prettier/markdown checks, and generated-output verification helpers
- reorganize skill sources and generation flow by introducing canonical `_source` variants, generator/manifests, reusable helper abstractions, and shared web-automation/browser utilities
- clean up and expand documentation so the root README flows into docs and skill docs, with clearer development, reviewer, installer, and workflow guidance

## Notable changes
- docs flow and consistency cleanup across `README.md`, `docs/README.md`, and related docs
- new scripts for `check`, docs verification, generated-file verification, shell portability, and safe directory replacement
- refactors in Atlassian and web-automation skill runtimes to reduce duplication and centralize reusable code
- changelog, development documentation, and CI surface updates

## Test Plan
- [ ] `pnpm run check`
- [ ] review generated/manifests and skill sync outputs
- [ ] smoke-check docs flow from `README.md` to `docs/README.md` to skill docs

## Notes
- this branch currently includes tracked `skills/web-automation/shared/node_modules` content that should be reviewed carefully as potentially noisy/accidental committed artifacts

Co-authored-by: Stefano Fiorini <stefano.fiorini@firsthorizon.com>
Reviewed-on: #1

skills/reviewer-runtime/tests/claude-review-template-guard.sh

@@ -31,6 +31,7 @@ check_skill_file() {
   local file=$1
 
   assert_contains "$file" "claude -p \\"
+  # shellcheck disable=SC2016
   assert_contains "$file" '$(cat /tmp/'
   assert_contains "$file" "--strict-mcp-config"
   assert_contains "$file" "--setting-sources user"

skills/reviewer-runtime/tests/smoke-test.sh

@@ -328,7 +328,9 @@ main() {
 
   local tmp_dir
   tmp_dir=$(mktemp -d)
-  trap "rm -rf '$tmp_dir'" EXIT
+  # Use SMOKE_TMP as a module-level var so the single-quoted trap expands lazily
+  SMOKE_TMP="$tmp_dir"
+  trap 'rm -rf "$SMOKE_TMP"' EXIT
 
   test_delayed_success "$tmp_dir"
   test_soft_timeout_continues "$tmp_dir"

skills/reviewer-runtime/tests/telegram-notify-test.sh

@@ -144,7 +144,9 @@ main() {
 
   local tmp_dir
   tmp_dir=$(mktemp -d)
-  trap "rm -rf '$tmp_dir'" EXIT
+  # Use TG_TEST_TMP as a module-level var so the single-quoted trap expands lazily
+  TG_TEST_TMP="$tmp_dir"
+  trap 'rm -rf "$TG_TEST_TMP"' EXIT
 
   test_missing_credentials "$tmp_dir"
   test_rejects_message_and_message_file_together "$tmp_dir"