V0.8.0/agent smith

CHANGELOG.md

@@ -6,10 +6,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [0.8.0] - 2026-07-18
 
-This is a minor release introducing the `dotnet-benchmark` skill for performance testing of .NET types with evidence-driven discovery and measurement discipline. The release emphasizes candidate selection through profiling evidence, semantic correctness validation before performance interpretation, and proportionate-stopping decision logic. Additionally, the release standardizes local PowerShell execution to `pwsh` 7+ and strengthens validation discipline across repo-managed skills.
+This is a minor release introducing the `agent-smith` skill for rigorous software-craftsmanship standards across design, architecture, implementation, testing, performance, security, DevSecOps, and CI/CD, alongside the `dotnet-benchmark` skill for evidence-driven performance testing. The release resolves a critical git-keep-a-changelog bug that could silently include already-released commits when determining scope boundaries, replaces implicit caret notation with deterministic branch-derived scope validation, and introduces deterministic commit-subject validation infrastructure to `git-visual-commits` with a bundled PowerShell validator and full-skill-read gating. PowerShell execution is standardized to pwsh 7+, and skill validation tooling is strengthened across the repository.
 
 ### Added
 
+- `agent-smith` skill with comprehensive workflow guidance for rigorous software-craftsmanship standards across engineering tasks, including design, architecture, implementation, refactoring, code review, public API analysis, testing, benchmarking, performance, security, DevSecOps, CI/CD, delivery, and repository governance,
+- Detailed reference documentation for agent-smith covering core principles, decision frameworks, architecture guidelines, implementation patterns, testing strategies, performance considerations, security and DevSecOps guidance, CI/CD workflows, delivery discipline, repository governance, engineering assessment templates, and agent handoff protocols,
+- Eval coverage for `agent-smith` including discipline verification, review scenarios, and governance application across multiple engineering contexts,
+- README updates with `agent-smith` installation snippet, capability showcase, and "Why agent-smith?" section explaining technology-neutral core, progressive disclosure, evidence-driven reporting, local-convention respect, and honest completion gates,
 - `dotnet-benchmark` skill with evidence-driven workflow for identifying high-value benchmark targets, designed to avoid low-signal performance testing and over-measurement; includes step-by-step discovery phases from intent resolution through experiment planning,
 - Discovery-focused FORMS.md parameter collection for `dotnet-benchmark` reducing implementation-tier choice friction by deferring tier selection to workflow inspection,
 - New template assets `operation-benchmark.cs` and `comparison-benchmark.cs` providing refined structural guidance for single-operation and comparative-implementation benchmarks,
@@ -20,11 +24,30 @@ This is a minor release introducing the `dotnet-benchmark` skill for performance
 - Yolo mode support in `dotnet-benchmark` for autonomous candidate selection and progress-update-only planning when user intent is explicit,
 - Report-aware runner preflight in `dotnet-benchmark` recognizing when SkipBenchmarksWithReports plus matching reports/tuning/ artifacts intentionally filter a benchmark type, preserving benchmark code unchanged,
 - Comprehensive eval coverage for `dotnet-benchmark` with 12 test cases covering discovery workflow, candidate selection, evidence gathering, cost-signal analysis, implementation-comparison patterns, semantic preflight validation, selectivity-drift repair, proportionate stopping, yolo mode, and report-aware preflight; includes fixture code supporting five representative benchmark scenarios,
-- Enhanced `check-benchmark-requirements.ps1` and new `validate-skill.ps1` tooling supporting discovery workflow validation and template-asset consistency checking.
+- Enhanced `check-benchmark-requirements.ps1` and new `validate-skill.ps1` tooling supporting discovery workflow validation and template-asset consistency checking,
+- Deterministic release-scope resolver script `scripts/resolve-release-scope.ps1` for git-keep-a-changelog providing bleed-guard validation and branch-unique commit identification with JSON output,
+- Base history bleed validation guard in git-keep-a-changelog ensuring that only commits unique to the selected branch are included in changelog entries, preventing accidental duplication of already-released work,
+- Deterministic commit-subject validator `scripts/validate-commit-subject.ps1` for git-visual-commits enforcing emoji presence in bundled reference table, exactly one ASCII space separator, lowercase description beginning, opt-in conventional-prefix contract, and 70-character maximum,
+- Comprehensive test coverage for deterministic subject validation via `scripts/test-commit-subject.ps1` covering validator behavior, error cases, and edge conditions,
+- Full-skill-read and subject-validation gates in git-visual-commits requiring complete SKILL.md read before any Git command, bundled deterministic validator invocation before plan display and before commit, and subject validation lock that bypasses `yolo`/`auto` mode.
+- Deterministic `repair-roslyn-multiproject-artifacts.ps1` recovery for `agent-smith` that detects Roslyn merge artifacts independently of diagnostic ID, collapses only the registered whole-document namespace-conversion pattern, fails closed on differing or unrecognized candidates, preflights directory repairs before writing, and includes fixture-backed tests for encoding, idempotence, unsupported localized artifacts, and partial-write prevention.
 
 ### Changed
 
