feat(skills): rename generated specs-root outputs to _LATEST.md suffix

[danielvm-git]

Summary

• Renames all 7 fixed-name generated outputs in specs/ root to use the _LATEST.md suffix, matching the pattern already established in specs/product/ and specs/tech-architecture/
• Updates source SKILL.md files: audit-plan, assess-impact, plan-refactor, trace-requirement, define-language, search-skills, inspect-quality, migrate-spec
• Updates scripts/build-skill-index.sh OUT variable, package.json version script, and .releaserc.json release assets
• git mv renames: specs/IMPACT.md → specs/IMPACT_LATEST.md, specs/SKILL-SEARCH-INDEX.md → specs/SKILL-SEARCH-INDEX_LATEST.md
• All generated artifacts (.gemini/, .pi/, skills-lock.json) regenerated by sync-skills.sh

Test plan

• All 9 task verify: commands return OK
• No stale old-path references remain in source files
• Compliance gate: 97% (86/88 pass), unchanged from baseline
• specs/SKILL-SEARCH-INDEX_LATEST.md regenerated by build-skill-index.sh
• Audit report: specs/verifications/AUDIT-e27-e27s01.md

Greptile Summary

This PR standardises all 7 fixed-name generated outputs in specs/ root to the _LATEST.md suffix, matching the convention already in use under specs/product/ and specs/tech-architecture/. It also ships a new extract-design skill (skill 72).

• Every affected source SKILL.md, cursor rule, Gemini prompt, .pi/ prompt, scripts/build-skill-index.sh, package.json, and .releaserc.json has been updated to reference the renamed paths, and both specs/IMPACT.md and specs/SKILL-SEARCH-INDEX.md are git mv'd to their _LATEST.md equivalents.
• .github/workflows/sync-skills.yml was not updated and still monitors the old specs/SKILL-SEARCH-INDEX.md path, silently disabling the CI guard that catches out-of-date index commits.
• docs/using-bigpowers.md had its link target updated but its inline skill count ("70 skills") was not changed, leaving three files in this same PR reporting three different counts (70 / 71 / 72).

Confidence Score: 4/5

Safe to merge with one follow-up: the CI workflow file needs a one-line path fix before the index freshness guard becomes effective again.

The rename sweep is thorough across all source SKILL.md files, cursor rules, Gemini prompts, build scripts, package.json, and .releaserc.json. The one missed file — .github/workflows/sync-skills.yml — monitors a path that no longer exists, which means the automated check that prevents stale-index commits will silently pass from now on. The docs/using-bigpowers.md skill count inconsistency is cosmetic. Neither issue affects runtime behaviour of the skills themselves, but the broken CI guard is a real gap introduced by this PR.

.github/workflows/sync-skills.yml — lines 30 and 32 still reference the old specs/SKILL-SEARCH-INDEX.md path and were not included in this PR's changeset.

Important Files Changed

Filename	Overview
.github/workflows/sync-skills.yml	Not included in the PR changeset — still references the old specs/SKILL-SEARCH-INDEX.md path at lines 30 and 32, silently breaking the CI freshness guard.
scripts/build-skill-index.sh	Single-line OUT variable updated from SKILL-SEARCH-INDEX.md to SKILL-SEARCH-INDEX_LATEST.md — correct and complete.
package.json	The version script's git add path updated to SKILL-SEARCH-INDEX_LATEST.md — consistent with the rename.
.releaserc.json	Release assets array updated to reference SKILL-SEARCH-INDEX_LATEST.md — correct.
assess-impact/SKILL.md	All references to specs/IMPACT.md renamed to specs/IMPACT_LATEST.md including description, step header, and verify command.
search-skills/SKILL.md	All five references to specs/SKILL-SEARCH-INDEX.md updated to _LATEST.md — thorough sweep.
docs/using-bigpowers.md	Link target updated but the inline "70 skills" count is stale; other files (model-profiles.md, SKILL-INDEX.md) now report different counts.
skills-lock.json	Updated descriptions and hashes for all renamed skills, plus the new extract-design skill entry — consistent with source changes.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[SKILL.md source files] -->|sync-skills.sh| B[.cursor/rules/*.mdc]
    A -->|sync-skills.sh| C[.gemini/extensions/bigpowers/skills/]
    A -->|sync-skills.sh| D[.pi/skills/]
    A -->|build-skill-index.sh| E[specs/SKILL-SEARCH-INDEX_LATEST.md]
    E -->|git add in version script| F[package.json version hook]
    E -->|release asset| G[.releaserc.json]
    H[.github/workflows/sync-skills.yml] -->|git diff check| I{specs/SKILL-SEARCH-INDEX.md ❌ STALE PATH}
    H -->|should check| J[specs/SKILL-SEARCH-INDEX_LATEST.md ✅]
    style I fill:#ff6b6b,color:#fff
    style J fill:#51cf66,color:#fff

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[SKILL.md source files] -->|sync-skills.sh| B[.cursor/rules/*.mdc]
    A -->|sync-skills.sh| C[.gemini/extensions/bigpowers/skills/]
    A -->|sync-skills.sh| D[.pi/skills/]
    A -->|build-skill-index.sh| E[specs/SKILL-SEARCH-INDEX_LATEST.md]
    E -->|git add in version script| F[package.json version hook]
    E -->|release asset| G[.releaserc.json]
    H[.github/workflows/sync-skills.yml] -->|git diff check| I{specs/SKILL-SEARCH-INDEX.md ❌ STALE PATH}
    H -->|should check| J[specs/SKILL-SEARCH-INDEX_LATEST.md ✅]
    style I fill:#ff6b6b,color:#fff
    style J fill:#51cf66,color:#fff

Loading

_{Reviews (1): Last reviewed commit: "chore(state): mark e27s01 done — _LATEST..." | Re-trigger Greptile}

Greptile also left 1 inline comment on this PR.

[github-actions]

🎉 This PR is included in version 2.42.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[greptile-apps]

The skill count "70 skills" wasn't updated alongside the link-target change in this file. SKILL-INDEX.md now reports 72 skills (after adding extract-design) and docs/references/model-profiles.md was updated to 71 in this same PR — all three counts are now inconsistent.

Suggested change

	- **70 skills.** See [`specs/SKILL-SEARCH-INDEX_LATEST.md`](../specs/SKILL-SEARCH-INDEX_LATEST.md) (auto-generated catalog — regenerate with `bash scripts/build-skill-index.sh`); find the right skill with `search-skills`. Full SOP at `docs/WORKFLOW-SOP-v2.md`.
	- **72 skills.** See [`specs/SKILL-SEARCH-INDEX_LATEST.md`](../specs/SKILL-SEARCH-INDEX_LATEST.md) (auto-generated catalog — regenerate with `bash scripts/build-skill-index.sh`); find the right skill with `search-skills`. Full SOP at `docs/WORKFLOW-SOP-v2.md`.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!