Problem: Some controller endpoints have very long descriptions written directly in the controller code. They are this long because Origam AI uses them: the agent reads the endpoint descriptions to learn how to call the API, so they have to be detailed. The result is cluttered controllers that are hard to read and maintain.
Proposal: Move these texts into Markdown files in the Origam AI agent project, so nothing is left in the controllers. Swagger UI keeps showing the descriptions as it does now.
- Files:
Origam.AI.Agent/Prompts/EndpointDescriptions/Model.md,Wizard.mdand so on, stored as embedded resources next to the agent’s other prompts. They use the same format asPrompts/Architect.md: a heading like# POST /Model/MoveNode, with the description text below it. - Swagger UI: Shows the same descriptions as before.