obsfx Feedback Protocol
@feedback annotations are inline source code comments that describe desired changes. They use the file's native comment style (//, #, --, /* */, <!-- -->).
Format
// @feedback: <desired change>
// @agent-response: <what was done>
The @agent-response line is added directly below the @feedback line using the same comment style after implementing the change.
Status
- Unaddressed:
@feedbackwith no@agent-responsebelow it - Addressed:
@feedbackfollowed by@agent-responseon the next line - Only unaddressed feedbacks need action
Workflow
- Discover: Grep for
@feedbackin source files, exclude non-source dirs - Parse: Extract file path, line number, feedback text, comment style
- Context: Read surrounding code to understand what the feedback refers to
- Implement: Make the requested change
- Respond: Add
@agent-response: <summary>— max 300 characters. If unable:@agent-response: skipped - <reason>
Proactive Behavior
When encountering @feedback while working on other tasks: note them to the user and offer to address if related. Do not address silently.
Reference
For comment style details and edge cases (multi-line blocks, inline placement, nested comments): see references/comment-patterns.md.