Skip to content

feat: v23 improve#82

Merged
diegoitaliait merged 64 commits into
mainfrom
v23-improve
Jul 25, 2026
Merged

feat: v23 improve#82
diegoitaliait merged 64 commits into
mainfrom
v23-improve

Conversation

@diegoitaliait

Copy link
Copy Markdown
Contributor

Description

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

Consumer Impact

  • Affected customization assets:
  • Backward compatibility notes:
  • Rollout or migration notes (if any):

Testing Instructions

Validation Evidence

  • Repository-level checks result:
  • Stack-specific checks/tests result:
  • Security/supply-chain checks result:

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

…ronization

- Add sync_repos.py script to handle planning and applying local repository syncs.
- Introduce AGENTS.local.md template for repository-specific policies.
- Update workflows to utilize the new sync_repos.py script.
- Document lessons learned regarding sync operations and repository management.
- Enhance tech documentation to reflect new sync logic.
- Add comprehensive tests for sync contract and CLI functionality.
- Ensure retired identifiers and paths are removed, and new bundle paths are validated.
- Updated descriptions and handoff sections for internal Azure DevOps, Governance, Operations, and Organization Structure skills to clarify usage and improve guidance.
- Removed the internal-azure-strategic skill and its associated files, as it was deemed unnecessary.
- Adjusted references and handoff logic across various skills to ensure proper routing and clarity.
- Fixed minor issues in the audit and sync processes, including updates to the lessons learned documentation and tech documentation to reflect recent changes in tooling.
- Updated descriptions and conditions for using `internal-aws` and `internal-azure` to emphasize strategic decision framing and routing under material uncertainty.
- Enhanced guidance in various skills to clarify when to use fallback routing and when to seek strategic support.
- Improved test cases to validate the new descriptions and ensure consistency across skills.
- Added new tests for `internal-github` to ensure proper routing and strategic decision support.
…ons and enforce routing clarity

- Removed "Handoffs", "Cross-references", "Referenced skills", "Relationship to adjacent skills", and "When not to use" sections from various skill markdown files.
- Updated routing guidance to ensure clarity on when to route back to the main internal skills.
- Enhanced validation tests to ensure no sibling references or handoffs are present in lane skills.
- Adjusted common mistakes and guidance to maintain focus on operational and governance boundaries across all platforms.
- Added sync_output_core.py with OutputRecord dataclass and functions for escaping TSV values and rendering TSV from records.
- Enhanced test_candidate.py to include source metadata writing and updated asset references to use full SHA-1 hashes.
- Updated test_cli.py to validate source metadata and ensure proper handling of long SHA-1 references.
- Introduced test_manifest.py to validate manifest structure and enforce full lowercase commit object IDs.
- Created test_network_boundary.py to enforce restrictions on subprocess commands in scripts.
- Added test_output.py to validate TSV escaping and rendering functionality.
- Developed test_source_prepare.py to ensure proper source preparation and validation of upstream paths.
- Updated test_external_resource_catalog_contract.py to use full SHA-1 references for consistency.
- Updated task-reviewer prompt to clarify package path usage.
- Revised systematic debugging skill to emphasize root cause analysis and added verification skill reference.
- Improved find-polluter script to handle test file patterns more robustly.
- Streamlined test-driven development documentation, removing anti-patterns and emphasizing test integrity.
- Deleted outdated testing anti-patterns reference and created a new writing good tests guide.
- Adjusted git worktree skill to clarify common rationalizations and mistakes.
- Enhanced antigravity and codex tools documentation for clarity and completeness.
- Added new Gemini CLI tool mapping for better skill integration.
- Updated verification before completion skill to stress the importance of evidence before claims.
- Refined writing plans skill to ensure clarity and completeness in engineering steps.
- Minor formatting fixes in Terraform search import skill for consistency.
- Corrected managed assets count in CLI tests to reflect accurate state.
- Deleted run_loop.py and utils.py scripts from anthropic-skill-creator.
- Updated SKILL.md in internal-skill-creator to reflect new authoring and evaluation processes.
- Modified openai.yaml to clarify the role of the Internal Skill Creator.
- Added authoring-and-evaluation.md reference document for detailed guidance on the new workflow.
- Removed anthropic-skill-creator dependency from local-agent-sync-external-resources.
- Adjusted tests to align with the new structure and ensure no references to deprecated components remain.
…handling

- Added checks for duplicate sections, section order, and empty sections in the output validation script.
- Introduced validation for challenge context lenses, premortem status, and synthesis defense classification.
- Updated the Makefile to enforce strict validation during critical output checks.
- Expanded test coverage for adversarial fixtures, section order violations, and missing evidence quality.
- Created a new test suite for contract alignment to ensure consistency with expected outcomes and requirements.
…hitecture improvements

fix: Adjust expected managed_assets count in audit tests and manifest validation
feat: Introduce HTML report format for architectural reviews and improve codebase architecture skill documentation
…nting rules

- Updated markdownlint configuration to ignore specific emoji card fixtures.
- Added new tests for parsing critical cards with emoji markers, ensuring correct handling of language-neutral keys.
- Refined validation tests to enforce stricter rules on card structure and content, including checks for missing markers and correct order.
- Improved contract alignment tests to ensure adaptive card markers are present and legacy sections are excluded.
- Enhanced agent prompt tests to verify localized projection requests.
…nce retained spec handling and execution flow
- Introduced a new CLI script for validating execution plans and their statuses.
- Added fixtures for valid and invalid plan statuses.
- Created detailed documentation for execution and status contracts.
- Implemented rigorous checks for plan readiness, status transitions, and workspace baselines.
- Enhanced the Makefile to support new validation commands.
- Developed comprehensive tests for plan execution validation and status checks.
- Removed outdated tests related to simplification routing contracts.
- Added new tests to ensure the integrity of execution plans and their dependencies.
…ocations

- Updated all skill references in SKILL.md files to use the slash prefix (e.g., `/superpowers-brainstorming`).
- Adjusted workflow documentation to reflect the new invocation style.
- Modified tests to ensure that cross-skill invocations are correctly prefixed.
- Removed `disable-model-invocation: true` from relevant skills to allow model invocation.
- Added a new test suite to validate cross-skill invocation rules and ensure compliance with the new standards.
…tion; enhance execution contract and workflow references
…ion; refine skill references and documentation
- Simplified path concatenations in various test files for better clarity.
- Consolidated multi-line strings into single lines where appropriate.
- Enhanced readability by aligning code formatting and spacing.
- Ensured consistent use of imports and removed unnecessary blank lines.
- Updated assertions to maintain clarity and conciseness across tests.
@diegoitaliait
diegoitaliait requested review from a team and GNuccio96 as code owners July 25, 2026 18:44
@diegoitaliait
diegoitaliait merged commit 10cc5e9 into main Jul 25, 2026
4 checks passed
@diegoitaliait
diegoitaliait deleted the v23-improve branch July 25, 2026 18:53
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