-- Standardized local PowerShell execution to `pwsh` 7+ while preserving Bash and workflow-specific shell choices; updated all local command examples and contributor guidance accordingly.
+- Hardened `agent-smith` EditorConfig conformance guidance so informational workflows preserve explicit `--severity info` across discovery, recovery, and final verification, targeted checks use category-specific formatter subcommands, Roslyn multi-project recovery is based on proven artifact structure rather than diagnostic ID, and `--no-restore` cannot be mistaken for conformance evidence,
+- Standardized local PowerShell execution to `pwsh` 7+ while preserving Bash and workflow-specific shell choices; updated all local command examples and contributor guidance accordingly,
+- Refactored git-keep-a-changelog scope resolution from implicit caret-notation to deterministic branch-derived ranges using the bundled `resolve-release-scope.ps1` resolver, providing explicit separation between `history_range` (for commits) and `diff_range` (for manifest diffs),
+- Enhanced git-keep-a-changelog Step 1 guidance to use the resolver script for all branch-derived scope, eliminating manual range construction and the risk of incorrect inclusivity or boundary drift,
+- Improved skill-template validator to recognize and validate git-keep-a-changelog's new deterministic resolver behavior and bleed-guard validation requirements,
+- Restructured git-visual-commits SKILL.md with new Critical Rules section documenting full-skill-read requirement, deterministic subject validation lock, identity lock, direct Git execution rule, fail-fast tool validation, auto-approval guard, default scope rule, recovery safety rule, and approval-and-clarification lock,
+- Enhanced git-visual-commits description to highlight deterministic validation, full-skill-read requirement, and exact subject format enforcement (approved emoji, one space, lowercase beginning, 70-character maximum),
+- Updated repo validator to check git-visual-commits subject-validation infrastructure presence including validate-commit-subject.ps1, test-commit-subject.ps1, and SKILL.md documentation of full-skill-read and subject-validation gates,
+- Updated README with documentation of git-visual-commits deterministic subject validation gating and rejection criteria.
+
+### Fixed
+
+- Resolved critical git-keep-a-changelog bug where implicit caret notation and loose range handling could inadvertently include already-released commits in new changelog entries, causing silent duplication of previous release content; now requires explicit bleed-guard validation via the deterministic resolver,
+- Corrected skill-validator behavior to account for git-keep-a-changelog's updated scope-resolution contract and bleed-guard validation requirements.
 
 ## [0.7.5] - 2026-07-15
 
@@ -47,20 +70,17 @@ This is a patch release focused on extending `trunk-first-repo` with a push-remo
 This is a patch release focused on strengthening `git-keep-a-changelog` with mandatory Step 4a base-commit inspection for concrete releases, ensuring that foundational version bumps, release-prep changes, and dependency baseline updates are never omitted from release narratives. The skill now requires explicit inspection of the base commit before manifest diffs and commit bodies, with output verification and structured reporting.
 
 ### Added
-
 - Step 4a mandatory checkpoint in `git-keep-a-changelog` that inspects and explicitly reports the base commit for concrete releases (e.g., `## [X.Y.Z]`), showing changed files, identifying dependency/version manifests, and confirming release-prep file modifications before proceeding to Step 4b manifest diffs,
 - Explicit base-commit-inclusion enforcement using `<base>^..HEAD` (with caret) throughout Step 4 for concrete releases, ensuring the base commit itself is included in the changelog narrative,
 - Verification and confirmation gates in Step 4a requiring agents to show full base commit output, identify manifests, and explicitly state whether manifests or release-prep files were touched before proceeding to 4b,
 - Detailed comparison matrix in Step 3b distinguishing between `base^..HEAD` (for concrete releases, inclusive of base) and `base..HEAD` (for [Unreleased], exclusive of base),
 - Eval coverage validating base-commit inclusion, manifest detection, and Step 4a output verification for concrete release scenarios.
-
 ### Changed
 
 - Restructured `git-keep-a-changelog` Step 4 into explicit sub-steps (4a through 4f) with clear sequencing: base-commit inspection first (4a), manifest detection (4b), manifest diff inspection (4c), commit-body reading (4d), net-diff inspection (4e), and pending-change integration (4f),
 - Enhanced `git-keep-a-changelog` SKILL.md with critical range-extension guidance for concrete releases, emphasizing that `<base>^..HEAD` (with caret) must be used consistently to include the base commit itself,
 - Strengthened "Bad Output Characteristics" section with **CRITICAL** emphasis on the consequences of omitting the base commit: silently-wrong output that breaks release narratives and loses foundational version bumps,
 - Updated README with enhanced description of `git-keep-a-changelog` base-commit enforcement and Step 4a mandatory checkpoint.
-
 ## [0.7.3] - 2026-07-01
 
 This is a patch release focused on skill refinement and documentation improvements, including xref member-link validation enhancements to dotnet-docfx-digest, structural improvements to git-keep-a-changelog's manifest-diff reading, and emoji discipline improvements across git-visual skills.
@@ -473,6 +493,7 @@ This is a minor release that introduces two complementary git workflow skills, e
 
 - Improved scaffold fidelity with hidden `.bot` asset preservation, explicit UTF-8 and BOM handling, and checks aimed at preventing mojibake or incomplete generated output.
 
+[Unreleased]: https://github.com/codebeltnet/agentic/compare/v0.8.0...HEAD
 [0.8.0]: https://github.com/codebeltnet/agentic/compare/v0.7.5...v0.8.0
 [0.7.5]: https://github.com/codebeltnet/agentic/compare/v0.7.4...v0.7.5
 [0.7.4]: https://github.com/codebeltnet/agentic/compare/v0.7.3...v0.7.4