Lesson 5: Take the workflow to your own project
Objective
You apply the whole loop — contract, instructions files, bounded agent
work, diff review, written verification — to a script or repository you
actually own, and record what happened.
Why this lesson exists
A course folder is a safe sandbox; your own codebase is not. The point of
the last four lessons was never the report tool — it was a repeatable way
to drive an agent that keeps you in charge of what ships. This checkpoint
exists to prove the transfer happened. It is self-attested: only you know
whether the loop actually ran.
The lesson
Pick a real script you own — one with a bug you have been putting off, or
a behavior you want but have not written. Then run the same five moves:
- Contract. Write the task contract first: inputs, outputs, error
cases, and “done means
<command> exits 0”. One short paragraph, every
sentence testable.
- Rules that persist. Open the repository in VS Code and put the
project-wide rules in
.github/copilot-instructions.md (or the
repository’s existing AGENTS.md) — the verification command, the
dependency policy. Put folder-specific rules in an applyTo
instructions file. Confirm in a new session’s References that they
load. If the repository is shared, these files are reviewed like code:
your teammates’ Copilot sessions will read them too.
- Bounded work. One chat session, Agent role, Manual permissions, one
contract line per turn. Read every changed file before the next prompt;
read every command before approving it; commit each green step.
- Verify. Run the verification command yourself, then do the review
the suite cannot do — walk one real input end-to-end and check the
output by hand.
- Record. Write the three lines: verified / not verified / known
limits.
If the loop fought you — the task was too small to need a contract, or too
vague to test — that is a finding too. Write down where the shape did not
fit; that judgment is the actual skill.
Exercise
If your project has more than one boundary worth pinning, draft the next
contract line now — you will want it when you open the next session.
Checkpoint
This checkpoint is self-attested. When you can answer the questions below,
claim it with python verify.py --attest l05:
- What was your contract’s “done means” command?
- Which diff or command did you push back on?
- What is on your “not verified” list that a stranger would assume was
covered?
Expected evidence
Your contract paragraph, the instructions file you wrote, and the
three-line verification record. These are yours — they are the proof the
workflow transferred.