d4t_formulas/CLAUDE.md

Tools available

• This is a flutter app.
• Flutter and Dart are not installed locally. They are executed via a flutter wrapper script, like gradlew (gradle wrapper) for gradle.
• Flutter and Dart are installed in a podman container. This container is invoked via ./flutterw bash script.
  • ./flutterw --build-container to build the image and the container with flutter tools
  • ./flutterw --exec <args> to execute bash commands inside the container
  • ./flutterw <args> is a shorthand for ./flutter --exec flutter <args>, so ./flutterw and flutter are somewhat equivalent.
• Examples:
  • flutter pub get --> ./flutterw pub get
  • flutter run -d linux --> ./flutterw run -d linux
• See ./Makefile for more examples.
• If you are an agent, you may be also containerized. If podman or docker is not available, try distrobox-host-exec ./flutterw

MANDATORY WORKFLOW

1. Only one TODO.md feature at a time
2. Create a git branch for each new feature
3. Implement then new feature, and create tests for the new feature
4. After making any change

• Allways pass all the tests and integration tests
• Build the application for linux and web-server
• Launch the apllication for web-server, with a timeout of 60s

5. If any test or build or web-server launch fails, go to step 3
6. Change TODO.md. Mark the task with [R], than means than the work will be reviewed by a human.
7. Dont merge the feature branch into master, the work will be reviewed by a human.