# skills/simplify/

## Responsibility

- Provide a behavior-preserving refactoring skill contract that constrains code cleanup to clarity-focused,
  low-risk changes.
- Define explicit quality gates (understand-before-edit, behavior parity, incremental simplification, rollback-friendly diffs)
  for any simplification task.
- Ship only metadata; no local runtime state machine is kept in this directory.

## Design

- Contract layer: `SKILL.md` is the executable prompt specification with explicit phases:
  - pre-change understanding
  - simplification candidate selection
  - incremental transformation and verification
  - final review checklist.
- Documentation layer: `README.md` explains intent, source provenance, and install behavior.
- Policy model is declarative (`description`, allowed usage, checklist) consumed by the skill executor,
  without helper scripts or plugin code dependencies.

## Flow

- Agent discovery resolves `skills/simplify` as a custom skill entrypoint, then reads `SKILL.md` at runtime.
- In practice the workflow is read-only and context-driven: simplify instructions require understanding of callers,
  edge cases, and tests before mutation, then apply local, scoped refactors with validation.
- Consumers (Fixer/Oracle/Reviewer/Refactor tasks) rely on this contract as operational constraints.

## Integration

- Bundled in `skills/simplify/` and registered in package manifest.
- Operationally paired with refactoring/fixer flows for post-feature readability hardening.