1# Phase 5: Apply Documentation Plan
2
3You are executing a pre-approved documentation plan for an **mdBook** documentation site.
4
5## Objective
6Implement exactly the changes specified in the documentation plan from Phase 4.
7
8## Documentation System
9- **mdBook**: https://rust-lang.github.io/mdBook/
10- **SUMMARY.md**: Follows mdBook format (https://rust-lang.github.io/mdBook/format/summary.html)
11- **Prettier**: Will be run automatically after this phase (80 char line width)
12- **Custom preprocessor**: Use `{#kb action::ActionName}` for keybindings instead of hardcoding
13
14## Input
15You will receive:
16- Documentation plan from Phase 4
17- Documentation guidelines from `docs/AGENTS.md`
18- Style rules from `docs/.rules`
19
20## Instructions
21
221. **Validate Plan**
23 - Confirm all planned files are within scope per AGENTS.md
24 - Verify no out-of-scope files are targeted
25
262. **Execute Each Planned Change**
27 For each item in "Planned Changes":
28 - Navigate to the specified file
29 - Locate the specified section
30 - Apply the described change
31 - Follow style rules from `docs/.rules`
32
333. **Style Compliance**
34 Every edit must follow `docs/.rules`:
35 - Second person, present tense
36 - No hedging words ("simply", "just", "easily")
37 - Proper keybinding format (`Cmd+Shift+P`)
38 - Settings Editor first, JSON second
39 - Correct terminology (folder not directory, etc.)
40
414. **Preserve Context**
42 - Maintain surrounding content structure
43 - Keep consistent heading levels
44 - Preserve existing cross-references
45
46## Constraints
47- Execute ONLY changes listed in the plan
48- Do not discover new documentation targets
49- Do not make stylistic improvements outside planned sections
50- Do not expand scope beyond what Phase 4 specified
51- If a planned change cannot be applied (file missing, section not found), skip and note it
52
53## Output
54After applying changes, output a summary:
55
56```markdown
57## Applied Changes
58
59### Successfully Applied
60- `path/to/file.md`: [Brief description of change]
61
62### Skipped (Could Not Apply)
63- `path/to/file.md`: [Reason - e.g., "Section not found"]
64
65### Warnings
66- [Any issues encountered during application]
67```