From 95ae9db5b73fb56c43b0b75710b4f746360a3484 Mon Sep 17 00:00:00 2001 From: gh-aw Documentation Bot Date: Wed, 4 Mar 2026 00:01:03 +0000 Subject: [PATCH 1/2] docs: fix 3 minor marketing-tone phrases in spec files (v3.5) Replace informal "easy to" phrasing in guard-policies-specification.md and engine-review-summary.md with precise technical descriptions. Bump dev.md to v3.5 reflecting the updated spec state. Co-Authored-By: Claude Sonnet 4.6 --- scratchpad/dev.md | 4 ++-- scratchpad/engine-review-summary.md | 2 +- scratchpad/guard-policies-specification.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/scratchpad/dev.md b/scratchpad/dev.md index 9a16e12a7ab..990f3394b89 100644 --- a/scratchpad/dev.md +++ b/scratchpad/dev.md @@ -1,7 +1,7 @@ # Developer Instructions -**Version**: 3.4 -**Last Updated**: 2026-03-01 +**Version**: 3.5 +**Last Updated**: 2026-03-04 **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. diff --git a/scratchpad/engine-review-summary.md b/scratchpad/engine-review-summary.md index 08414108e53..23cf908949b 100644 --- a/scratchpad/engine-review-summary.md +++ b/scratchpad/engine-review-summary.md @@ -279,7 +279,7 @@ The agentic engine architecture is **production-ready**. It follows SOLID princi 2. **BaseEngine Defaults**: Sensible defaults for all methods 3. **Shared Helpers**: Reduce duplication and ensure consistency 4. **Comprehensive Testing**: Automated validation of compliance -5. **Clear Patterns**: Easy to understand and follow +5. **Clear Patterns**: Consistent, well-documented for straightforward implementation The architecture **requires no structural changes**. The only gap was comprehensive documentation for adding new engines, which has been addressed with: diff --git a/scratchpad/guard-policies-specification.md b/scratchpad/guard-policies-specification.md index f44e18e341c..7e93b6050d1 100644 --- a/scratchpad/guard-policies-specification.md +++ b/scratchpad/guard-policies-specification.md @@ -283,7 +283,7 @@ tools: 1. **Security**: Restrict AI agent access to specific repositories 2. **Compliance**: Enforce minimum min-integrity requirements 3. **Flexibility**: Support diverse repository patterns and wildcards -4. **Extensibility**: Easy to add policies for Jira, WorkIQ, etc. +4. **Extensibility**: Supports adding policies for Jira, WorkIQ, etc. 5. **Clarity**: Clear error messages and validation 6. **Documentation**: Self-documenting through type system @@ -299,7 +299,7 @@ tools: This implementation provides a solid foundation for guard policies in the MCP gateway. The design is: - **Type-safe**: Strongly-typed structs with validation -- **Extensible**: Easy to add new servers and policy types +- **Extensible**: New servers and policy types can be added without structural changes - **User-friendly**: Intuitive frontmatter syntax - **Well-validated**: Comprehensive validation with clear error messages - **Forward-compatible**: Supports future enhancements From 3bd01988261f7d0e3f002a8c8a90838638b3533f Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 4 Mar 2026 00:03:06 +0000 Subject: [PATCH 2/2] ci: trigger checks