skills.rest
kostiantyn-matsebora
kostiantyn-matseboraCOMMUNITY
Explore all skills by this author →
GitHub

ginee-reindex

Reconcile the local index with repository state using a three-sweep protocol.

Updated Aug 27, 2026
Search Tags:#consistency#indexing#protocol#repository#reindex
One-click install
npx skills add https://github.com/kostiantyn-matsebora/ginee --skill ginee-reindex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ginee-reindex
Source: https://github.com/kostiantyn-matsebora/ginee/tree/main/core/skills/ginee-reindex
Command: npx skills add https://github.com/kostiantyn-matsebora/ginee --skill ginee-reindex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reconcile local/index/ with the current repo state at the named scope per the ginee index protocol. Three sweeps — SHA drift on existing entries, new files within existing class globs, stale entries (prompt). Use when the user asks to 'reindex', 'reindex <file>', 'reindex <class>', 'reconcile the index', 'refresh the index', or when SHA-256 drift is detected pre-dispatch.

Core Features & Use Cases

  • Three-sweep reconciliation workflow: detect drift, add new files, and surface stale entries to preserve index fidelity.
  • Scope-aware: apply to the whole repository or a specific class/file scope defined by manifest globbing.
  • Robust and auditable: updates manifest data, performs sample-and-check, and surfaces diffs for user decision.

Quick Start

Run ginee-reindex to reconcile the entire repo index, or provide a scope to target a file or class.

Frequently Asked Questions about ginee-reindex

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

FAQPage Schema
How do I reconcile my local index when the repository state changes?▼

To reconcile your index, run a three-sweep protocol that detects SHA-256 drift on existing entries, adds new files matching class globs, and surfaces stale entries for removal confirmation.

What is SHA drift detection and when do I need to refresh my index?▼

SHA drift detection identifies modified files by comparing hashes against the manifest. You need to refresh the index when SHA-256 drift is detected pre-dispatch to maintain index fidelity.

How do I reindex a specific file or class scope instead of the whole repository?▼

You can reindex a specific scope by providing a file or class argument. The protocol applies manifest globbing to target only the selected scope rather than the entire repository.

Does the reindex process automatically delete stale entries from the manifest?▼

No, the reindex process prompts for user confirmation before removing stale entries or performing irreversible changes. It performs sample-and-check and surfaces diffs for user decision.

What's the best way to audit changes when refreshing an index against repository state?▼

The best way to audit index changes is using a protocol that updates manifest data and performs sample-and-check. It surfaces drift, new files, and stale entries to preserve index fidelity.

Can I target specific class globs when reconciling the index?▼

Yes, scope-aware reconciliation supports targeting specific class globs defined in the manifest. This allows you to apply updates only to matching files rather than the whole repository.

Related Skills

Explore More Software Engineering Skills→
ConsiliencyConsiliency
8

spec-discovery

Parse specs to extract IDs, titles, and SHA-256 hashes into a JSON or TOON manifest.

Official
Basic
robertpellonirobertpelloni
2

requesting-code-review

Dispatch code-reviewer to classify issues by severity and confirm merge readiness.

Community
Intermediate
LeKayLeKay

scope-check

Detect and quantify scope creep by comparing current project scope against original plans.

Community
Advanced
dadwadw233dadwadw233
3

checkpoint

Automate team checkpoint updates to CURRENT, NEXT, RISKS, and TODO.

Community
Intermediate