Skip to content

feat: v14 Improve#63

Merged
diegoitaliait merged 26 commits into
mainfrom
v14-improve
Jun 14, 2026
Merged

feat: v14 Improve#63
diegoitaliait merged 26 commits into
mainfrom
v14-improve

Conversation

@diegoitaliait

@diegoitaliait diegoitaliait commented Jun 14, 2026

Copy link
Copy Markdown
Contributor

Description

Enhance internal gateway execution strategies and improve documentation across various development practices. Introduce new guidelines for scripting, YAML, Makefile, and other formats to ensure maintainability and clarity. Remove obsolete hooks and streamline existing documentation for better usability.

Change Type

  • Agent update
  • Instruction update
  • Skill update
  • AI policy update (AGENTS.md, copilot-instructions.md)
  • Workflow/automation update
  • Verification/automation update
  • Documentation/configuration only
  • Scripts/Utils update
  • Other

List of changes

  • Unified execution plans for internal gateway tasks.
  • Added comprehensive guidelines for various scripting and configuration formats.
  • Enhanced review checks for instruction files to ensure best practices.

Consumer Impact

  • Affected customization assets: Instruction files, execution plans.
  • Backward compatibility notes: Some obsolete hooks removed.
  • Rollout or migration notes (if any): None.

Testing Instructions

  1. Review the updated instruction files for compliance with new guidelines.
  2. Validate execution of internal gateway tasks with the new unified plans.

Validation Evidence

  • Repository-level checks result: All checks passed.
  • Stack-specific checks/tests result: Tests updated and passed.
  • Security/supply-chain checks result: No issues found.

Breaking Changes

  • This PR contains breaking changes

Checklist

  • No secrets/tokens/credentials committed
  • Repository artifacts remain in English
  • Available repository checks executed as applicable
  • Workflow action pins use full SHA with adjacent release/tag reference
  • References remain repository-agnostic and reusable

@diegoitaliait diegoitaliait requested review from a team and GNuccio96 as code owners June 14, 2026 12:57
- Introduced Kubernetes manifests instructions focusing on security, labeling, resource management, and validation.
- Added shell scripting best practices for clean, maintainable, and safe scripts.
- Established internal Bash scripting standards for consistent logging and guard clauses.
- Defined CODEOWNERS standards for template placeholders and review readiness.
- Created Copilot agent authoring guidelines for boundary clarity and minimal duplication.
- Developed skill reference authoring instructions for reusable details without duplication.
- Set Docker and container build standards for secure, reproducible images.
- Outlined composite action standards for GitHub Actions with input validation.
- Established baseline standards for GitHub Actions workflows emphasizing security and deterministic execution.
- Created Java project standards focusing on DDD boundaries and readability.
- Defined JSON formatting and consistency standards for configuration files.
- Established Lambda implementation rules for explicit handlers and input validation.
- Created rules for editing the lessons learned ledger without turning it into policy.
- Set Makefile conventions for deterministic targets and readable recipes.
- Defined Markdown standards for maintainable documentation.
- Established Node.js project standards with DDD-oriented layering and testing practices.
- Created Python standards for scripts and application code with DDD boundaries.
- Defined Terraform authoring standards for readability and validation-first delivery.
- Established YAML formatting and clarity conventions for configuration files.
…elopment, Kubernetes manifests, and enhance Bash scripting instructions
…nsistency checks

- Updated all instruction files to include a standardized opening statement for Copilot code review.
- Introduced mandatory checks for `description`, `applyTo`, and `excludeAgent` fields in instruction frontmatter.
- Enhanced review checks across various instruction files (Java, JSON, Kubernetes, Lambda, etc.) to ensure best practices and maintainability.
- Modified catalog checks to enforce new instruction standards and validate instruction file integrity.
- Updated tests to cover new instruction validation logic and ensure proper handling of source-managed instructions.
…tion, CodeQL, Dependabot, Helm, and improve existing guidelines for Azure DevOps, Terraform, and Python
- Removed the copilot instructions override template and related paths from the codebase.
- Updated references to the copilot instructions to reflect the new compact routing bridge structure.
- Introduced a new global review baseline in `.github/instructions/copilot-code-review.instructions.md`.
- Adjusted documentation to clarify the roles of `AGENTS.md`, `.github/copilot-instructions.md`, and the new review baseline.
- Modified tests to ensure consistency with the updated structure and removed legacy references to the deleted override template.
- Enhanced clarity in the README and other documentation regarding the separation of policy, bridge, and review baseline.
…nce pass guidelines, update audit and writing plans processes
… remove recommended consumer field from retained plans
@diegoitaliait diegoitaliait merged commit f777eda into main Jun 14, 2026
6 checks passed
@diegoitaliait diegoitaliait deleted the v14-improve branch June 14, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant