This directory is the repo-local system of record for maintainers and coding agents. Keep the README focused on package users, and keep durable maintenance truth here.
- Understand the library shape: architecture.md
- Check exact public behavior: api-contracts.md
- Run or update validation: quality.md
- Prepare a release: releasing.md
- Improve repo legibility: legibility-audit.md
src/paintcan/hsba_color.pyowns HSBA component validation and adjustments.src/paintcan/color_scheme.pyowns generated scheme collections.src/paintcan/__main__.pyowns the terminal demo.tests/test_hsba_color.pyandtests/test_color_scheme.pyencode the public behavior contracts.tests/test_repo_legibility.pykeeps the docs and validation surface wired.
Planning docs should stay forward-looking. Once work is implemented, move durable truth into the relevant current-state document instead of leaving completed task history in a plan.