AI Guidance

common-content/en/module/onboarding/itp-ai-use/index.md

@@ -0,0 +1,66 @@
++++
+title="Acceptable AI Use"
+time=5
+objectives = [
+  "Explain acceptable and unacceptable uses of AI during the ITP."
+]
+[build]
+  render = 'never'
+  list = 'local'
+  publishResources = false
++++
+
+This is the most critical stage for your development. You are building the fundamental understanding of programming logic, problem-solving, and computational thinking that everything else depends on.
+
+**_Using AI to generate code at this stage undermines this foundation._**
+
+#### AI IS appropriate for:
+
+- Asking "what does this concept mean?" questions (e.g. "explain what a loop does")
+- Getting alternative explanations when documentation is unclear
+- Asking AI to explain why a piece of code you have already written works the way it does
+- Exploring "what happens if I change this?" questions.
+- Understanding error messages you have encountered yourself
+
+#### AI is NOT appropriate for:
+
+- Generating solutions to assignments
+- Debugging code you have not tried to debug yourself first
+- Writing any code you could not reproduce and explain yourself
+- Answering written reflection questions or self-assessments
+
+_**The test:** If you deleted your solution and had to recreate it on your own from scratch, without AI, could you?_
+
+If not, you have not learned it yet, regardless of whether the code works. Good learning means your skills grow each time you use AI, not become more dependent on it.
+
+#### Prompting for understanding, not answers
+
+When you do use AI at this stage, frame your questions to push your own thinking:
+
+- Not appropriate: “Write me a function that finds the largest number in an array”
+
+- Appropriate: “I wrote this function [paste your code]. Can you explain what each line does and tell me if there is anything I might be missing?”
+- Appropriate: “My code gives this error [paste error]. Can you explain what this type of error means so I can work out how to fix it?”
+
+#### Building understanding that lasts:
+
+Remember: You shouldn't have to ask AI the same thing twice. If you find yourself asking similar questions repeatedly, that's a sign you're using AI to do the work rather than to learn.
+
+- ❌ Today: 'Write a function to find the largest number in an array'
+
+  Tomorrow: 'Write a function to find the smallest number in an array'
+  (You've learned nothing - you'll need AI every time)
+
+Whereas in the following scenario, actual learning is demonstrated.
+
+- ✅ Today: 'I'm trying to find the largest number in an array. Can you explain the approach without writing code?'
+
+  Tomorrow: You write the function yourself to find the smallest number because you understood the approach.
+
+{{<multiple-choice
+  question="What is an example of acceptable use of AI?"
+  answers="Write a function that capitalises all the strings. | Generate the code solution for this coding task. | What happens if a `var` is changed to `let` in this code?"
+  feedback="No, this uses AI to do the logic for us - so we don't learn how to problem solve. | No! This is unacceptable because where AI is used to generate an answer for us, instead of helping support our understanding. | Yes, that is a good question explore the code deeper to help your understanding grow!"
+  correct="2" >}}
+
+To read the full AI guidelines for trainees please see here: [AI Use Guidelines for Trainees](/ai-use-guidelines)

org-cyf-guides/content/ai-usage/index.md

@@ -0,0 +1,6 @@
++++
+title = 'AI Usage Guidelines'
+description = 'How we use AI at CYF to prioritise learning'
++++
+
+Find the full AI guidelines [here](/ai-use-guidelines).

org-cyf/content/itp/welcome/prep/index.md

@@ -18,6 +18,9 @@ src="module/onboarding/goals"
 name="Expectations"
 src="module/onboarding/expectations"
 [[blocks]]
+name="Acceptable AI Use"
+src="module/onboarding/itp-ai-use"
+[[blocks]]
 name="Help"
 src="module/onboarding/help"
 [[blocks]]

tooling/common-config/netlify.toml

@@ -60,10 +60,16 @@ from = "/trainee-expenses-docs"
 to = "https://docs.google.com/document/d/1UuPLflvuSED3XczbzGzgj2utwzXbWP-fxKMkqLaqHo4/edit?tab=t.0#heading=h.7pmxr8snfzh5"
 status = 302
 
+[[redirects]]
+from = "/ai-use-guidelines"
+to = "https://docs.google.com/document/d/1Rq3dh3yE7sqkBM1cTPP6-f2CSO4lhdhi_2yXxAV3EfA/edit?tab=t.0#heading=h.3kept1c7ccss"
+status = 302
+
 [functions]
 directory = "tooling/netlify/functions"
 external_node_modules = ["node-fetch"]
 
+
 [[headers]]
   for = "/dummy-apis/*"
     [headers.values]