phase5-apply.md

 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```