# Questions & Answers

## Q1: For F1: What should the file be named - `progress.txt`, `claude-progress.txt`, or something else? Should it be in the task folder (tasks/{name}/) or in .state/?
**Category:** clarification
**Answer:** progress.txt in the task folder

## Q2: For F1/F2: What format should progress entries use? Options: plain text with timestamps, structured JSON lines, or markdown with headers?
**Category:** clarification
**Answer:** Plain text log file format with [agent name] prefix at start of each row to show which agent performed the action

## Q3: For F2: Should progress be logged automatically by K4000 (e.g., when status changes, features are marked complete) or only when the agent explicitly calls a log tool?
**Category:** clarification
**Answer:** Automatically - K4000 should log progress when status changes, features are marked complete, etc.

## Q4: For F3: How many recent entries should be returned by default when reading progress? Should there be a way to get the full log vs. a summary?
**Category:** clarification
**Answer:** Everything needed for a task to have enough context - return the full log by default

## Q5: For F4: Is git integration essential for MVP, or should we start with just the progress log file and add git correlation later?
**Category:** other
**Answer:** Git integration can be added later - not essential for MVP

## Q6: Should progress entries include structured metadata (e.g., feature_id, action_type) or just free-form text descriptions?
**Category:** clarification
**Answer:** Free-form text descriptions are OK
