cf-review-custom · git:20261108.a59c85b · 2026-11-08 · sha256 712f796fd7b8ae4d

cf-review-custom git:20261108.a59c85bC

Immutable. This exact content never changes and is served at /api/v1/blob/712f796fd7b8ae4d.

## After

After the standard review completes, check if any changed files require documentation updates.

### Step A1: Identify implementation changes that need doc sync

From the files already reviewed in this session, filter for changes in these source directories:

| Source path pattern             | Documentation target (single-page site `website/src/content/index.md`) |
| ------------------------------- | ---------------------------------------------------------------------- |
| `plugin/skills/{name}/SKILL.md` | the `{name}` bullet under "✨ Features"                                |
| `plugin/agents/{name}.md`       | the "🧭 Agents" section                                                |
| `cli/src/commands/{name}.ts`    | every mention of `cf {name}` (there is no CLI section)                 |

Only consider files that were actually changed in this conversation's diff — do NOT scan the entire codebase.

If no implementation files match the patterns above, skip the remaining steps and end with: "No doc-sync needed."

### Step A2: Compare changes against documentation

For each matched implementation file:

1. Read the implementation file to understand what changed (use the diff from the review, not the entire file)
2. Read the corresponding section of `website/src/content/index.md`
3. Check whether the documentation already reflects the changes — look for:
   - New or renamed workflow steps, flags, arguments
   - Changed behavior, conditions, or modes
   - Added or removed features, options, or commands
   - Updated agent metadata (model, tools, description)

### Step A3: Report doc-sync findings

Append a **Doc Sync** section to the review report:

```
### 📄 Doc Sync

| Source | Doc | Status |
|---|---|---|
| `plugin/skills/cf-ask/SKILL.md` | `index.md` › Features › `/cf-ask` | Out of date — missing new `--verbose` flag |
| `plugin/agents/cf-explorer.md` | `index.md` › Agents | Up to date |

**Action needed:** <list specific updates required, or "None — all docs are in sync">
```

If updates are needed, ask the user whether to apply them now or leave as a reminder.

## Rules

- Only check documentation for files that were changed in the current conversation — never do a full-repo audit.
- Do not rewrite the whole page. Only update the specific sections that drifted from the implementation.
- Preserve the existing documentation style, frontmatter, and structure when making updates.
- If `index.md` has no entry for a new implementation file, flag it as "Missing doc" rather than adding one automatically.