AI Build Lab / Learn · Agent Workforce · Week 1 · Orientation

Meet your organization

Where does my organization live, who does what, and where do I decide?

Staff only · where this page comes fromPrompts: all 5 from Hunter's course file (course/workforce/orientation.md on the student course files, see src/shelf/SOURCE.md), none of Sara's, per Sara 09-23 (hers were untested placeholders). Page, copy and drawings: Sara's 09-22 page (course-design ea2d00e).
In plain English

This is that walk-around. You'll find the organization in your workbench, meet the agents you'll use first, and take a starting picture before changing anything.

The course gives you a starting organization to inspect and adapt. You learn by giving it work, seeing what happens, and making changes you understand.

The files describe the organization. The work shows what it did.

What you get

You can find the workbench, distinguish it from the LMS and remote copy, and explain Chief, The Professor, the Writer, and the Reviewer.

Why it matters

A profile being present, an agent being available to call, and an agent having completed a job are three different things.

How it works

You direct in the app, work happens in the selected workbench, and saved records can be inspected in the dashboard.

Your seat

Set the direction, approve what may be used, and decide what happens to the work.

Your format · Hunter's draft has no "In plain English" or tiles. Every sentence here is his, lifted from lower on the page; none removed. Which ones to lift is Claude's pick; candidate.
Field note
Sara Davison

The first day in an unfamiliar organization is easier when someone shows you around. Which work belongs where? Where do you ask for help? What comes back to you for a decision?

This is that walk-around. You'll find the organization in your workbench, meet the agents you'll use first, and take a starting picture before changing anything.

The opening two paragraphs are shown as the Field note, because that is the job they do. Hunter's notes say he added "no invented first-person attribution to Sara," so his file has no name on it. Signed Sara Davison here, per your ruling (C130).

Start here

Before you start: Complete the required Essentials setup and open your existing workbench in Claude Code or Codex.

Prompt placeholder in Hunter's draft

Prompt placeholder: start or resume the Week 1 orientation. Add after the lesson-content pass.

Two agents you'll work with directly this week
Your course companion

The Professor

It explains unfamiliar ideas, asks one question at a time, and helps you learn from the work. Call it in any time you have a question.

Right now it talks to everyone the same way. Later this week it interviews you, and from then on it teaches your way.

Gets work done

Your Chief of Staff

It coordinates the organization's jobs. You give it the work; it decides which agents the job needs, brings back what they did, and brings the decisions to you.

Later this week you hire it and choose its style, so it briefs you the way you like to be briefed.

You call in these two yourself. Every other agent is reached through your Chief of Staff.

What's really happening: you're working with Claude Code or Codex as The Professor, or as your Chief of Staff.It's the same app you used in Essentials. When you call in an agent, the app takes on that agent's job description: what it's for, how it works, and what it's allowed to touch. Change the agent and you change the job. The app underneath stays the same.
Sara, Sept 21 · one block, as you described it: two agents this week, what each one is, that each gets customized later this week, and Tyler's point from today's live session in the highlighted box. Sentences taken from Hunter's draft: "explains unfamiliar ideas, asks one question at a time, and helps you learn from the work," "coordinates the organization's jobs," and the last line about other agents. From your Lesson 1 box (C206): "Right now it talks to everyone the same way..." The rest is candidate wording. Tyler's point is in plain words, not his quote: the recording of today's session isn't reachable from here (no Fathom recording listed for today; Granola isn't connected), so check the highlighted sentence against what he actually said. To confirm with Hunter: "later this week" for both. His teaching map puts The Professor's interview in Lesson 4 and "Hire your Chief of Staff and choose its style" in anw-l32; both are Week 1 on the map.
Hunter's wording for this paragraph

The Professor is your course companion. It explains unfamiliar ideas, asks one question at a time, and helps you learn from the work. Chief of Staff coordinates the organization's jobs. You'll speak directly with these two agents in Week 1; requests for other specialists go through Chief.

Flag 1 · "Course companion" replaces "tutor." "Chief" on its own

"Tutor" is gone, which clears your flagged word. New to rule on: the draft shortens Chief of Staff to "Chief" (11 times on this page: "go through Chief," "Locate Chief"). Your pages say "your Chief of Staff" or "the Chief of Staff."

