By name: project_development description: Use standardized scripts to manage the project environment, testing, and linting.
Project Development Skill
This skill teaches you how to interact with the Supernote codebase using standardized scripts, following the "Scripts to Rule Them All" pattern.
Core Scripts
| Script | When to use |
|---|---|
script/bootstrap |
After cloning or when dependencies change. |
script/test |
Before submitting changes or to verify functionality. |
script/lint |
Before committing to ensure code style and quality. |
script/server |
When you need a running server for integration testing or manual verification. |
script/db_revision |
To generate a database migration revision. |
Usage Patterns
Standard Development Flow
- Initialize:
./script/bootstrap - Implement: Make your changes to the code.
- Database: If you changed models, run
./script/db_revision "...". - Lint:
./script/lintto check for style issues. - Test:
./script/testto run the test suite. - Verify:
./script/serverto run an ephemeral server for manual checks.
Notes
- All scripts are located in the
script/directory at the project root. - Scripts are designed to be run from the project root.
- The scripts will automatically use
uvif it is installed, otherwise they will fall back to standard Python tools.