AI Vibe Coder
Build safe internal tools with AI assistance
A supported, no-prior-coding path for turning a bounded internal workflow into a bilingual prototype in the provided approved starter and managed workspace. All practice uses sandboxed synthetic data, controlled AI assistance, explicit tests, and a documented handover.
Prerequisites
- No prior coding or Python experience is required when using the provided approved starter, managed workspace, and facilitator support
- Basic computer skills: managing files, using browser tabs, copying and pasting, and signing in to an approved workspace
- Ability to describe an everyday work task step by step in Arabic or English
- Agreement to use only course-provided synthetic data and approved sandbox services; no operational, personal, confidential, or secret data
AI-Assisted Building Foundations
Start with a plain-language mental model, choose an approved workspace, and learn how applications, prompts, and AI-assisted changes fit together.
- Present a bounded prototype idea with a named user, current task, expected benefit, excluded high-impact decisions, and accountable owner
- Configure the provided approved starter in the managed sandbox and verify that it uses only course-provided synthetic data and services
- Document how the interface, server, data store, and AI assistant exchange information and apply collaboration rules to one supervised change
Start Here: Build with AI Responsibly
Open one no-install browser starter and define its safe boundary as a local synthetic-data sandbox prototype—not a secure deployed tool.
Set Up a Safe AI Building Workspace
Use the supplied local browser workspace to learn file trees, script order, configuration, dependencies, checks, diffs, reverts, and resets before asking AI to edit.
Work Productively with an AI Assistant
Use AI as a transparent collaborator: give context, request a small change, inspect the result, and verify it before moving on.
How a Small Internal App Works
Trace the supplied static browser app from HTML input through JavaScript validation and synthetic lookup to text-safe bilingual output.
Lab assessment
Work only in the supplied starter and managed sandbox with facilitator support. Do not upload operational, personal, confidential, or secret information.
Submit the approved idea card, workspace safety check, one-page application map, collaboration rules, and evidence of one supervised reversible change.
The idea names one user and task, has a small testable benefit, excludes high-impact automation, and records an accountable approver.
Evidence shows use of the approved account, starter, sandbox, synthetic data, and sharing settings, with no prohibited data or unapproved service.
The map correctly shows user input, interface, server, stored synthetic data, AI assistance, output, and the human decision point.
The rules require clear context, one small change, review before acceptance, a reversible checkpoint, and escalation when the learner cannot verify the output.
Core labels and rules are available in clear Arabic and English without changing scope, responsibility, or safety meaning.
From Workflow to Prototype
Choose a safe internal problem, map the current process, and define a small prototype that can be evaluated by real users.
- Observe and map the current workflow with named users, inputs, decisions, handoffs, delays, exceptions, and the safe manual path
- Write a one-page brief that limits the prototype to one internal task, one primary user, synthetic data, and no automated high-impact decision
- Define observable acceptance criteria for task completion, invalid input, authorization, bilingual use, failure recovery, and user feedback
Choose an Internal Tool Worth Building
Find a small, safe, measurable workflow where a prototype can remove friction for colleagues.
Map the Workflow Before Building
Make users, inputs, decisions, exceptions, and handoffs visible before an AI assistant turns them into screens or code.
Scope the First Version and Define Success
Turn a workflow map into a small, testable scope with observable acceptance criteria and explicit limits.
Lab assessment
Base the brief on an approved observation or course case, not an imagined process. Obtain confirmation from a workflow owner before fixing the prototype scope.
Submit the one-page brief, current-state map, evidence notes, scope and exclusions, prioritized acceptance criteria, and owner confirmation.
The map is supported by approved observation or case evidence and accurately includes actors, inputs, decisions, handoffs, exceptions, and delays.
The brief distinguishes the user problem from a proposed technology and defines one feasible task, owner, user group, boundary, and explicit exclusions.
Criteria are observable and test normal, invalid, unauthorized, bilingual, and failure paths rather than visual completion alone.
High-impact decisions and prohibited data are excluded, assumptions and unresolved exceptions are visible, and a workable manual fallback is retained.
Arabic and English headings, workflow labels, and acceptance statements are consistent and usable by the named internal audience.
Design a Usable Internal Interface
Create a focused, bilingual interface that helps colleagues complete a task correctly without hiding uncertainty or errors.
- Build the primary internal task flow in Arabic RTL and English LTR with equivalent steps, controls, content, and completion states
- Prototype forms that label required information, constrain synthetic inputs, preserve user entries, and provide actionable validation and recovery feedback
- Demonstrate keyboard, focus, contrast, zoom, language-switch, loading, empty, error, success, and permission-denied states
Design for One User and One Task
Use a focused task flow, meaningful language, and visible next steps to make an internal tool genuinely useful.
Forms, Validation, and Clear Feedback
Help users provide the right information, understand mistakes, and recover safely when a request cannot be completed.
Design for Arabic, English, and Accessibility
Treat bilingual content and accessibility as core product requirements, not last-minute translations or visual polish.
Lab assessment
Prototype the approved task at sufficient fidelity to test behavior, not visual polish alone. Use only synthetic records and include all required states in both languages.
Submit the shareable prototype, flow index, synthetic test records, completed accessibility check, bilingual content sheet, and findings from one moderated task walkthrough.
A named user can enter, review, correct, submit, and confirm the task without dead ends, hidden requirements, or loss of entered data.
Fields, constraints, validation timing, messages, and loading, empty, error, success, and permission states match the acceptance criteria.
Keyboard order, visible focus, labels, contrast, zoom, error identification, and non-color cues are checked with recorded results and fixes.
The interface makes scope, data status, permissions, uncertain or failed actions, and the safe next step visible without deceptive confirmation.
RTL and LTR layouts, content meaning, control order, validation, and recovery are equivalent and have been reviewed by an Arabic-English reviewer.
Data and Safe Workflows
Use mock data, explicit workflow rules, and role-aware access to make an internal prototype useful and safe.
- Create a synthetic dataset and field dictionary whose records, types, required values, constraints, and generated provenance support the approved workflow
- Implement and demonstrate allowed status transitions, rejected transitions, validation messages, and named human handoffs
- Configure least-access roles and produce audit notes that identify actor, action, record, time, outcome, and reason without recording secrets
Use Data Safely in an Internal Tool
Understand records, fields, mock data, validation, and the information boundary before connecting any real source.
Model Workflow Rules and States
Turn a process into explicit allowed states and transitions so an internal tool behaves predictably.
Roles, Permissions, and Audit Notes
Model future least-privilege needs without pretending that a static synthetic browser prototype implements authentication, authorization, or secure audit.
Lab assessment
Extend the supplied prototype with the smallest data and workflow model that satisfies the brief. Use generated synthetic records only and test each role separately.
Submit the field dictionary, synthetic dataset, state diagram, role-permission matrix, runnable workflow, scenario evidence, and redacted audit sample.
Records cover normal, boundary, missing, invalid, duplicate, and unauthorized scenarios, follow the field dictionary, and cannot be mistaken for real people or cases.
Implemented states and transitions match the diagram, reject impossible moves, preserve valid data, and route exceptions to a named human.
Each role can perform only listed actions, forbidden actions fail safely, and evidence covers both allowed and denied cases.
Audit entries answer who did what, when, to which synthetic record, and with what result, while excluding credentials and unnecessary content.
Arabic and English status, validation, permission, and handoff messages are equivalent, actionable, and consistent with the implemented state.
Build Features with an AI Assistant
Give an AI assistant clear project context, make one controlled change at a time, and review its output like a responsible engineer.
- Prepare an AI request that includes the approved goal, relevant project context, constraints, examples, files in scope, and observable completion checks
- Use the provided support workflow to generate and apply one small reversible feature change without accepting unrelated edits or dependencies
- Complete a line-by-line diff review and run a focused normal, invalid, and regression check before accepting the change
Give an AI Assistant Useful Project Context
Write clear, safe change requests that help an AI assistant contribute without inventing requirements or receiving confidential data.
Build One Feature at a Time
Break a prototype into small vertical changes that are easy to inspect, test, explain, and undo.
Review AI-Generated Changes
Learn enough code-review vocabulary to inspect AI output, spot risky changes, and ask precise follow-up questions.
Lab assessment
Choose one acceptance criterion and implement only the change needed to satisfy it in the approved starter. Stop and ask for facilitator review whenever you cannot explain a generated line.
Submit the before-and-after checkpoint, AI request and response, scoped diff, completed review checklist, focused test and output, and acceptance decision.
The request supplies enough verified context to implement one criterion, names constraints and exclusions, and does not include prohibited data.
The resulting behavior satisfies the selected criterion for normal and invalid input without breaking the previously demonstrated workflow.
Every changed file and material line is accounted for; unrelated edits, unexplained code, unsafe configuration, and unnecessary dependencies are rejected.
A repeatable check fails before or would detect absence of the change, passes afterward, covers invalid input, and the saved checkpoint restores the prior version.
Any changed labels, messages, validation, or help remain equivalent and usable in Arabic and English.
Test, Protect, and Hand Over the Tool
Test the useful and unsafe paths, protect information, and prepare a colleague to operate or improve the prototype.
- Execute and record normal, boundary, invalid, unauthorized, interrupted, and recovery scenarios against the current non-AI workflow prototype
- Complete a privacy and secrets inspection that proves the prototype, prompts, configuration, screenshots, logs, and repository contain only approved synthetic information
- Issue a conditional release decision and handover note with scope, access rules, known defects, operating steps, safe fallback, owner, and stop conditions
Test and Debug the User Journey
Use small, repeatable scenarios to find broken behavior and ask an AI assistant for a focused correction.
Protect Information, Secrets, and People
Keep confidential information, credentials, and risky data flows out of a beginner prototype and AI-assisted workflow.
Prepare a Safe Release and Handover
Decide whether the prototype is ready to share internally, document its limits, and prepare a colleague to operate it safely.
Lab assessment
Treat this as the mandatory pre-AI gate for the current non-AI prototype. Do not connect an AI feature until this artifact scores at least 80 and every critical privacy or authorization failure is closed.
Submit the test plan and results, defect log, privacy and secret checklist, sanitized evidence, release decision, and handover note acknowledged by a colleague.
The plan traces acceptance criteria to repeatable scenarios and records expected, actual, pass or fail, evidence, and defect references for each.
Normal, invalid, unauthorized, interruption, retry, and recovery behavior matches the brief, with no unresolved critical defect.
A documented inspection covers data, prompts, configuration, history, logs, exports, screenshots, and sharing; prohibited information is absent and credentials are managed by the approved workspace.
The decision follows the evidence, distinguishes pass, conditional pass, and stop conditions, and exposes defects, unsupported use, and the manual fallback.
A colleague can use the Arabic-English handover to access, operate, test, stop, recover, and seek support for the prototype without oral instructions.
Add AI Only Where It Helps
Decide when a normal workflow is enough, then add a bounded drafting or knowledge-helper feature with approved sources and safe fallbacks.
- Use evidence from the non-AI workflow to justify one bounded language task and document why a deterministic alternative is insufficient
- Configure the helper to use only the supplied approved course sources, display valid citations, and refuse unsupported or out-of-scope requests
- Demonstrate human review, input and output limits, timeout and error fallback, and no action on a generated result without confirmation
Decide When AI Actually Helps
Choose a normal rule, search, form, or workflow when it is more reliable than an AI feature—and add AI only for the right job.
Build a Bounded AI Drafting Feature
Use a deterministic fake AI adapter first, then inspect a disabled approved-provider seam with no client credential; validate exact results, deny tools, and render text safely.
Build a Knowledge Helper with Sources
Help a colleague find an answer from approved sample guidance while showing the source and abstaining when evidence is missing or conflicting.
Lab assessment
Begin only after the Test, Protect, and Hand Over artifact has passed its 80% gate. Add one read-only helper in the approved sandbox and rerun the prior privacy and regression checks.
Submit the AI-versus-non-AI decision note, bounded instruction, approved-source manifest, helper demonstration, labeled test cases and results, citation and refusal evidence, and updated fallback note.
Observed workflow evidence supports the selected language task, a simpler alternative is compared fairly, and AI is not used for a high-impact decision.
The helper is read-only, accepts bounded synthetic input, follows the stated instruction, and cannot silently update records or trigger workflow actions.
Every factual answer is constrained to the supplied approved sources, displayed citations resolve correctly, and source gaps produce abstention.
Tests cover unsupported, ambiguous, adversarial, confidential-looking, timeout, and service-error cases, preserve human confirmation, and keep the non-AI path available.
Arabic and English answers, citations, refusals, warnings, and fallback messages preserve meaning and are understandable to the target colleague.
Internal Tool Capstone
Build, demonstrate, and improve a small bilingual internal tool through safe, measurable delivery steps.
- Assemble the approved workflow, bilingual interface, synthetic data, roles, reviewed changes, and optional bounded AI helper into one complete sandbox demonstration
- Demonstrate task completion, invalid and unauthorized paths, safe AI abstention where present, manual fallback, and recovery with traceable test evidence
- Collect structured feedback from representative reviewers and issue an evidence-based decision to improve, hold, hand over, or stop the prototype
From Internal Idea to a Small First Version
Turn an approved workflow brief into the smallest useful internal prototype—without pretending it is ready for public production.
Build the Internal Tool in Small Sprints
Assemble the capstone through small user-tested slices instead of one large AI-generated application.
Demonstrate, Learn, and Improve Safely
Run a useful internal demo, collect structured feedback, and decide the next responsible action for the prototype.
Lab assessment
Use only the approved starter, managed sandbox, synthetic data, and services. Demonstrate the smallest complete workflow; do not add features merely to increase apparent scope.
Submit the accessible demo link, scope brief, bilingual walkthrough, synthetic test pack and results, privacy check, known-limit register, reviewer feedback, handover, and final decision.
The named user can complete the approved workflow from input to confirmed outcome, including role checks, status transitions, and a safe fallback.
Repeatable tests cover acceptance criteria, invalid and denied paths, recovery, regression, and any AI citations and abstention, with critical failures resolved.
The tool uses only synthetic data, enforces least access, exposes uncertainty and known defects, retains the manual path, and has clear stop and support instructions.
Reviewer evidence is categorized by task impact and risk, and the final improve, hold, handover, or stop decision follows that evidence and names an owner.
Arabic RTL and English LTR experiences are equivalent across the complete flow, pass the stated accessibility checks, and are documented for the receiving colleague.