[docs] docs: tone scan v8.0 — fix 4 marketing terms across 4 spec files

scratchpad/agents/hierarchical-agents-quickstart.md

@@ -207,7 +207,7 @@ Issues are tagged with priority:
 - **P0 (Critical):** Fix immediately - system broken
 - **P1 (High):** Fix within 1-2 days - significant impact
 - **P2 (Medium):** Fix within 1-2 weeks - quality improvement
-- **P3 (Low):** Fix when convenient - nice to have
+- **P3 (Low):** Fix when capacity allows — non-blocking
 
 ### Common Labels
 

scratchpad/dev.md

@@ -1,7 +1,7 @@
 # Developer Instructions
 
-**Version**: 7.0
-**Last Updated**: 2026-04-24
+**Version**: 8.0
+**Last Updated**: 2026-04-25
 **Purpose**: Consolidated development guidelines for GitHub Agentic Workflows
 
 This document consolidates specifications from the scratchpad directory into unified developer instructions. It provides architecture patterns, security guidelines, code organization rules, and testing practices.
@@ -2932,6 +2932,7 @@ These files are loaded automatically by compatible AI tools (e.g., GitHub Copilo
 ---
 
 **Document History**:
+- v8.0 (2026-04-25): Maintenance tone scan — fixed 4 tone issues across 4 spec files: `file-inlining.md` (1 fix: "Smart email address filtering"→"Email address detection"), `firewall-log-parsing.md` (1 fix: "**Smart caching:**"→"**Result caching:**"), `gastown.md` (1 fix: "**Best of Both Worlds**:"→"**Combining both systems**:"), `agents/hierarchical-agents-quickstart.md` (1 fix: "nice to have"→"non-blocking"). Coverage: 64 spec files (no new files).
 - v7.0 (2026-04-24): Maintenance tone scan — fixed 1 tone issue: `mcp_logs_guardrails.md` (1 fix: "Add more sophisticated query suggestions"→"Add context-aware query suggestions"). Coverage: 64 spec files (no new files).
 - v6.9 (2026-04-23): Maintenance tone scan — fixed 1 tone issue: `agents/hierarchical-agents-quickstart.md` (1 fix: "helps you quickly understand and use"→"explains...and their operational usage"). Coverage: 64 spec files (no new files).
 - v6.8 (2026-04-22): Maintenance tone scan — 0 tone issues found. Documented 4 new features from pending changesets: (1) `label_command` trigger with `status-comment: true` and `reaction: eyes` defaults; (2) GHE support via `configure_gh_for_ghe.sh`; (3) `gh aw audit diff` and `gh aw audit report` commands added to CLI quick reference and Command Categories; (4) container image pinning by digest (PR #27762: `ContainerPin` struct in `pkg/actionpins`, compiler resolves mutable tags to immutable SHA-256 digests). Coverage: 64 spec files (no new files).

scratchpad/file-inlining.md

@@ -21,7 +21,7 @@ The feature reuses and extends the existing `runtime_import.cjs` infrastructure:
    - Supports `.github/` prefix trimming (both `file.md` and `.github/file.md` work)
    - Supports line range extraction (1-indexed, inclusive)
    - Applies content sanitization (front matter removal, XML comment stripping, macro detection)
-   - Smart email address filtering to avoid processing `user@example.com`
+   - Email address detection to avoid processing `user@example.com`
    - **Security:** Validates all paths stay within `.github` folder
 
 2. **URL Processing** (`processUrlImport`)

scratchpad/firewall-log-parsing.md

@@ -200,7 +200,7 @@ The `audit` command now automatically:
 
 - **Minimal overhead:** Parser only runs when firewall logs are present
 - **Efficient parsing:** Single-pass scanning with buffered I/O
-- **Smart caching:** Results cached in `run_summary.json`
+- **Result caching:** Results cached in `run_summary.json`
 - **Concurrent processing:** Runs are processed in parallel
 
 ## Testing

scratchpad/gastown.md

@@ -936,7 +936,7 @@ Based on Gastown's proven patterns, here are recommended enhancements for gh-aw:
 
 ### Hybrid Approach
 
-**Best of Both Worlds**:
+**Combining both systems**:
 - Use gh-aw for GitHub-facing automation and CI/CD
 - Use Gastown (with beads) for local multi-agent development
 - Bridge with gh-aw workflows that sync with beads state