Nano Banana Pro
Agent skill for nano-banana-pro
Welcome, autonomous agent! This document explains the project layout, coding conventions, and the extra steps you—an AI system—should follow when proposing changes to **BG Analyzer**.
Sign in to like and favorite skills
Welcome, autonomous agent! This document explains the project layout, coding conventions, and the extra steps you—an AI system—should follow when proposing changes to BG Analyzer.
If your modification changes user‑visible behaviour or usage instructions, you must also update
, sample configuration files, and any other helper docs needed to keep everything in sync.README.md
| Path | What you’ll find | Typical agent tasks |
|---|---|---|
| Parsers that convert device exports (CGM, pump, pen, food logs) into a common schema | Add a new parser, expand the schema, write unit tests |
| Core algorithms for event filtering and ICR/ICF estimation | Optimise maths, add new metrics or context‑aware models |
| Renderers that turn analysis results into Markdown & JSON | Create new output formats, tweak visualisation |
| Click‑based command‑line interface entry point | Extend CLI flags, improve UX messages |
| Example CSV files for manual and CI tests | Add fresh samples when supporting new devices |
| Pytest suite & fixtures | Write tests for every new behaviour |
| Longer‑form design/architecture docs (optional) | Add detailed specs, diagrams |
Sync and plan Read open issues or create one describing the change. Reference it in your PR. If anything is unclear, add a bullet to
QUESTIONS.md so the product owner can respond.
Create a feature branch
feature/<short‑slug> or fix/<short‑slug>.
Write the code
mypy passes).Update documentation
README.md.agents.md or create a doc under /docs/./samples/ if data format changes.QUESTIONS.md is answered, reflect it in the docs and remove that bullet.Validate
pre‑commit run --all-files (black, isort, flake8, mypy, etc.).pytest ‑q—tests must pass and coverage ≥ 90 %.python cli.py --help to ensure CLI still works.Commit Use Conventional Commits:
feat(ingest): add Abbott Libre CSV parser
fix(analysis): handle zero‑carb corrections
Pull Request
ROADMAP.md task status in the same PR (move card or tick box).@maintainers for review.When your change alters:
| Change type | Docs to update |
|---|---|
| CLI flag, config option |  (Quick Start & Expected CSV columns) |
| Device/data source | (Capabilities)Â + |
| Repo structure | + |
| Algorithms/metrics | (Current capabilities)Â + Possibly a new doc under |
Failing to update docs will trigger CI Doc‑Check and block merge.
make demo-report → writes to reports/.make cov.mdformat -i *.md (runs in pre‑commit).The project follows SemVer. The
CHANGELOG.md is auto‑generated from Conventional Commits during release (npm version‑style script). When you merge to main, CI may tag a version bump. Breaking changes require a ! in the commit scope.
Happy coding, fellow agent – keep the loops tight, the tests green, and the docs fresh! 🚀