First time here? Open your workbench and call in The Professor
  1. Open Claude Code. Look at the folder name under the message box. If it isn't your workbench, click it and choose Open folder, then pick your workbench folder.
    Click the folder name, then Open folder. (Essentials screenshot, Wade's screen.)
    Click the folder name, then Open folder. (Essentials screenshot, Wade's screen.)
    Click the folder name, then Open folder. (Essentials screenshot, Wade's screen.)
    Click the folder name, then Open folder. (Essentials screenshot, Wade's screen.)
  2. Check the folder name now shows your workbench.
    The folder name under the message box is the folder you're working in. (Essentials screenshot: it shows agent-native-os, yours shows your workbench.)
    The folder name under the message box is the folder you're working in. (Essentials screenshot: it shows agent-native-os, yours shows your workbench.)
    The folder name under the message box is the folder you're working in. (Essentials screenshot: it shows agent-native-os, yours shows your workbench.)
    The folder name under the message box is the folder you're working in. (Essentials screenshot: it shows agent-native-os, yours shows your workbench.)
  3. Start a new thread. This only works on the first message.
  4. Type @. A list of your agents appears.
  5. Pick The Professor from the list. Not in the list? Do step 6 of 0.3 Get your organization. Until then, skip the list and paste the words below as they are: they ask for The Professor by name.
    Screenshot needed. The @ list open in a workbench, with The Professor picked, and the blue tag at the top right. Nobody has taken this one yet.
  6. Look at the top right. A blue tag shows you're now talking to The Professor.
  7. Paste the words below and send.

Use the native aibl-the-professor agent to start or resume orientation. Read course/workforce/prompts/orientation.txt and course/workforce/orientation.md completely. Check my approved saved work, ask one question, and wait. Report missing files or native routes; do not install anything.

It's always Claude Code or Codex doing the work. The agent you pick decides what job it's doing and what it's allowed to touch.

On Codex there is no list to pick from. You ask by name, in your first message: "Have The Professor handle this." Codex starts The Professor, and its answer comes back to you through Codex.

Checked against Tyler's release notes · the two apps work differently

Claude Code: you call the agent in. New thread, type @, pick it from the list, and the whole thread then runs as that agent. Tyler proved this for the Chief of Staff on Sept 20. His notes say it is not yet tested for The Professor. If you type the name by hand and don't pick from the list, you get a weaker version: the main Claude passes your message along and retells the answer.

Codex: you only ask by name. His notes: "in Codex only the spawn-by-name route exists and the reply is relayed by the caller, with no session picker verified." So in Codex you are never talking to The Professor directly; Codex fetches its answer for you. An earlier version of this box said "type @ and choose the agent" for Codex. That was wrong and is fixed.

Why it matters for the lesson: "a blue tag shows you're talking to The Professor" is true in Claude Code only. A Codex student needs a different check that the agent really ran. Question for Tyler and Hunter: what does a Codex student look for?

Sara's addition · not in Hunter's draft. The same "how to call in an agent" box as Lesson 1 (C181, C207), with The Professor in place of the Chief of Staff. Steps 3 to 6 are from Tyler's live demo. The two screenshots are the Essentials ones already in this repo (essentials/shots/carry/06-...); they show Wade's screen and the Essentials folder, so a workbench version is worth retaking. Still to confirm with Hunter: the exact name students see in the @ list, and the Codex line (Q32). Candidate wording.
The introduction and the how-to-call-in box sit together here (Sara, Sept 21: that is where she looked for it). Take the tour keeps a one-line reminder that points back up.

The pieces, and how they fit

The course gives you a starting organization to inspect and adapt. You learn by giving it work, seeing what happens, and making changes you understand. In Week 3, you'll use that experience to build a department of your own.

First, separate the places you'll use:

Piece What it is for
You, the Director Set the direction, approve what may be used, and decide what happens to the work.
Your workbench The folder holding the organization's instructions, approved information, and work records.
Claude Code or Codex The app where you talk to agents and direct work. Select the correct workbench before starting.
The dashboard, where available A view of the organization and saved work. A label on a screen doesn't replace the work it describes.
GitHub The remote copy you set up in Essentials. Only files included in commits and successfully pushed are copied there.
Flag 2 · This table and the drawing under it say the same thing

Same point you made earlier tonight. It is much shorter now (five rows, not six paragraphs), so it may be fine as the text version of the drawing. Candidate: drawing first, table after it.

The LMS is where you read. Your workbench is where you do the exercises. You don't need to browse GitHub to speak to an agent.

Read the picture as a map of these places: you direct in the app, work happens in the selected workbench, and saved records can be inspected in the dashboard. A remote copy is separate from both.

Flag 3 · The dashboard: "where available," and a drawing that must not promise one

Hunter's placeholder asks for your Two Doors drawing "without promising a working dashboard or backup." Your drawing says "Team HQ... watch, approve, read receipts" and "GitHub keeps a copy." So the drawing needs a redraw before it ships, not only a label fix. Still open from Sept 19: where is the dashboard (Q22).

Picture placeholder in Hunter's draft

Sara's “Two doors, one company” concept, updated to the selected edition. Show app, workbench, supported dashboard, and GitHub copy without promising a working dashboard or backup.

Visual 0, your ruled drawing (C84), shown where Hunter's placeholder asks for it. Not in his draft.

Two more pieces sit underneath. The model generates responses and helps choose actions. Tools let the app or agent do things, such as read a file or use an approved connection. Written instructions describe the job; the selected app, tools, and permissions affect what can happen.

Walk around the organization

The organization is described in files you can open. Its agent roster lists the roles available in the selected edition. A profile being present, an agent being available to call, and an agent having completed a job are three different things.

Your organization lives in a folder. An app and a model put it to work.The folder you own, plus the app you install and the model you rent, makes a working organization. Only the folder is yours for good.
Your organization lives in a folder. An app and a model put it to work. On the left, the folder my-workbench: CLAUDE.md and AGENTS.md, the note every agent reads first; workforce, the organization, holding profiles (staff files, one job description per agent) and skills (how each kind of job gets done); charter.md, the rules every agent works under; knowledge, the approved facts about your work; work, the records room. On the right, a sum: the folder (you own it) plus the app, Claude Code or Codex (you install it) plus the model (you rent it) equals a working agent organization. Take one away and nothing runs. Only the folder is yours forever.
Your organization lives in a folder. An app and a model put it to work.

Text alternative: Your organization lives in a folder. An app and a model put it to work. On the left, the folder my-workbench: CLAUDE.md and AGENTS.md, the note every agent reads first; workforce, the organization, holding profiles (staff files, one job description per agent) and skills (how each kind of job gets done); charter.md, the rules every agent works under; knowledge, the approved facts about your work; work, the records room. On the right, a sum: the folder (you own it) plus the app, Claude Code or Codex (you install it) plus the model (you rent it) equals a working agent organization. Take one away and nothing runs. Only the folder is yours forever.

Sara's picture, added Sept 21 · the folder slide from your Week 1 live session deck (the-studio, week-1/v1). Not in Hunter's draft. Shown here as an image; the deck version is live HTML, so Hunter or Wade can build it properly. To check against the final build before it ships: the folder names in the tree (workforce/, profiles/, skills/, knowledge/, work/), and "Your guide lives here" in the app box, which depends on the guide or Professor ruling. Lesson 1 in this draft puts the job records in runs/, which the tree does not show.
Flag 4 · "The selected edition" is build language

Four times on this page ("selected edition," "course edition," "compare editions"). A student has one workbench and doesn't know there are editions. Candidate: "your workbench" or "the version you installed."

This week, you're working with these eight named agents:

Sara's edit, Sept 21 · students don't know about "Tyler's package," and it is build language. First copy edit for Hunter's file.
Hunter's wording

Tyler's Week 1 package focuses on eight named agents:

You call it in

Chief of Staff

Coordinates jobs, reports what happened, and brings decisions back to you.

You call it in

The Professor

Helps you understand and practise the lessons.

Goes through your Chief of Staff

You've Got Mail, or YGM for short

Your Communications Writer. Produces drafts from approved material.

Goes through your Chief of Staff

Kansa, your Quality Reviewer

Checks work and explains its findings. You decide what to do.

Goes through your Chief of Staff

Echo, your Voice Analyst

Studies permitted examples and describes communication patterns. It doesn't write finished copy in that voice.

Goes through your Chief of Staff

The Knowledge Librarian

Handles approved knowledge and its sources. You'll study this more closely in Week 2.

Goes through your Chief of Staff

The Charter Steward

Reviews the agreement and reports differences between it and the actual setup.

Goes through your Chief of Staff

Gigawatt

Helps with authorized technical setup and building. It doesn't replace your approval.

Layout only · Hunter's table of eight, as cards. His words in each card. The small labels ("You call it in" / "Goes through your Chief of Staff") are added from his own sentence in Start here: "You'll speak directly with these two agents in Week 1; requests for other specialists go through Chief."
Flag 6 · Gigawatt has no job title, and "building" in Week 1

Every other agent has a title. Gigawatt is described as "authorized technical setup and building." Your ruling: Gigawatt builds in Week 3. Tyler calls it "the operator." Question for Tyler and Hunter: does a Week 1 student ever call it?

Flag 5 · Naming: Hunter's choice overrides your naming rule

His notes say so directly: "You've Got Mail, or YGM for short" and "Kansa, your Quality Reviewer" are "Hunter's explicit choices" and "supersede the older title-only naming proposal for this draft." Your rule (C92, C104): the job title is the name, the nickname once in brackets, then the short form. Here the nickname leads for YGM, Kansa and Echo, and the tour says "Locate Chief, YGM, and Kansa." This one needs a ruling between you and Hunter before any more pages are written.

The broader course chart includes Customer Support, Growth, Marketing, Operations, Sales, and Quality, along with support for learning and building. It shows the design you're studying. Check the installed roster to learn which roles are actually available now; don't treat every box as an agent that has run.

Flag 7 · Still no answer to "when do the others arrive?"

The draft now says the right thing: eight now, the chart is the design, check the roster. It never says when or how the other agents arrive. It also never says the number twenty any more, while the chart still shows seventeen agents plus three Faculty.

Chief, the Knowledge Librarian, and the Charter Steward belong to the Executive Office. Specialists contribute the work their roles own. Chief can coordinate a job across departments; the organization isn't one fixed assembly line.

The chart below should help you find Chief, the Writer, the Reviewer, and your decision point. Keep the broader organization visible, with unavailable or later roles clearly marked.

Picture placeholder in Hunter's draft

adapt Sara's organization board to the Week 1 roster. Distinguish supplied, available, and observed-in-use roles. Include the place for the student's Week 3 department.

This is the organization you're working toward over the next four weeks.

Read it from the top. You're at the top, the Director. Your Chief of Staff is the front door, right beside you. Under that are the departments, with one line on what each agent does. The eight you just met are already in your workbench. The rest of the chart is where you're headed, and the empty floor at the bottom is where your own department goes in Week 3.

Your lead-in from earlier tonight · first sentence yours, the rest candidate. Hunter's own lead-in is the paragraph just above ("The chart below should help you find Chief, the Writer, the Reviewer, and your decision point"); the two could merge.
The agent organization you inherit.The chart you start with: you and your Chief of Staff at the top, each department and its agents below, and an empty floor for the department you build in Week 3.
AI Build Lab // Agent WorkforceGiven day one

The agent organization you inherit.

Wired and staffed on day one · one Chief of Staff routes every request to the right seat · you customize it, then build one department yourself
Level 1 · the executive office
The accountable human
You, the DirectorThe only yes that ships. Everything reports up here.
reports to ←
Chief of Staff
Your Chief of StaffThe front door · briefs, routes, queues, escalates · never does the specialist work
AI Build Lab Faculty · outside your org chart
The Professor helps you learn, from the lesson and your own answers. Two more Faculty roles join you in Week 3, when you design and build your department.
Level 2 · the departments · every seat reports to your Chief of Staff
✦ Department

Executive Office

3 seats · given day one
Seats · report to your Chief of Staff
  • Chief of StaffBriefs you, names the specialists a request needs and says why, keeps your decisions in view.
  • Knowledge LibrarianFinds evidence and proposes where approved information should live.
  • Charter StewardKeeps the agreement and the records straight.
Yours to charter · could add over time
  • Calendar keeper
  • Meeting prepper
  • Travel planner
→ Your direct line · the front door
✦ Department

Marketing

1 seat · given day one
Seats · report to your Chief of Staff
  • Voice Analyst EchoAnalyzes permitted samples and describes communication patterns.
Yours to charter · could add over time
  • Content
  • Social
  • Brand
✦ Department

Operations

2 seats · given day one
Seats · report to your Chief of Staff
  • Process AnalystMaps how the work happens before proposing a change.
  • Evidence Pattern AnalystFinds patterns and gaps in the supplied evidence.
Yours to charter · could add over time
  • Automation
  • Reporting
  • Backlog groomer
✦ Department

Quality

2 seats · serves every department
Seats · report to your Chief of Staff
  • Quality Reviewer KansaChecks a produced draft before your decision.
  • Evaluation Analyst EvyAssesses recorded cases in Week 4, after your own judgments are saved.
Yours to charter · could add over time
  • Rubric keeper
  • Regression spotter
  • Fact checker
→ Dotted line · reviews every department
✦ Department

Sales

1 seat · given day one
Seats · report to your Chief of Staff
  • Sales Discovery SpecialistPrepares a discovery conversation from approved research.
Yours to charter · could add over time
  • Pipeline
  • Outreach
  • Market analyst
✦ Department

Customer Support

5 seats · given day one
Seats · report to your Chief of Staff
  • Support LeadCoordinates the case and assembles what comes back.
  • Intake Triage AnalystReads the incoming case for need, tone and urgency.
  • Internal Knowledge ResearcherFinds relevant evidence in approved business records.
  • External ResearcherChecks approved outside sources when the job needs them.
  • Communications WriterTurns the approved material into a draft for review.
Yours to charter · could add over time
  • Onboarding
  • Escalation triage
  • FAQ curator
→ One request in · one review before anything ships
✦ Department

Growth

3 seats · given day one
Seats · report to your Chief of Staff
  • Opportunity Desk LeadCoordinates an opportunity and assembles the decision.
  • Opportunity AnalystExamines fit, trade-offs and unanswered questions.
  • Proposal SpecialistStructures a proposal from the approved findings.
Yours to charter · could add over time
  • Podcast desk
  • Press desk
  • Monthly drops
→ One opportunity, one packet, one record
✦ Department

★ Your department

Week 3 · four you customize, one you write
Seats · report to your Chief of Staff
  • Four rolesSupplied profiles you customize for work you choose.
  • ★ Your specialistThe fifth. You write it from scratch.
Yours to charter · could add over time
  • Whatever your work needs next
→ One job, run end to end, and inspected
✦ Future floors

Your next departments

0 seats · open · add them as the work earns them
Seats · report to your Chief of Staff
  • Financebilling, reporting
  • Legal and admincontracts
  • Peoplehiring, onboarding
  • Client deliverykickoff to close
Same law everywhere: no owner, no charter, no production.
Given · in your workbench on day oneYou build it · Week 3Yours to charter · what the floor grows intoEvery seat is a plain-English file · 17 seats + 3 Faculty = 20
The agent organization you inherit.
Your board (C85), shown at his placeholder. His placeholder asks for more than the board has: mark each agent as supplied, available now, or seen working. The board also still says "Given day one" on its badge, subtitle and every department, which is no longer true with eight agents in Week 1. Both are redraw jobs.

Seven things to recognize

You don't need to memorize filenames today. Learn the question each part answers. Lesson 2 opens the actual files and controls.

Part The question it answers
Agent profile Which agent owns this job, and what is its responsibility?
Skill How is this kind of work done?
Context What information and instructions are available for this job?
Command or start request How do I deliberately start the work?
Gate Where must work stop, ask, or be refused?
Schedule What would start a job later?
Work record What actually happened, and what did I decide?

These are useful categories, not a claim that every file fits only one box. A skill is a method; a tool is a capability it may use. A schedule is separate from working through several steps now. These exercises don't ask you to enable unattended work.

You may recognize CLAUDE.md and AGENTS.md from Essentials. They guide the relevant conversation. Other agents also have their own instructions and receive selected inputs. Don't assume every agent reads every file.

Take the tour

First, call in The Professor. The steps and screenshots are in Start here, above. Then work through these four steps with it.

1. Find your place

With The Professor, confirm the selected workbench and course edition. Locate the roster and organization files. If something required is missing, keep that gap visible.

Say this to The Professor:

Check which workbench we are in. Show me my agent roster and organization files. Name anything missing. Do not change anything or start a job.

Four candidate prompts, one per step (your rule C114: every step gets words to paste). Not in Hunter's draft: he is holding all prompts for one pass after the content settles, together with the backend work. These are input for that pass, in your voice, and none has been run. Each one asks only for what his step describes. On Codex, the student starts the message with "Have The Professor handle this:" because there is no list to pick from.
Flag 8 · "Before photo" is in. "Three original answers" is not explained

Your C90 wording is used. "Three original answers" means the three cold questions from Lesson 3; a student reading this page can't know that. Candidate: "three questions you ask before it knows anything about you."

The before photo is a record, not necessarily a screenshot. You'll add three recurring work cases, three original answers, and a plan for information you may share. Lesson 3 completes it before you introduce more context. Later comparisons need an unchanged starting point.

If you get stuck
  • The chart and roster differ: compare editions and labels. A larger chart doesn't prove the installed package is wrong.
  • An agent name appears in chat but there is no returned work: ask which agent actually ran. A description or demonstration isn't a completed job.
  • The dashboard isn't available: inspect the files and record the missing view. Don't build a replacement as part of this tour.
  • The folder feels overwhelming: start with one profile, one method, and one source note. Ask The Professor what question each answers.

Before you move on

You can find the workbench, distinguish it from the LMS and remote copy, and explain Chief, The Professor, the Writer, and the Reviewer. You can find a role's instructions and distinguish an available role from observed work. Your starting picture is open, with missing information left as missing.

The files describe the organization. The work shows what it did.

Next: Give your organization a first job

When you've finished this page
Self-assessed. No gate.
AI Build Lab · LearnAgent Workforce, Week 1, primer