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.