Codespace Feedback Collaboration
Follow this workflow whenever a task spans multiple code spaces.
Rule #1. Your readme file is the point of reference for other teams as well. Whenever you change part of the logic in your codespace keep it update it. Describe what your app or package is doing, API endpoints or interfaces it exposes and how could someone use it. If there are depenedencies, env vars or requirements please include these too.
Enforce Code Space Boundaries
- •Treat each
apps/<name>orpackages/<name>as a separate code space. - •Edit implementation files only inside your assigned code space.
- •Write outside your code space only as Markdown in
external_feedbackfolders. - •Keep every request and response scoped to the current implementation task.
Run Feedback Loop In This Order
- •Process incoming feedback requests in your code space.
- •Check responses for your own pending feedback requests.
- •Create new outgoing requests for missing dependencies or clarifications.
- •Update your own codespace
README.mdstatus and clean up resolved feedback artifacts.
Process Incoming Requests In Your Code Space
- •Scan
<your_codespace>/external_feedback/broker-interceptor/<requester_codespace>/*.md. - •Read request files that do not end with
_response.md. - •Decide whether to implement, clarify, or reject with rationale. If there is already a
_response.mdfile for the request, skip providing feedback response again. - •Create a response file next to the request using the same basename plus
_response.md. - •If implementation changed, update your code and
README.mdaccordingly.
Use this response filename rule:
- •Request file:
missing_methods.md - •Response file:
missing_methods_response.md
Request Changes Or Clarifications From Another Code Space
- •Open target code space:
apps/<target>orpackages/<target>. - •Create target folder if missing:
external_feedback/broker-interceptor/<your_codespace_name>/. - •Create a request file named for the reason, such as
missing_methods.md. - •Write:
- •What is missing.
- •Why it is needed now.
- •How you will use it.
- •Expected method signatures and behavior.
- •Mark dependent local methods as
*_INCOMPLETEin your code space. - •Add or update
README.mdsectionPending feedbackwith:
- •Target code space.
- •Request filename.
- •Waiting reason.
- •Related
*_INCOMPLETEmethods.
When missing methods drive the request, always use missing_methods.md.
Check Responses To Your Pending Requests
- •Read
README.mdsectionPending feedback. - •For each entry, check target path:
<target_codespace>/external_feedback/broker-interceptor/<your_codespace_name>/<request_name>_response.md. - •Apply received guidance to code, tests, and interfaces.
- •If follow-up is needed, run the follow-up procedure.
- •If resolved, run cleanup and remove waiting entry from
README.md.
Follow Up On Unresolved Feedback
- •Archive prior request and response files in the same feedback folder under a new archive subfolder.
- •If filename collision exists in archive, append
_1,_2,_3, and continue incrementing. - •Create a new request file with the original filename.
- •Include:
- •Short summary of previous request.
- •Summary of received response.
- •New follow-up questions or constraints.
- •Keep
README.mdpending entry updated to the latest request status.
Clean Up Resolved Feedback
- •Remove resolved item from
README.mdsectionPending feedback. - •Move to archive obsolete request files from the target code space
external_feedbackfolder. - •Remove
*_INCOMPLETEsuffixes from methods that are now complete. - •Keep response files only when audit history is explicitly required.
Required Output Checklist For Agent Responses
When finishing a task that used this skill, report:
- •Which code spaces were contacted.
- •Which code spaces you responded to.
- •Which request files were created or answered.
- •Which pending items remain in
README.md. - •Which
*_INCOMPLETEmethods remain and why.