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

package.json

@@ -27,22 +27,34 @@
     "docs/PI-SUPERPOWERS.md",
     "docs/PI-COMMON-REVIEWER.md",
     "docs/WEB-AUTOMATION.md",
+    "docs/DEVELOPMENT.md",
+    "docs/REVIEWERS.md",
     "pi-package/skills",
     "skills/reviewer-runtime/pi",
     "scripts/install-pi-package.sh",
     "scripts/lib/skill-manager-core.mjs",
     "scripts/manage-skills.mjs",
     "scripts/manage-skills.sh",
-    "scripts/sync-pi-package-skills.sh",
+    "CHANGELOG.md",
+    "scripts/generate-skills.mjs",
     "scripts/verify-pi-resources.sh",
     "scripts/verify-pi-workflows.sh",
     "scripts/verify-reviewer-support.sh"
   ],
   "scripts": {
-    "sync:pi": "./scripts/sync-pi-package-skills.sh",
+    "sync:pi": "node scripts/generate-skills.mjs",
     "verify:pi": "./scripts/verify-pi-resources.sh && ./scripts/verify-pi-workflows.sh",
     "verify:reviewers": "./scripts/verify-reviewer-support.sh",
-    "test:installer": "node --test scripts/tests/*.test.mjs"
+    "test:installer": "node --test scripts/tests/*.test.mjs",
+    "lint": "eslint . ; R1=$?; node scripts/lib/run-shellcheck.mjs ; R2=$?; [ $((R1+R2)) -eq 0 ]",
+    "lint:fix": "eslint . --fix && prettier --write .",
+    "typecheck": "pnpm run -r --if-present typecheck",
+    "test": "pnpm run test:installer && pnpm run -r --if-present test",
+    "verify:docs": "markdownlint-cli2 ; R1=$?; node scripts/lib/run-link-check.mjs ; R2=$?; node scripts/verify-docs-flow.mjs ; R3=$?; [ $((R1+R2+R3)) -eq 0 ]",
+    "verify:docs:online": "markdownlint-cli2 ; R1=$?; node scripts/lib/run-link-check.mjs --online ; R2=$?; node scripts/verify-docs-flow.mjs ; R3=$?; [ $((R1+R2+R3)) -eq 0 ]",
+    "verify:generated": "node scripts/verify-generated.mjs",
+    "verify:ci": "node scripts/lib/assert-no-pnpm-version-pin.mjs",
+    "check": "node scripts/lib/run-check.mjs"
   },
   "pi": {
     "skills": [
@@ -53,5 +65,13 @@
       "./pi-package/skills/web-automation"
     ]
   },
-  "packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34"
+  "packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34",
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "eslint": "10.3.0",
+    "globals": "17.6.0",
+    "markdown-link-check": "3.14.2",
+    "markdownlint-cli2": "0.22.1",
+    "prettier": "3.8.3"
+  }
 }