What problem does it solve?
This Skill brings order to the chaotic process of tracking and managing open questions throughout a development lifecycle, preventing missed decisions, inconsistent documentation, and project delays.
Core Features & Use Cases
- Automated QID Generation: Generates unique, sequential
OQ-<FLOW>-<NNN> IDs (e.g., OQ-SIG-001) for open questions, ensuring consistency and easy referencing.
- Structured Appending: Appends new questions to
open_questions.md with full context, including the question, a suggested default, its impact if different, and a timestamp.
- Standardized Tracking: Ensures all open questions are registered in a consistent, auditable format, improving clarity and decision-making.
- Use Case: When a clarifying question arises during the "Signal" phase (e.g., "What is the expected session timeout?"), use this skill to automatically generate a QID and append the question with its suggested default and impact to
open_questions.md, formally tracking it for resolution.
Quick Start
Use the openq-tools skill to append a new question to '.runs/my-feature/signal/open_questions.md' with the prefix 'SIG', asking "What is the maximum file upload size?", suggesting "10MB" as default, and noting "Larger files require chunking" as impact.
