Setup Structure Index

Installa un indice di codebase a due livelli (mappa file CLAUDE.md + YAML per directory) con un hook che ne impone la manutenzione.

di shannonbay · shannonbay/setup-structure-index

Promosso ★ 9.6/10

Setup Structure Index — Installa un indice di codebase a due livelli (mappa file CLAUDE.md + YAML per directory) con un hook che ne impone la manutenzione.

Cosa fa

Configura una mappa file compatta a costo zero all'interno di CLAUDE.md più file YAML di firma di esportazione dettagliati per directory in .claude/structure/, e collega un hook TaskCompleted che blocca il completamento del task quando file/classi/funzioni vengono aggiunti, rimossi o rinominati senza aggiornare l'indice. Si attiva su "set up structure index", "add codebase structure tracking", "create structure files", o "set up code structure YAML".

Rapporto di test

Costruita la mappa file CLAUDE.md prescritta, .claude/structure/*.yaml e l'hook TaskCompleted di .claude/settings.json su un repo di 4 file usa e getta; tutti e tre gli artefatti sono stati analizzati come JSON/YAML validi, a differenza delle note in prosa statiche della baseline che non comportano alcuna applicazione. Confermato indipendentemente contro lo schema delle impostazioni di Claude Code installato localmente che TaskCompleted è un evento hook genuino, non inventato.

Testato il: 2026-07-15 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/shannonbay/setup-structure-index
cd setup-structure-index
mkdir -p ~/.claude/skills
cp -r . ~/.claude/skills/setup-structure-index

Comandi e prompt di esempio

  • /setup-structure-indexInstalla un indice di codebase a due livelli (mappa file CLAUDE.md + YAML per directory) con un hook che ne impone la manutenzione.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Set up a structure index so my CLAUDE.md stays in sync with the codebase
  • Add per-directory YAML export signatures and a hook to enforce updates
  • Create a codebase structure map that blocks tasks when files get renamed