Skip to main content

Putting it all together

This is the last lesson in 4RGED Learn — and the most practical one. Earlier pages explained pieces (models, context, tools, review). This page shows one complete job from "I need this small thing" to "I merged it and I'd do it again tomorrow."

You are not learning more theory here. You are learning a repeatable loop: describe the outcome, let the agent work in your repo, review what it proposes, prove it with tests, then ship when you are satisfied.

What this page is for

You want to…This page helps you…
See the whole workflowOne example from task to merge
Connect the lessonsWhen to use each Learn page in real work
Start smallA scope you can finish in one sitting
Know what "done" looks likeReview, tests, and your judgment — not agent confidence
Feel ready on day oneA small example you can copy on your repo today
Part of 4RGED Learn · Coding agents

If anything here is unfamiliar, jump back — Working with agents, Developing features, Reviewing and testing code. First run: Quickstart.

Who this page is for

You are…Focus on
Finished the Learn trackStep by step — run it on a real repo
Impatient to shipSkim One story end-to-end, then do Quickstart
Team leadShare this page as the team’s default loop
Returning after a breakThe loop in four moves + What success looks like

The loop in four moves

Every agent task — feature, fix, or refactor — fits the same rhythm:

MoveYouAgent
1. DescribeSay what "done" means, what to avoid, and how to verifyAsks clarifying questions if needed
2. WorkApprove sensitive tools; skim diffs as they appearReads, edits, runs tests in your repo
3. ReviewCheck scope, tests, and edge cases — same as a human PRFixes or explains when you push back
4. ShipMerge or open PR when you trust itDrafts summary or PR text if you ask

That is the whole product in one table. The sections below walk through one example so you see where each earlier Learn lesson fits — without reading them all first.

One story end-to-end

Imagine a small, real task: add a discount code field on checkout — validate the code, update the total, show an inline error when invalid. Nothing huge; something you could review in one PR.

That single story touches every habit in this track:

PhaseWhat you doLearn page
Orient"Where is checkout pricing handled?"Understanding your codebase
SpecOutcome + acceptance + test commandDeveloping features
BuildOne slice at a time; approve toolsWorking with agents
Fix surprisesRepro + stack trace if something breaksFinding and fixing bugs
Review & testSecond pass + named behaviorsReviewing and testing code
ConventionsRepo AGENTS.md, plugins if you use Linear/DatadogCustomizing agents
Trust but verifyModel limits, context, costHallucination, Context, Tokens

You do not read every lesson before starting. Come back when that phase bites you.

Example first message

Paste something like this into 4RGE Desktop and edit for your repo:

Add a discount code field on checkout.
 
Done when:
- Invalid code shows inline error (no page crash)
- Valid code lowers total before tax; total never below zero
- Match existing checkout UI patterns in @checkout/OrderSummary.tsx
 
Build in two slices: (1) pricing validation + tests, (2) UI wiring.
Run: pnpm test apps/web -- checkout
Do not change the task list API or database schema.

That one message covers outcome, acceptance, anchors, slices, and verify — the habits from Developing features and Working with agents.

Step by step

A practical sequence for the checkout example (or any small feature):

StepYouAgent
1. Open the repoRight package root in 4RGE Desktop—
2. Explore (optional)"Where do we validate checkout totals?"Search and summarize — no edits yet
3. Mini-spec"Discount field on checkout; invalid → inline error; valid → lower total; run pnpm test apps/web -- checkout"Confirms understanding
4. Plan (if multi-file)"Outline steps; don't change code yet"Lists files and order
5. Build slice 1Approve editsPricing validation + unit tests
6. Review diffSkim paths and scopeFixes if you reject
7. Build slice 2Same brief disciplineWire UI to validation
8. VerifyTests green; quick manual smokeRuns the command you named
9. Second pass"Review this diff for edge cases and security on checkout"Ranked findings — you decide fixes
10. ShipCommit or open PR when you are satisfiedDraft PR text if you ask

If step 8 fails, switch to a debugging brief — symptom, repro, evidence — not "try again harder." See Finding and fixing bugs.

If the thread wanders, revert and restart with a tighter spec — faster than ten follow-ups — Working with agents.

What success looks like

You nailed the loop when all of this is true:

SignalMeaning
You reviewed every diffPaths and scope match what you asked for
Tests you named are green"Done" was objective, not a vibe
You could explain the changeYou are not merging blind
You would use the same brief againThe loop is reusable on the next task
Usage shows under your orgExpected spend — Tokens & pricing
Start smaller than you think

Your first win should be one PR you would willingly review — not the hardest problem on the board. Confidence comes from repetition, not hero prompts.

Pick the right surface

Same loop; different where the work runs:

SituationStart here
First time / pairing on codeDesktop — Quickstart
Small feature or bug before lunchDesktop or CLI local
Long refactor or test sweepCloud agent — review Diff when done — Cloud agents
PR check every pushCLI in CI — Headless

Org models, budgets, and plugins apply on all surfaces — Customizing agents.

When it clicks

Agents stop feeling like magic when this becomes muscle memory:

  1. You write "done" — acceptance + one verify command.
  2. You review every diff — same bar as human code.
  3. You split big work — spec → plan → slices → verify.
  4. You reset bad runs — revert beats arguing with a lost thread.
  5. You capture learnings in the repo — next run starts smarter.

That is infrastructure, not a one-off demo. Repeat on the next small task; scope up only when the loop feels boring.

The full Learn path

Use this map when you need depth on one topic:

TrackLessons
AI foundationsHow AI models work → Hallucination & limitations → Tokens & pricing
How agents workContext → Tool calling → Agents
Daily codingWorking with agents → Understanding your codebase → Developing features
Quality & opsFinding and fixing bugs → Reviewing and testing code → Customizing agents
CapstonePutting it all together (this page)

Product docs go deeper: Agent overview, Prompting, Projects, Dashboard.

Habits that work

  1. Pick the smallest real task — one PR, not a quarter roadmap.
  2. Explore before edit when the area is unfamiliar.
  3. Name tests in the first message — agent and you agree on green.
  4. Review as you go — not only at the end.
  5. Hand off long work to cloud with the same mini-spec.
  6. Teach the repo — update AGENTS.md when the same correction twice.

Where to go next

Your goalNext step
Do it nowQuickstart
Install or sign-inInstallation
VocabularyCore concepts
Prompt libraryPrompting
Team projectsProjects overview
Something brokeTroubleshooting

Questions about putting it all together?

QuestionAnswer
Do I need every Learn page first?No — start Quickstart; return when stuck.
How big should my first task be?One reviewable PR — discount field, not "rewrite checkout."
Can the agent open the PR for me?Depends on workflow — you still review before merge.
What if I only need debugging?Use the same describe → work → review → ship loop with a debugging brief — not only features.
Desktop or cloud for learning?Desktop first — faster feedback while learning the loop.
Where is the Learn hub?4RGED Learn — all lessons linked from the sidebar.