Python

The dashboard service is a generic API and UI layer. It has no knowledge of git, files, or roadmap structure. Agents ...

Use SQLite with WAL mode for concurrent read access. No ORM — use direct SQL via the `sqlite3` standard library module.

Always use the roadmap file's own UUID from its YAML frontmatter. Never generate random UUIDs. IDs must be determinis...

Use `pathlib.Path`, not `os.path`. All path manipulation should go through `pathlib`.

`roadmap_lib` uses the standard library only. Do not add PyYAML, requests, or other third-party packages to core libr...

Shell script `main()` functions must only call other functions — no inline logic. Keep scripts composable and testable.

Type hints are welcome but not required. Maintain Python 3.9 compatibility — use `from __future__ import annotations`...

Use functions from `roadmap_lib` for all roadmap operations (reading state, parsing frontmatter, finding steps, etc.)...

Use Flask for web services. The dashboard service runs on Flask with a REST API and SSE/polling for live updates.

Parse YAML frontmatter with the built-in frontmatter parser in `roadmap_lib`. Do not add a PyYAML dependency. The par...