diff --git a/scratchpad/agents/hierarchical-agents-quickstart.md b/scratchpad/agents/hierarchical-agents-quickstart.md index 0a1a2afc855..6ff42495594 100644 --- a/scratchpad/agents/hierarchical-agents-quickstart.md +++ b/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 diff --git a/scratchpad/dev.md b/scratchpad/dev.md index 8ec1b348169..24836832dbd 100644 --- a/scratchpad/dev.md +++ b/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). diff --git a/scratchpad/file-inlining.md b/scratchpad/file-inlining.md index 0ae0b73e6cd..837cbf3dc7d 100644 --- a/scratchpad/file-inlining.md +++ b/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`) diff --git a/scratchpad/firewall-log-parsing.md b/scratchpad/firewall-log-parsing.md index 78038c854ca..550e739704a 100644 --- a/scratchpad/firewall-log-parsing.md +++ b/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 diff --git a/scratchpad/gastown.md b/scratchpad/gastown.md index 7e0b7268dbf..68a9e8d25d2 100644 --- a/scratchpad/gastown.md +++ b/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