← Back to home
THE WORK, NOT THE HYPE

Software Engineering with AI.

Explore how AI changes your work — and what to learn next.

A practical guide to
the work ahead
Software EngineeringDocumentationGrowing Practice

Documentation

Draft explanations and sample requests.

The workflow, side by side

Traditional workflow

Before generative AI assistance
  1. 1

    Clarify the goal using an API implementation and release notes

  2. 2

    Read the implementation

  3. 3

    Write examples and error descriptions

  4. 4

    Run examples against the current version

  5. 5

    Check the result against the agreed criteria

  6. 6

    Communicate the outcome and record the decision

AI-assisted workflow

AI contributes. You guide and verify.
  1. 1

    Define the goal, constraints, and permitted information

  2. 2

    Provide relevant, sanitized context from an API implementation and release notes

  3. 3

    Ask AI to draft explanations and sample requests

    AI + YOU
  4. 4

    Inspect suggestions against original evidence and domain rules

  5. 5

    Revise the output and independently validate the result

    YOU
  6. 6

    A responsible professional approves and communicates the outcome

HUMAN CHECKPOINT

Do these examples run and match the released API?

Your judgment matters

The shift: Reviewing, validating, and integrating AI-generated code. Foundational skills still matter.

Build the skills behind the work.

A practical learning path for Software Engineering.

GO A LITTLE DEEPEROpen only what you need
What changes — and what doesn’tSkills & responsibilities
AI HELPS WITH
DraftSummarize

Draft explanations and sample requests. The output is a starting point to inspect, not a decision to accept automatically.

STILL YOUR RESPONSIBILITY

Validate correctness, choose tradeoffs, protect users, and approve changes.

Skills to develop

FoundationsProgramming, algorithms, system design, and security.

AI collaborationProviding task-specific context and requesting explicit assumptions.

VerificationChecking an API implementation and release notes against independent evidence.

Professional skillsCommunicating tradeoffs and taking responsibility.

Where AI can go wrong3 things to check

A plausible but wrong answer

AI may describe an option that does not exist. It can fail the underlying goal even when it sounds convincing.

Your check

Run the example and verify options against the current client API.

Missing or invented context

AI may fill gaps with unsupported assumptions, which can send the work in the wrong direction.

Your check

Trace claims to original evidence and ask the relevant person about unknowns.

Information shared in the wrong place

Sensitive records or code can cross confidentiality boundaries if supplied to an unsuitable tool.

Your check

Use approved tools, share the minimum context needed, and follow your organization’s rules.

Try a quick exerciseA practical scenario

Generated docs use a retryCount option absent from the client library.

What is the most important next step in this scenario?
Sources & contextEvidence behind this example