diff --git a/common-content/en/module/tools/sdc-ai-use/index.md b/common-content/en/module/tools/sdc-ai-use/index.md new file mode 100644 index 000000000..a813ad77f --- /dev/null +++ b/common-content/en/module/tools/sdc-ai-use/index.md @@ -0,0 +1,55 @@ ++++ +title="Acceptable AI Use" +time=5 +objectives = [ + "Explain acceptable and unacceptable uses of AI during the SDC.", + "Check whether your AI use is appropriate or not for the SDC." + +] +[build] + render = 'never' + list = 'local' + publishResources = false ++++ + +By the SDC, you have the foundational understanding needed to evaluate and challenge what AI tooling produces. This is where learning when and when not to use AI as a professional tool becomes part of your training. Your responsibility does not change. You must be able to **explain, modify, debug, and defend any code you submit**, regardless of whether AI helped produce it. + +To read the full AI guidelines for trainees please see here: [AI Use Guidelines for Trainees](/ai-use-guidelines). + +#### AI is appropriate for: + +- Exploring architectural approaches and trade-offs ("What are the pros and cons of approach A vs B for this problem?") +- Generating repetitive code that you already understand and could write yourself. +- Reviewing and improving code you have already written. Example prompts: _“Here is my code. What improvements could make it more readable or maintainable?”_ +- Identifying potential edge cases you might not have considered, after you have already attempted to think through them yourself. +- Using AI APIs to build ambitious project features + +#### Always required: + +- You must be able to explain all code in your submissions +- You must be able to modify and debug AI-generated code independently +- Treat AI like a colleague whose work you are responsible for reviewing, not an authority whose output you submit unchecked + +> [!IMPORTANT] +> +> ##### You must ensure you are still learning: +> +> At this stage, you can use AI more actively, but check yourself: +> +> Are you asking AI to do things you could do yourself but want done faster (good productivity use), or things you couldn't do yourself (sign you're skipping learning)? +> +> **The repetition test still applies:** If you'll need AI to do the same type of task next time, you haven't learned enough yet. + +#### Using AI for code review: + +Ask AI to review your code rather than write new code. Frame it like this: + +- "Here is my code [paste]. What might I be missing? What edge cases should I consider?" +- "Here is my code [paste]. How could I improve its readability without changing what it does?" +- "Explain the security implications of this approach [paste]." + +{{}} diff --git a/org-cyf/content/sdc/tools/prep/index.md b/org-cyf/content/sdc/tools/prep/index.md index 140ff1abf..d56179f81 100644 --- a/org-cyf/content/sdc/tools/prep/index.md +++ b/org-cyf/content/sdc/tools/prep/index.md @@ -5,6 +5,9 @@ layout = "prep" menu_level = ["module"] weight = 1 [[blocks]] +name = "Read the SDC AI Guidelines" +src = "module/tools/sdc-ai-use" +[[blocks]] name = "Install a unix based os" src = "module/js1/check-unix-os" [[blocks]]