renma 0.15.2 → 0.17.0

package/CHANGELOG.md

@@ -6,6 +6,57 @@ This project follows the spirit of [Keep a Changelog](https://keepachangelog.com
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-07-11
+
+### Added
+
+- Added platform-neutral, Skill-specific next steps to scaffold file and prompt output, including the authoring-review, scan, fix, rerun, and human-review loop.
+- Added Skill-specific `suggest-metadata` prompt guidance that separates whole-Skill authoring review from metadata or one-way migration suggestions and keeps blocked migrations conservative.
+- Added a documentation index with reading paths for workflows, format contracts, governance references, product design, architecture, and roadmap material.
+- Added the interactive-placeholder onboarding example and package-content verification for version-matched README documentation and examples.
+
+### Changed
+
+- Clarified that platform-native guidance owns general Skill design while Renma complements it with repository-specific governance and validation.
+- Consolidated the README around product identity, boundaries, primary workflows, quick start, command orientation, a canonical example, and documentation navigation.
+- Made the authoring guide the canonical new-Skill and existing-Skill workflow, including safe generator boundaries and an optional Codex `skill-creator` example.
+- Reworked the user manual and compatibility guide around actual CLI behavior, review responsibilities, scan/fix/rerun validation, and blocked migration recovery.
+- Rewrote the roadmap around the shipped 0.16.0 baseline, the 0.17.0 usability release, and proposed 0.18.0 graph-based Skill discovery; removed stale release sequencing from architecture and design.
+- Made canonical nested Skills under both `skills/**` and `.agents/skills/**` participate consistently in Readiness, thin-Skill, graph, support, and parent-Skill checks.
+- Allowed valid Skill-local Agent Skills support directories without path-only disallowed-layout findings; reusable Context and shared-helper promotion remains evidence-based and human-reviewed.
+- Normalized expected CLI target and option errors, enforced command-specific options and positional arity, and rejected partial positive-integer values.
+- Retained `layout.tool_namespace` and `layout.workflow_aliases` as validated compatibility-only input; they no longer force path-only migration of valid Skill-local support.
+
+### Fixed
+
+- Corrected Readiness false-positive `ready` results for nested Skills with missing workflow guidance.
+- Updated the Context Lens example to current 0.17.0 quality with conservative local policy, complete workflow guidance, and clean scan/readiness output.
+- Included README-linked architecture, design, roadmap, documentation, and examples in the npm package.
+- Stopped treating documented Skill-local support paths as stale and resolved `scripts/**` helper commands against an unambiguous owning Skill using repository snapshot evidence.
+
+### Compatibility
+
+- Preserved scaffold and `suggest-metadata` JSON field shapes, stdout-only prompt behavior, and non-editing metadata suggestions.
+- Kept Skill-specific guidance out of Context Asset and Context Lens scaffold and suggestion output.
+
+## [0.16.0] - 2026-07-11
+
+### Added
+
+- Added Agent Skills specification validation to `scan`, including stable diagnostics for entrypoint naming, frontmatter, metadata, and body requirements.
+- Added deterministic migration assistance to `suggest-metadata` for pre-0.16 Skill entrypoints and metadata, with conflict detection and canonical candidate validation.
+- Added comprehensive Agent Skills compatibility and migration documentation, canonical authoring guidance, and a Context Lens example for boundary-value spec review.
+
+### Changed
+
+- Required operational Skills to use specification-valid Agent Skills frontmatter with Renma extensions under flat, string-valued `metadata.renma.*` keys.
+- Updated catalog, graph, ownership, readiness, BOM, security, scaffold, and reporting consumers to use canonical Skill metadata while retaining legacy forms only as migration input.
+- Expanded the README, architecture, design, user manual, security guidance, and example repository for the 0.16.0 Skill format and repository model.
+
+### Fixed
+
+- Corrected the repository-owned release-prep Skill syntax and kept its operational workflow in the required release context.
+
 ## [0.15.2] - 2026-07-10
 
 ### Added
@@ -292,7 +343,9 @@ Tag-only release. No GitHub Release entry was published for this version.
 - Added metadata governance, advisory diagnostics, local path checks, and semantic split suggestions.
 - Added the initial project documentation, architecture notes, package metadata, tests, and license.
 
-[Unreleased]: https://github.com/KazuCocoa/renma/compare/v0.15.2...HEAD
+[Unreleased]: https://github.com/KazuCocoa/renma/compare/v0.17.0...HEAD
+[0.17.0]: https://github.com/KazuCocoa/renma/compare/v0.16.0...v0.17.0
+[0.16.0]: https://github.com/KazuCocoa/renma/compare/v0.15.2...v0.16.0
 [0.15.2]: https://github.com/KazuCocoa/renma/compare/v0.15.1...v0.15.2
 [0.15.1]: https://github.com/KazuCocoa/renma/compare/v0.15.0...v0.15.1
 [0.15.0]: https://github.com/KazuCocoa/renma/compare/v0.14.1...v0.15.0