Imported from TrebuchetDynamics/flutter-fractal-forge (lib/core/shaders/AGENTS.md). Install upstream with npx skills add TrebuchetDynamics/flutter-fractal-forge --skill shaders. Copyright stays with the author.

shaders

Purpose

Reserved for Dart-side shader helper code. There are currently no active Dart helpers in this directory; uniform slot contracts live under lib/core/modules/builders/ next to the module builders that use them.

Key Files

None currently.

For AI Agents

Working In This Directory

• This is NOT where GLSL shader files live (those are in project-root shaders/)
• Prefer keeping uniform layout contracts near their module builders unless multiple live callers need a shared helper.

Dependencies

Internal

• Active uniform slot constants live in modules/builders/uniform_layout.dart.

Karpathy-Inspired Agent Guardrails

Source: https://github.com/forrestchang/andrej-karpathy-skills at commit 2c60614.

These guardrails supplement the local instructions above. Local project, safety, and user-specific rules win on conflict.

Tradeoff: they bias toward caution over speed for non-trivial work; use judgment for obvious one-line fixes.

Think Before Coding

• State assumptions before implementing; ask when uncertainty would change the solution.
• Surface multiple interpretations and tradeoffs instead of silently picking one.
• Push back when a simpler approach meets the goal.

Simplicity First

• Build the minimum code that solves the requested problem.
• Avoid speculative features, single-use abstractions, and unnecessary configurability.
• If the solution is growing large, stop and simplify before continuing.

Surgical Changes

• Touch only files and lines required by the request.
• Preserve existing style, comments, and nearby code unless the task requires changing them.
• Clean up only dead code introduced by your own change; mention unrelated dead code instead of deleting it.

Goal-Driven Execution

• Convert the request into verifiable success criteria before editing.
• For multi-step work, state a short plan with a verification check for each step.
• Loop until the relevant tests, builds, or manual checks prove the goal is met.

Project-Specific Karpathy Adjustment

This section localizes the Karpathy guardrails for workspace-sidon/trebuchet-dynamics/flutter-fractal-forge/lib/core/shaders. Source inspiration: https://github.com/forrestchang/andrej-karpathy-skills at commit 2c60614.

• Project family: Sidon fractal/rendering and visual-app workspace.
• Local focus: GPU/fractal rendering, Flutter/Electron apps, shaders, accessibility, and measurable visual behavior.
• Stack cues: Flutter/Dart.
• Evidence to prefer: test output, analyzer/linter output, screenshot/pixel checks when relevant, shader compile logs, frame/performance metrics, and exact UI state text.
• Surgical boundary: do not rely on visual vibes; validate rendering numerically and describe results in screen-reader-friendly text.
• Stop and ask when: a visual requirement lacks measurable acceptance criteria or accessibility impact is uncertain.