trex-core/.github/skills/CHANGELOG.md

Changelog

All notable changes to the StagePilot skill pack should be recorded in this file.

2026-05-22

run-batch-delivery 0.7.0

• added new orchestration skill run-batch-delivery
• defined a 6-step delivery chain for an existing batch: draft-batch-planning -> draft-batch-design -> run-batch-implementation -> draft-batch-verification -> confirm-batch-verification -> confirm-req-implemented
• clarified that the skill resumes from the first incomplete delivery stage and stops at approval blockers instead of forcing progress
• clarified that release drafting remains a separate next step and is recommended, not auto-executed

draft-req 1.0.3

• bumped draft-req from 1.0.2 to 1.0.3
• normalized the template path section to the same logical stage-pilot/templates/... + common resolution format used across the pack
• clarified source vs target path distinction for SRS index and REQ document generation

bootstrap-baseline 1.0.1

• bumped bootstrap-baseline from 1.0.0 to 1.0.1
• changed template references from fixed .stage-pilot/... paths to logical stage-pilot/templates/... paths
• added the common template path resolution section (.stage-pilot -> .vendor/stage-pilot -> ~/.stage-pilot)
• clarified source vs target path distinction for bootstrap seed, index, and baseline document generation

new-discovery 1.0.1

• bumped new-discovery from 1.0.0 to 1.0.1
• changed template references from fixed .stage-pilot/... paths to logical stage-pilot/templates/... paths
• added the common template path resolution section (.stage-pilot -> .vendor/stage-pilot -> ~/.stage-pilot)
• clarified source vs target path distinction for discovery document, discovery index, and baseline reference templates

draft-release 0.8.1

• bumped draft-release from 0.8.0 to 0.8.1
• changed template references from fixed .stage-pilot/... paths to logical stage-pilot/templates/... paths
• added the common template path resolution section (.stage-pilot -> .vendor/stage-pilot -> ~/.stage-pilot)
• clarified source vs target path distinction for release document and release index generation

draft-batch 0.9.1

• bumped draft-batch from 0.9.0 to 0.9.1
• added When to use and Do not use when guidance to separate batch creation from recommendation, approval, downstream drafting, and SDLC routing
• clarified that draft-batch operates only after people have selected the REQ set to include
• replaced the fixed batch template path wording with logical stage-pilot/templates/batches/... paths plus explicit resolution order
• clarified that minor-change is an input fast path while the persisted batch profile remains batch-lite
• added explicit source-to-target template mapping, source discovery recording rules, Common Pitfalls, and a Verification Checklist

suggest-batch-reqs 0.8.2

• bumped suggest-batch-reqs from 0.8.0 to 0.8.2
• added Do not use when guidance to separate recommendation from REQ approval, direct batch drafting, minor-change fast paths, and top-level SDLC routing
• added a dedicated 사람 선택 규칙 section so batch candidate adoption stays explicitly human-decided
• strengthened Discovery input handling so linked REQs must be explicit and approved before recommendation proceeds
• added explicit candidate-level batch profile hints for standard vs batch-lite, including required reasoning
• added Common Pitfalls and a Verification Checklist

confirm-req 0.9.1

• bumped confirm-req from 0.9.0 to 0.9.1
• added Do not use when guidance to separate approval from drafting, change management, implementation confirmation, and batch planning
• made approval prerequisites explicit, including blocker vs non-blocker handling for Notes and open questions
• clarified that approval Change Log entries are appended and not written for blocked REQs
• added a local docs/srs/index.md preservation rule so existing repository wording/format is updated in place rather than overwritten from template wording
• added Common Pitfalls and a Verification Checklist

draft-req 1.0.2

• bumped draft-req from 1.0.1 to 1.0.2
• added Do not use when guidance to separate draft-req from discovery review, confirmation, change-req, and batch planning stages
• made the confirmed Discovery prerequisite explicit and documented the limited draft-only exception case
• added a Common Pitfalls section covering confirmation, NFR splitting, baseline gaps, path confusion, index updates, and source Discovery back-references
• replaced the old validation bullets with a Verification Checklist for operational verification after drafting

draft-req 1.0.1

• bumped draft-req from 1.0.0 to 1.0.1
• replaced fixed template path references with logical template source paths under stage-pilot/templates/...
• added explicit template path resolution rules for workspace-local, vendor/subtree, and Hermes external installs
• clarified resolution priority: workspace-local -> vendor/subtree -> Hermes external
• clarified the distinction between template source paths and generated target paths under docs/srs/
• added validation checks for logical-path-to-physical-path resolution and source/target path confusion

confirm-discovery 0.9.1

• bumped confirm-discovery from 0.9.0 to 0.9.1
• applied wording cleanup (Skill -> skill) for local style consistency
• clarified that Confirmed By is never auto-generated or inferred by AI
• clarified when to use review-discovery or new-discovery instead of confirm-discovery
• added baseline cross-check guidance for docs/project-structure.md and docs/runtime-flows.md
• added explicit pitfalls and a verification checklist
• clarified how to add a missing docs/discovery/index.md row while preserving register format

Metadata normalization

Applied long-term management metadata across all StagePilot skills under ~/.stage-pilot/skills.

Changed for every skill:

• added or normalized author: Justin Ko
• added license: private
• added metadata.hermes.tags
• added metadata.hermes.related_skills
• normalized frontmatter layout for long-term reuse

Version reclassification

Assigned workflow-maturity-based semantic versions instead of a uniform initial version.

Stable core (1.0.0)

• bootstrap-baseline
• new-discovery
• draft-req

Near-stable (initial classification)

• confirm-discovery → later bumped to 0.9.1
• confirm-req → 0.9.0
• draft-batch → 0.9.0

Maturing workflow (0.8.0)

• change-req
• confirm-batch-verification
• confirm-release
• draft-batch-design
• draft-batch-planning
• draft-batch-verification
• draft-release
• review-discovery
• suggest-batch-reqs

Active evolution / orchestration (0.7.0)

• confirm-req-implemented
• run-batch-delivery
• run-batch-implementation
• run-sdlc

Early-support (0.6.0)

• capture-release-feedback
• suggest-next-discovery

Notes

Current intent of the version scale:

• 0.6.x — useful early-support skill, likely to evolve significantly
• 0.7.x — execution/orchestration behavior still evolving
• 0.8.x — maturing drafting/decision workflow
• 0.9.x — near-stable, only moderate refinement expected
• 1.0.x — stable core workflow skill