Skip to content

astroville/sprout / .claude/skills/deep-code-enrichment

deep-code-enrichment

Verified

Guide for running deep code scanning with LLM-generated symbol descriptions.

Workflow

  1. Run hero scan --code first to ensure the code index is current.
  2. Call hero_code with action: unenriched to get a batch of symbols needing descriptions.
  3. For each symbol, read the source context and write a concise one-line description of what it does.
  4. Call hero_enrich with the descriptions as a JSON array.
  5. Repeat steps 2-4 until no more unenriched symbols are returned.

Description Guidelines

  • One sentence, starts with a verb (e.g. "Handles incoming MCP tool calls and dispatches to handlers")
  • Focus on what the symbol DOES, not its signature
  • Be specific to the codebase, not generic
  • For types/structs: describe what they represent and their role
  • For functions: describe the primary behavior and key side effects
  • Skip trivial getters/setters — describe the business purpose instead
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall