chore(ai-workflow): track repo-managed review tooling (#1046)

* chore(ai-workflow): track repo-managed review tooling * fix(ai-workflow): remove repo-specific path assumptions Make shared workflow hooks and APK testing guidance resolve paths from the repo and contributor environment so the tooling works for all contributors, not just one machine.
2026-08-03 07:41:04 +02:00 · 2026-03-10 15:49:15 +08:00
parent 878d0ee70b
commit a92b185a66
197 changed files with 20785 additions and 3 deletions
@@ -0,0 +1,47 @@
+---
+name: refactor-pass
+description: Perform a refactor pass focused on simplicity after recent changes. Use when the user asks for a refactor/cleanup pass, simplification, dead-code removal, or says "refactor pass".
+---
+
+# Refactor Pass
+
+## Workflow
+
+1. **Review recent changes** — identify simplification opportunities:
+   - `git diff` for unstaged changes
+   - `git diff --cached` for staged changes
+   - `git log --oneline -5` for recent commits if no uncommitted changes
+
+2. **Apply refactors** (in priority order):
+   - Remove dead code and unreachable paths
+   - Straighten convoluted logic flows
+   - Remove excessive parameters or intermediary variables
+   - Remove premature optimization (unnecessary `useMemo`, `useCallback`, etc.)
+   - Extract duplicated logic into custom hooks (`src/hooks/`) or shared components (`src/components/`)
+
+3. **Verify** — run all three checks:
+   ```bash
+   yarn build && yarn lint && yarn type-check
+   ```
+
+4. **Optional suggestions** — identify abstractions or reusable patterns only if they clearly improve clarity. Keep suggestions brief; don't refactor speculatively.
+
+## Project-Specific Patterns to Enforce
+
+When refactoring, watch for these anti-patterns from AGENTS.md:
+
+| Anti-pattern | Refactor to |
+|---|---|
+| `useState` for shared state | Zustand store in `src/stores/` |
+| `useEffect` for data fetching | bitsocial-react-hooks (`useComment`, `useFeed`, etc.) |
+| `useEffect` to sync derived state | Calculate during render |
+| Copy-pasted logic across components | Custom hook in `src/hooks/` |
+| Boolean flag soup (`isLoading`, `isError`, `isSuccess`) | State machine in Zustand |
+| Prop drilling through many layers | Zustand store |
+
+## Rules
+
+- Don't change behavior — refactors must be semantically equivalent
+- Don't introduce new dependencies
+- Format edited files with `npx oxfmt <file>` after changes
+- If the build/lint/type-check fails after refactoring, fix it before finishing