Skip to content

docs(refactor): add evidence-based refactoring directive for implementation models#281

Merged
01rabbit merged 1 commit into
mainfrom
docs/refactor-instructions
Jun 11, 2026
Merged

docs(refactor): add evidence-based refactoring directive for implementation models#281
01rabbit merged 1 commit into
mainfrom
docs/refactor-instructions

Conversation

@01rabbit

Copy link
Copy Markdown
Owner

Summary

  • add refactor-instructions.md
  • define evidence-based refactoring directives for implementation models
  • document the expected execution discipline for repository refactors

Testing

  • not run (documentation only)

…tation models

Add refactor-instructions.md, a self-contained instruction set produced
from a full repository audit (Python core, web layer, tests/CI, docs/
config/Rust/ops). It defines behaviors to preserve, governance
non-negotiables, stop-and-ask conditions with five open questions, a
28-item debt map with file:line evidence and action classes
(FIX / FIX-Q / PROPOSE), staged implementation phases (safety nets
first, proposals-only for large redesigns), verification requirements,
and out-of-scope boundaries.

Intended usage: pass to an implementation model via
"/goal refactor-instructions.md に書かれたことを完遂しろ".

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@01rabbit 01rabbit merged commit e17d838 into main Jun 11, 2026
5 checks passed
@01rabbit 01rabbit deleted the docs/refactor-instructions branch June 11, 2026 05:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant