Docs
This folder keeps only the documentation needed to understand and maintain the extension without turning docs into a second copy of the code.
Files
contract.md— external behavior, result shape, and UX guaranteesarchitecture.md— module boundaries and invariants../skills/ask-user/SKILL.md— optional agent-side decision-gate guidance
Reading order
- start with
contract.mdfor behavior - read
architecture.mdfor code layout
Rule of thumb
If a detail is about implementation mechanics, it should usually live in src/ or tests/, not here.