ftk-refactor-legacy

Files (1)

• SKILL.md

SKILL.md (first lines)

Incremental migration. The app must run after EVERY stage; big-bang rewrites are forbidden.

Resolve the toolkit root from `toolkitPath` in `~/.config/flutter-tools-kit/ftk-settings.json`, then read `knowledge/architecture.md` and `knowledge/riverpod-patterns.md` from it.

## 1. Map (first run only)

Dispatch `ftk-codebase-researcher` to map current conventions: state management in use, folder layout, HTTP client, DI, test coverage. Present the map plus a migration order proposal (leaf features with fewest dependents first). Agree the scope: ONE feature per run.

## 2. Safety net

Before touching the feature: characterization tests that pin its CURRENT observable behavior (repository outputs, notifier/bloc state transitions, key widget rendering). These tests define "still works" — write them against behavior, not implementation.

## 3. Migrate in stages (verify after each: analyze clean, tests green, app boots)

1. **Structure:** move the feature's files into `lib/features/<feature>/{data,domain,presentation}` — imports only, no logic changes.
2. **State:** re-implement the feature's state in Riverpod per `knowledge/riverpod-patterns.md`. Old and new state solutions may coexist ACROSS features (adapter at the boundary), never within one.
3. **Network:** route the feature's HTTP through a repository backed by the shared `dioProvider` (create `core/network/` if this is the first feature).
4. Delete the dead old code the same run — do not leave both paths alive within the migrated feature.

## 4. Finish

Run the FULL suite plus the characterization tests, then re-run the app through the feature's main flow. Report: what moved, adapters introduced (and when they can die), conventions found that deviate from FTK (recorded, not silently "fixed"), and the recommended next feature.

Out of scope, always: refactoring features not in the agreed scope; upgrading packages (that is ftk-update-deps); visual changes.

From adiwirya/flutter-tools-kit, MIT.

More from adiwirya/flutter-tools-kit