# Questions & Answers

## Q1: For F4: The current questions.md format has **Answer:** prefix for answered questions and *Pending* for unanswered. Should we keep this format or switch to a more parseable format (e.g., YAML frontmatter per question, or a separate questions.json)?
**Category:** clarification
**Answer:** Use questions.json instead of questions.md for storing questions. This makes parsing simpler and more reliable.

## Q2: For F6: Should the migration be automatic (detect old structure and migrate on first access) or manual (require explicit migrate command)?
**Category:** clarification
**Answer:** Automatic migration - detect old structure and migrate on first access.

## Q3: For F6: After migration, should we automatically delete the .state directory, or leave it for manual cleanup?
**Category:** clarification
**Answer:** Yes, automatically delete the .state directory after migration.

## Q4: For F2: Should review-*.json files be visible in the task folder, or would you prefer them in a hidden subfolder like tasks/my-task/.reviews/?
**Category:** clarification
**Answer:** Hidden subfolder - use tasks/my-task/.review/ to keep the task folder cleaner.
