spk-doctrine-bulk-edit

Applies occurrence classification guardrails before executing multi-instance rename or migration edits.

1.6k|156|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-doctrine-bulk-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spk-doctrine-bulk-edit
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-doctrine-bulk-edit
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-doctrine-bulk-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Broad rename, replace, or migration edits across a codebase can silently change the wrong occurrences when every match is treated identically. This Skill prevents unsafe bulk edits by requiring a manual occurrence review and classification before any modification happens.

Core Features & Use Cases

  • Pre-Edit Occurrence Review: Requires a manual review of all matches before changing them, so no occurrence is modified blindly.
  • Classification Guardrails: Aligns the occurrence map to eight standard schema categories plus explicit exceptions and moves.
  • Path-Based Review Gate: Treats runtime enforcement as a path-based review gate rather than an AST-semantic classifier, keeping checks deterministic.
  • Use Case: When asked to rename a field across hundreds of files, the Skill first maps every occurrence into classification categories, confirms the edit policy where the blast radius is unclear, then executes the narrowest safe change and verifies representative cases.

Quick Start

Ask the agent to rename a field across the entire repository and have it classify every occurrence before applying the bulk edit.

Frequently Asked Questions about spk-doctrine-bulk-edit

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

FAQPage Schema
How do I safely perform a bulk rename across a codebase?

Perform a manual pre-edit occurrence review before changing any matches. Map every occurrence to the standard classification categories, confirm the edit policy when the blast radius is unclear, then execute the narrowest safe change and verify representative cases.

What is occurrence classification in bulk editing?

Occurrence classification maps each match of a bulk edit into one of eight standard schema categories plus explicit exceptions and moves. This ensures different kinds of matches are handled according to their category rather than being changed identically.

Does this approach use AST analysis to classify occurrences?

No. Runtime enforcement is treated as a path-based review gate, not an AST-semantic classifier. Classification relies on the manual occurrence review and path-based rules rather than semantic code analysis.

When should I confirm edit policy before a bulk edit?

Confirm the edit policy whenever the blast radius of the change is unclear. If you cannot determine how many occurrences will be affected or which categories they fall into, pause and confirm the policy before executing any modification.

What are the limitations of path-based bulk edit enforcement?

Path-based enforcement cannot understand code semantics, so it may miss context-dependent occurrences that an AST-semantic classifier would catch. It works best as a review gate combined with manual occurrence review and representative case verification.