From 67cf0533b93cab4decdfc9da720369e5a7973213 Mon Sep 17 00:00:00 2001 From: Poonam Rajput Date: Wed, 29 Apr 2026 15:56:49 +0100 Subject: [PATCH 1/8] add redirect to full AI use guidelines --- tooling/common-config/netlify.toml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/tooling/common-config/netlify.toml b/tooling/common-config/netlify.toml index 77709f71e..37688437e 100644 --- a/tooling/common-config/netlify.toml +++ b/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] From cdcceb13feebadc25c21b20e9af3c71eef99a8a7 Mon Sep 17 00:00:00 2001 From: Poonam Rajput Date: Wed, 29 Apr 2026 15:57:31 +0100 Subject: [PATCH 2/8] add AI use guidelines to ITP welcome prep --- .../en/module/onboarding/itp-ai-use/index.md | 67 +++++++++++++++++++ org-cyf/content/itp/welcome/prep/index.md | 3 + 2 files changed, 70 insertions(+) create mode 100644 common-content/en/module/onboarding/itp-ai-use/index.md diff --git a/common-content/en/module/onboarding/itp-ai-use/index.md b/common-content/en/module/onboarding/itp-ai-use/index.md new file mode 100644 index 000000000..0e5472fe2 --- /dev/null +++ b/common-content/en/module/onboarding/itp-ai-use/index.md @@ -0,0 +1,67 @@ ++++ +title="Acceptable AI Use" +time=5 +objectives = [ + "Understand the acceptable and unacceptable uses of AI during the ITP." +] +hide_from_overview="true" +[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. + +{{}} + +To read the full AI guidelines for trainees please see here: [AI Use Guidelines for Trainees](/ai-use-guidelines) diff --git a/org-cyf/content/itp/welcome/prep/index.md b/org-cyf/content/itp/welcome/prep/index.md index 41c0b4493..5d7501df8 100644 --- a/org-cyf/content/itp/welcome/prep/index.md +++ b/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]] From 17d23da9a2eeec1d630ae4fbd6676a91bf747d69 Mon Sep 17 00:00:00 2001 From: Poonam Rajput Date: Wed, 29 Apr 2026 15:57:47 +0100 Subject: [PATCH 3/8] attempt to add AI use guidelines into Guides --- org-cyf-guides/content/ai-usage/index.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 org-cyf-guides/content/ai-usage/index.md diff --git a/org-cyf-guides/content/ai-usage/index.md b/org-cyf-guides/content/ai-usage/index.md new file mode 100644 index 000000000..1c7f5e450 --- /dev/null +++ b/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). From c7752adda2a95904d6bfac07b9e35217da14deee Mon Sep 17 00:00:00 2001 From: Poonam <61753159+Poonam-raj@users.noreply.github.com> Date: Tue, 5 May 2026 09:54:49 +0100 Subject: [PATCH 4/8] Update common-content/en/module/onboarding/itp-ai-use/index.md Co-authored-by: Daniel Wagner-Hall --- common-content/en/module/onboarding/itp-ai-use/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/common-content/en/module/onboarding/itp-ai-use/index.md b/common-content/en/module/onboarding/itp-ai-use/index.md index 0e5472fe2..18533f6a4 100644 --- a/common-content/en/module/onboarding/itp-ai-use/index.md +++ b/common-content/en/module/onboarding/itp-ai-use/index.md @@ -2,7 +2,7 @@ title="Acceptable AI Use" time=5 objectives = [ - "Understand the acceptable and unacceptable uses of AI during the ITP." + "Explain acceptable and unacceptable uses of AI during the ITP." ] hide_from_overview="true" [build] From 6dab9c7036f5fc066c23bfd57db7e10d0f6b2863 Mon Sep 17 00:00:00 2001 From: Poonam <61753159+Poonam-raj@users.noreply.github.com> Date: Tue, 5 May 2026 09:55:12 +0100 Subject: [PATCH 5/8] Update common-content/en/module/onboarding/itp-ai-use/index.md Co-authored-by: Daniel Wagner-Hall --- common-content/en/module/onboarding/itp-ai-use/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/common-content/en/module/onboarding/itp-ai-use/index.md b/common-content/en/module/onboarding/itp-ai-use/index.md index 18533f6a4..bce7701cc 100644 --- a/common-content/en/module/onboarding/itp-ai-use/index.md +++ b/common-content/en/module/onboarding/itp-ai-use/index.md @@ -4,7 +4,6 @@ time=5 objectives = [ "Explain acceptable and unacceptable uses of AI during the ITP." ] -hide_from_overview="true" [build] render = 'never' list = 'local' From 08c31676b73516cc11965780de6cc9edf6f3440d Mon Sep 17 00:00:00 2001 From: Poonam Rajput Date: Fri, 8 May 2026 10:59:15 +0100 Subject: [PATCH 6/8] add redirect to AI cheat sheet --- tooling/common-config/netlify.toml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/tooling/common-config/netlify.toml b/tooling/common-config/netlify.toml index 37688437e..593f1fa7e 100644 --- a/tooling/common-config/netlify.toml +++ b/tooling/common-config/netlify.toml @@ -65,6 +65,11 @@ from = "/ai-use-guidelines" to = "https://docs.google.com/document/d/1Rq3dh3yE7sqkBM1cTPP6-f2CSO4lhdhi_2yXxAV3EfA/edit?tab=t.0#heading=h.3kept1c7ccss" status = 302 +[[redirects]] +from = "/ai-use-cheat-sheet" +to = "https://docs.google.com/document/d/1RnXEK3BXzfcdr03I9D0hPZn61BbApD3-i76zHGU_hs0/edit?tab=t.0" +status = 302 + [functions] directory = "tooling/netlify/functions" external_node_modules = ["node-fetch"] From f3b6bb0b5d4b7d38f16fb11e5cc979ae715bed9d Mon Sep 17 00:00:00 2001 From: Poonam Rajput Date: Mon, 11 May 2026 17:18:29 +0100 Subject: [PATCH 7/8] expand explanation around guides, add cheatsheet link --- org-cyf-guides/content/ai-usage/index.md | 25 +++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/org-cyf-guides/content/ai-usage/index.md b/org-cyf-guides/content/ai-usage/index.md index 1c7f5e450..25b32a574 100644 --- a/org-cyf-guides/content/ai-usage/index.md +++ b/org-cyf-guides/content/ai-usage/index.md @@ -3,4 +3,27 @@ title = 'AI Usage Guidelines' description = 'How we use AI at CYF to prioritise learning' +++ -Find the full AI guidelines [here](/ai-use-guidelines). +AI tools are changing the way the tech industry are approaching software engineering. We know that at CYF we are prioritising people learning excellent technical skills so they can get good jobs in tech. + +At CYF we have found that AI tools are changing the way people learn in a range of ways. Observed uses includes: + +- Making concepts easier to understand, explaining back ideas. +- generating code to solve problems we're giving trainees to demonstrate concepts. +- Using AI to complete large portions of projects +- Problem solving a task they can then code based off of. +- asking difficult questions +- generating written work, emails etc. + +To do enable people to learn necessary skills to land good jobs in tech we have to provide guardrails and guidance around what acceptable AI use is across our courses. + +## AI Use Guidelines + +There is a full set of AI guidelines [here](/ai-use-guidelines). + +These guidelines should outline to everyone how to spot useful vs unhelpful AI use when it comes to our learning goals. It also outlines how acceptable AI use changes as we progress through the courses, from ITD all the way to Launch. The reason these guidelines change across the courses is because we have found we can use AI more accurately when we have the skills to question, re-prompt, or even correct the output of generative AI tools. + +## Volunteer Cheatsheet + +Are you a volunteer who needs a quick reference to help work with students using AI? + +Find a shorter "Cheat Sheet" of how to navigate AI usage with trainees across the courses [here](/ai-use-cheat-sheet). From 5a90445200460460cd44f54a083f3bed7bb76d21 Mon Sep 17 00:00:00 2001 From: Poonam Rajput Date: Mon, 11 May 2026 17:21:27 +0100 Subject: [PATCH 8/8] Merge branch 'poonamr-AI-guidance' of https://github.com/CodeYourFuture/curriculum into poonamr-AI-guidance