diff --git a/docs/configuration.md b/docs/configuration.md
index 6d8a899..1599b02 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -46,6 +46,8 @@ defaults:
 | `build.test_command` | string | auto-detect | Override test command. `{{file}}` is replaced with the test file path |
 | `build.default_branch` | string | `main` | Default branch for git operations |
 | `test_runner_skill` | string | — | Name of a custom test runner skill in `~/.claude/skills/` (advanced — for complex test workflows) |
+| `watch_pr.auto_fix_ci` | bool | `true` | Auto-fix CI failures detected by `/pilot-watch-pr` |
+| `watch_pr.auto_fix_comments` | bool | `false` | Auto-fix review comments detected by `/pilot-watch-pr` |
 
 ### Preset Configs
 
@@ -91,6 +93,22 @@ Location: `~/.claude/settings.json`
 
 Add project-specific permissions as needed (e.g., `Bash(mvn *)` for Java projects).
 
+## Updating / Syncing
+
+Dev Pilot is actively maintained. When the upstream repo has new commands, agents, or features, sync them to your local `~/.claude/` with:
+
+```bash
+cd dev-pilot && git pull
+node init.js --config ~/.claude/pilot.yaml --force
+```
+
+| Flag | What it does |
+|------|-------------|
+| `--config ~/.claude/pilot.yaml` | Reuses your existing configuration instead of prompting for setup |
+| `--force` | Overwrites framework files (commands, agents) with the latest versions |
+
+> **Note:** `--force` alone (without `--config`) will trigger the interactive setup wizard and create a new `pilot.yaml`, overwriting your existing one. Always pair `--force` with `--config` to preserve your configuration.
+
 ## Environment Variables
 
 The dashboard and lib modules also read these environment variables:
diff --git a/framework/commands/claude/pilot-watch-pr.md b/framework/commands/claude/pilot-watch-pr.md
index 51c758c..6d992e9 100644
--- a/framework/commands/claude/pilot-watch-pr.md
+++ b/framework/commands/claude/pilot-watch-pr.md
@@ -90,7 +90,7 @@ az repos pr list \
 
 #### Fetch unresolved review threads (GitHub only):
 
-For each PR with `reviewDecision` of `CHANGES_REQUESTED` or `REVIEW_REQUIRED`:
+For each PR with `reviewDecision` of `CHANGES_REQUESTED`, `REVIEW_REQUIRED`, or `COMMENTED`:
 ```bash
 gh api graphql -f query='
 query($owner:String!,$repo:String!,$number:Int!) {
diff --git a/framework/commands/copilot/pilot-watch-pr.md b/framework/commands/copilot/pilot-watch-pr.md
index 30c594e..fc6efc8 100644
--- a/framework/commands/copilot/pilot-watch-pr.md
+++ b/framework/commands/copilot/pilot-watch-pr.md
@@ -84,7 +84,7 @@ az repos pr list \
 
 #### Fetch unresolved review threads (GitHub only):
 
-For each PR that has `reviewDecision` of `CHANGES_REQUESTED` or `REVIEW_REQUIRED`:
+For each PR that has `reviewDecision` of `CHANGES_REQUESTED`, `REVIEW_REQUIRED`, or `COMMENTED`:
 ```bash
 gh api graphql -f query='
 query($owner:String!,$repo:String!,$number:Int!) {
diff --git a/pilot.yaml.template b/pilot.yaml.template
index 97b5a07..4ffdb5c 100644
--- a/pilot.yaml.template
+++ b/pilot.yaml.template
@@ -52,3 +52,8 @@ defaults:
 # (e.g., cross-repo builds, manual verification scenarios).
 # If omitted, /pilot-dev-issue uses inline build/test with auto-detection.
 # test_runner_skill: my-custom-test-runner
+
+# PR monitoring settings (used by /pilot-watch-pr)
+# watch_pr:
+#   auto_fix_ci: true            # default: true — auto-fix CI failures
+#   auto_fix_comments: false     # default: false — auto-fix review comments