Specs describe the target application on a certain level. CodeSpeak uses LLMs to fill in the gaps and turn the spec into code. In the process, it makes many “micro-decisions” that are captured in the generated code. We might want to alter these micro-decisions, e.g. if there is a low-level bug. For example, let’s say a spec says:
Users can log in with Google
And the generated code contains an incorrect name for the API parameter with Google’s OAuth Client ID. We don’t want to lower the level of the spec and specify the names of all API parameters used, but we need to instruct CodeSpeak to fix the bug.
This is what Code Change Requests (CCRs) are for: changing micro decisions in the code without changing the spec. To open a CCR, create a new file named change-request.cs.md in the root directory. Describe the change you want to make and commit the file. CodeSpeak will pick it up, run the build and commit the changes back to the repo. The file you created will be deleted in this commit.
Previous
Next