feat(atlassian): implement milestone M4 - packaging and doc sync

docs/ATLASSIAN.md

@@ -8,6 +8,12 @@ Provide a portable Atlassian Cloud skill for Codex, Claude Code, Cursor Agent, a
 
 The repo targets multiple agent environments with uneven MCP availability. This skill packages a consistent CLI contract so the same task-oriented workflows can be used across all supported agents without depending on MCP-specific integrations.
 
+The canonical runtime lives in `skills/atlassian/shared/scripts/`. Installable per-agent `scripts/` bundles are generated from that source with:
+
+```bash
+pnpm --dir skills/atlassian/shared/scripts sync:agents
+```
+
 ## Requirements
 
 - Node.js 20+
@@ -42,6 +48,15 @@ Optional:
 - `conf-children`
 - `raw`
 
+## Command Notes
+
+- `health` validates local configuration and shows the resolved Jira and Confluence base URLs.
+- `jira-create` requires `--type`, `--summary`, and either `--project` or `ATLASSIAN_DEFAULT_PROJECT`.
+- `jira-update` requires `--issue` and at least one of `--summary` or `--description-file`.
+- `conf-create` requires `--title`, `--body-file`, and either `--space` or `ATLASSIAN_DEFAULT_SPACE`.
+- `conf-update` requires `--page`, `--title`, and `--body-file`; it fetches the current page version before building the update payload.
+- `raw --body-file` expects a workspace-scoped JSON file and is limited to validated Atlassian API prefixes.
+
 ## Safety Model
 
 - Default output is JSON.
@@ -120,12 +135,19 @@ pnpm atlassian health
   - `pnpm atlassian jira-get --issue ENG-123`
 - Dry-run a Jira comment:
   - `pnpm atlassian jira-comment --issue ENG-123 --body-file comment.md --dry-run`
+- Dry-run a Jira issue create with default project fallback:
+  - `pnpm atlassian jira-create --type Story --summary "Add Atlassian skill" --description-file story.md --dry-run`
 - Search Confluence pages:
-  - `pnpm atlassian conf-search --query "title ~ \\\"Runbook\\\""`
+  - `pnpm atlassian conf-search --query "title ~ \\\"Runbook\\\"" --max-results 10 --start-at 0`
+- Inspect a Confluence page:
+  - `pnpm atlassian conf-get --page 12345`
 - Dry-run a Confluence page update:
   - `pnpm atlassian conf-update --page 12345 --title "Runbook" --body-file page.storage.html --dry-run`
+- Dry-run a Confluence footer comment:
+  - `pnpm atlassian conf-comment --page 12345 --body-file comment.storage.html --dry-run`
 - Use bounded raw mode:
   - `pnpm atlassian raw --product jira --method GET --path "/rest/api/3/issue/ENG-123"`
+  - `pnpm atlassian raw --product confluence --method POST --path "/wiki/api/v2/pages" --body-file page.json --dry-run`
 
 ## Scope Notes