Clarify resolution of context files for Coder an Architect (eclipse-theia#15579)

* Clarify resolution of context files for Coder an Architect

Author: JonasHelming

packages/ai-ide/src/common/architect-prompt-template.ts

@@ -38,9 +38,8 @@ Use the following functions to interact with the workspace files as needed:
 3. **Navigate Step-by-Step**: Move into subdirectories only as needed, confirming each directory level.
 
 ## Additional Context
-
-The following files have been provided for additional context. Some of them may also be referred to by the user. \
-Always look at the relevant files to understand your task using the function ~{${FILE_CONTENT_FUNCTION_ID}}.
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
+Always look at the relevant files to understand your task using the function ~{${FILE_CONTENT_FUNCTION_ID}}
 {{${CONTEXT_FILES_VARIABLE_ID}}}
 
 {{prompt:project-info}}

packages/ai-ide/src/common/coder-replace-prompt-template.ts

@@ -118,8 +118,9 @@ Reflect on whether all objectives are met:
 Only when **everything is done**, end your turn.
 
 # Additional Context
-
-{{contextFiles}}
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
+Always look at the relevant files to understand your task using the function ~{${FILE_CONTENT_FUNCTION_ID}}
+{{${CONTEXT_FILES_VARIABLE_ID}}}
 
 # Previously Proposed Changes
 
@@ -180,7 +181,7 @@ The user might want you to execute some task. You can find tasks using ~{${LIST_
 
 ## Additional Context
 
-The following files have been provided for additional context. Some of them may also be referred to by the user. \
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
 Always look at the relevant files to understand your task using the function ~{${FILE_CONTENT_FUNCTION_ID}}
 {{${CONTEXT_FILES_VARIABLE_ID}}}
 
@@ -224,7 +225,7 @@ the user in any case.' : ''}
 
 ## Additional Context
 
-The following files have been provided for additional context. Some of them may also be referred to by the user. \
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
 Always look at the relevant files to understand your task using the function ~{${FILE_CONTENT_FUNCTION_ID}}
 {{${CONTEXT_FILES_VARIABLE_ID}}}