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

.markdownlint-cli2.jsonc

@@ -0,0 +1,40 @@
+// markdownlint-cli2 configuration — ai-coding-skills (M2)
+//
+// This file controls which files are linted and which are ignored.
+// The markdownlint *rules* are configured in .markdownlint.jsonc (root) and
+// skills/.markdownlint.jsonc (agent-facing skill files).
+//
+// Scope: README.md, docs/, and canonical SKILL.md files.
+// Excluded: all node_modules, generated agent-variant directories, pi-package.
+{
+  // Glob patterns for which files to lint
+  "globs": [
+    "README.md",
+    "docs/**/*.md",
+    // Canonical skill files only — agent variants are excluded below
+    "skills/atlassian/shared/**/*.md",
+    "skills/create-plan/**/*.md",
+    "skills/do-task/**/*.md",
+    "skills/implement-plan/**/*.md",
+    "skills/reviewer-runtime/**/*.md",
+    "skills/web-automation/codex/**/*.md",
+    "skills/web-automation/pi/**/*.md",
+    "skills/web-automation/claude-code/SKILL.md",
+    "skills/web-automation/cursor/SKILL.md",
+    "skills/web-automation/opencode/SKILL.md",
+    "skills/atlassian/codex/SKILL.md",
+    "skills/atlassian/claude-code/SKILL.md",
+    "skills/atlassian/cursor/SKILL.md",
+    "skills/atlassian/opencode/SKILL.md",
+    "skills/atlassian/pi/SKILL.md"
+  ],
+
+  // Ignore patterns — always exclude node_modules, generated artefacts, and canonical _source dirs
+  "ignores": [
+    "**/node_modules/**",
+    "pi-package/**",
+    // Canonical source directories — contain per-agent source with relative links
+    // calibrated to their generated location (one level up); exclude from linting.
+    "skills/**/_source/**"
+  ]
+}