opensite-ai/opensite-skills / large-scale-refactor
large-scale-refactor
UnverifiedGuardrails, protocols, and operating constraints for large-scale, long-running, or parallelized AI coding tasks — migrations, codebase-wide refactors, framework upgrades, and any task touching 50+ files. Prevents scope creep, context drift, silent compounding errors, and emergent behavior outside the defined task boundary. Use when refactoring across files, migrating frameworks, upgrading dependencies, replacing or renaming patterns throughout a codebase, or any task touching 50+ files.
| File | Kind | Size |
|---|---|---|
| CONTRIBUTING.md | markdown | 1.5 KB |
| README.md | markdown | 7.7 KB |
| SKILL.md | skill md | 17.9 KB |
| agents/openai.yaml | config | 5.4 KB |
| examples/complete-workflow.md | markdown | 9.8 KB |
| examples/refactor-spec.md | markdown | 2.2 KB |
| references/activation.md | markdown | 4.9 KB |
| scripts/generate_allowlist.pyexecutable | script | 8.9 KB |
| scripts/test_verify_scope.py | script | 7.8 KB |
| scripts/verify_scope.pyexecutable | script | 7.6 KB |
| templates/change-manifest.md | markdown | 1.6 KB |
| templates/observations.md | markdown | 2.9 KB |
| templates/refactor-scope-allowlist.example | other | 5.5 KB |
| templates/session-handoff.md | markdown | 6.1 KB |
templates/change-manifest.md
View on GitHub# Change Manifest Template
```
CHANGE MANIFEST — <subtask-id>
==============================
Task: <task-name>
Completed: <ISO datetime>
Files modified: <N>
Files created: <N> (should be 0 for pure refactors)
Files deleted: <N>
### Modified Files
| File | Change Type | Lines +/- | Notes |
|------|-------------|-----------|-------|
| src/Button.tsx | Type annotation | +12/-3 | Added Props interface |
| src/api/user.ts | Import update | +2/-2 | Changed import extension |
| src/utils/helpers.ts | Type conversion | +8/-0 | Added return types |
### Scope Compliance
- [x] All modified files were in the IN SCOPE list
- [x] No files were created outside spec-defined outputs
- [x] No dependencies were added or removed beyond spec-allowed
- [x] No new abstractions or systems were created
- [x] All drift checks passed (logs attached in drift-check-<subtask-id>.md)
### Test Results
- Before: 450 passed, 12 failed
- After: 450 passed, 12 failed
- New failures: none
- Pre-existing failures: Listed in pre-existing-failures.md
### Drift Check Log
```
DRIFT CHECK — <subtask-id>
Files touched so far: 42
Task: js-to-ts-migration
1. Does every changed file appear in the IN SCOPE list? YES
Evidence: All files in src/components/, src/hooks/, src/utils/
2. Did I add any new files not defined in the spec? NO
List: N/A
3. Did I add, remove, or modify any dependency? NO
List: N/A
4. Did I make any change that fails the Substitution Test? NO
All changes were strictly necessary for TypeScript conversion
5. Did I create any new abstraction, utility, or system? NO
No new files or systems created
```
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |