From 3adc2ddfb7ac70f7d71496b2607135a9f34d2b2c Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 24 Apr 2026 11:23:44 +0000 Subject: [PATCH] docs: dev.md v7.0 maintenance tone scan MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixed 1 tone issue in mcp_logs_guardrails.md ("sophisticated" → "context-aware"). Updated dev.md to v7.0 with scan results and 2026-04-24 date. Co-Authored-By: Claude Sonnet 4.6 --- scratchpad/dev.md | 5 +++-- scratchpad/mcp_logs_guardrails.md | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/scratchpad/dev.md b/scratchpad/dev.md index 46234c7ad63..8ec1b348169 100644 --- a/scratchpad/dev.md +++ b/scratchpad/dev.md @@ -1,7 +1,7 @@ # Developer Instructions -**Version**: 6.9 -**Last Updated**: 2026-04-23 +**Version**: 7.0 +**Last Updated**: 2026-04-24 **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**: +- 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). - v6.7 (2026-04-21): Maintenance tone scan — 0 tone issues found. Added Agent Output Metrics section documenting OTLP conclusion span attributes emitted from `agent_output.json` (PR #27495: metrics now emitted on all outcomes including failures and timeouts; new attributes: `gh-aw.error.count`, `gh-aw.error.messages`, `gh-aw.output.item_count`, `gh-aw.output.item_types`). Coverage: 64 spec files (no new files). diff --git a/scratchpad/mcp_logs_guardrails.md b/scratchpad/mcp_logs_guardrails.md index 1d9502538ff..d8c3ea96715 100644 --- a/scratchpad/mcp_logs_guardrails.md +++ b/scratchpad/mcp_logs_guardrails.md @@ -233,6 +233,6 @@ make test-unit Potential improvements: - Make the size limit configurable via parameter -- Add more sophisticated query suggestions based on output content +- Add context-aware query suggestions based on output content - Provide automatic chunking for very large datasets - Add content-aware compression (e.g., gzip) for JSON responses to reduce transfer size while maintaining full data access