mirror of
https://github.com/hanzoai/frames.git
synced 2026-10-30 14:44:26 +00:00
Every SKILL.md already declared the new name — name: frames, frames-cli, frames-core, and so on — but the directories were never moved, so the tree carried frames-* in content and hyperframes-* on disk. Everything that resolves a skill by path missed: the core-skill list, the plugin marketplace pin, and the docs the CLI reads at runtime. Eight tests failed on main because the files they open do not exist. The directories now match what the files say they are, and the guide the claude-design contract reads takes the name that contract already used.
Tier 4 — escape-hatch
What it tests
T4 is the lint-only tier. There are no renders to diff — the skill is graded on whether it correctly refuses to translate each case (and recommends the runtime interop pattern from PR #214 instead) or, where appropriate, translates after dropping warning-level decorations.
Each cases/*.tsx file is a minimal Remotion composition that
demonstrates one specific pattern. The skill should:
- Run
scripts/lint_source.pyover the source. - Compare the JSON output to
expected.jsonfor that case. - Take the documented
skill_action:refuse_translation_recommend_interop— print the rationale + link to the PR #214 interop guide; do not produce HF output.drop_lambda_code_translate_remainder_if_clean— drop the@remotion/lambdacode with a note; translate the rest only if no other blockers are present.translate_after_dropping_wrappers— translate normally; dropuseCallback/useMemo/delayRenderwrappers.inline_hook_body_if_pure— inline the custom hook's body if it's a pure derivation ofuseCurrentFrame; otherwise bow out.
Cases
| # | File | Expected finding | Notes |
|---|---|---|---|
| 01 | 01-use-state.tsx |
blocker r2hf/use-state |
useState driving animation |
| 02 | 02-use-effect-deps.tsx |
blocker r2hf/use-effect-deps |
useEffect/useLayoutEffect with non-empty deps |
| 03 | 03-async-metadata.tsx |
blocker r2hf/async-metadata |
calculateMetadata returns a Promise |
| 04 | 04-third-party-react.tsx |
blocker r2hf/third-party-react-ui |
imports @mui/material |
| 05 | 05-lambda-config.tsx |
warning r2hf/lambda-import |
imports @remotion/lambda — drops, translates |
| 06 | 06-warnings-only.tsx |
warnings only | delayRender / useCallback / useMemo |
| 07 | 07-custom-hook.tsx |
warning r2hf/custom-hook |
locally-defined useFadeIn (export const form) |
| 08 | 08-mixed.tsx |
3 blockers + 1 warning | aggregate-findings test |
Validation
./validate.sh
The script runs lint_source.py against each case and asserts:
- Each expected blocker rule fires with severity
blocker. - Each expected warning rule fires with severity
warning(or stronger). lint_source.py's exit code is 1 when blockers are expected, 0 otherwise.
T4 passes when every case matches its expected output. No renders involved.