sparkengine-change-control-and-release-readiness

Manages SparkEngine release gates, readiness work items, and same-SHA claim promotion rules.

31|3|Updated Jul 26, 2025
One-click install
npx skills add https://github.com/Krilliac/SparkEngine --skill sparkengine-change-control-and-release-readiness-krilliac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sparkengine-change-control-and-release-readiness
Source: https://github.com/Krilliac/SparkEngine/tree/main/.claude/skills/sparkengine-change-control-and-release-readiness
Command: npx skills add https://github.com/Krilliac/SparkEngine --skill sparkengine-change-control-and-release-readiness-krilliac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? SparkEngine's code looks feature-complete and its hygiene signals are green, yet its release contract reports 0 of 18 gates passing. This Skill resolves the gap between implemented code and provable readiness by enforcing a single machine-validated source of truth (readiness.json plus work-item JSON files) for every public status claim. ## Core Features & Use Cases - Readiness status queries: Answer "is subsystem X release-ready?" by reading the four independent capability dimensions (implementation, verification, support, release) from docs/site/readiness.json instead of trusting prose status pages or TODO counts. - Work item lifecycle: Pick up, progress, and close tracked items (RDY, CI, MOD, etc.) with strict schema validation, dependency ordering, and exact-SHA CI evidence requirements. - Wiring audits: Run caller/registration/tick/teardown checks (check-wiring.sh, check-test-registration.sh, check-editor-panels.sh) before claiming any system is done. - Use Case: A maintainer asks "what's blocking the release?" — the Skill reads the generated handoff verdict block, lists the 49 unfinished blocking items, and identifies RDY-000 as the only unblocked starting point. ## Quick Start Ask the assistant to check the current release readiness status of SparkEngine and list which work items are blocking the release.

Frequently Asked Questions about sparkengine-change-control-and-release-readiness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a SparkEngine subsystem is release-ready?

Read the capability entry in docs/site/readiness.json and report all four dimensions: implementation, verification, support, and release. The weakest dimension controls public framing, and blocking work item IDs must be cited alongside the verdict.

How do I close a readiness work item in SparkEngine?

Execute the item's commands array verbatim and attach exact-SHA CI evidence from its requiredCiJobs. Comments or screenshots never close items; then regenerate the handoff with render_handoff.py and validate with tools/site-data/validate.py in the same commit.

Why does the TODO count say the code is clean but the release is blocked?

Annotation-marker counts measure comment habits, not completeness. SparkEngine shows only 6 markers while 49 blocking readiness items remain open, so the readiness contract, not grep counts, owns the release verdict.

Can I claim a feature is stable if its tests pass?

Only if the tests execute production source or packaged binaries. Mirror-only, mock-only, or tautological tests cannot promote readiness under promotion rule 3, and production-ready wording is forbidden until the global release state is ready.

When should I not use this release-readiness runbook?

Use other skills for build or CMake failures, running packaged binaries, debugging runtime crashes, or EngineContext DLL injection work. This Skill governs public claims, gates, and work items only.

What is the difference between requiredCiJobs and plannedCiJobs?

requiredCiJobs must name jobs that already exist in .github/workflows, while plannedCiJobs records jobs the item still has to create. Moving an entry from planned to required is itself a promotion requiring evidence.