Evidence, Not Claims: Building the FDE Companion OS
Seven artifact slots, organized by lifecycle stage and evidence type — the operating system that turns engagements into compounding personal capital.
V1 · Pedagogy
✅ PASS (5/5)
Bloom's revised taxonomy, Wiggins & McTighe backward design, Sweller cognitive load, Sweller & Cooper worked examples, authentic-task assessment. Skill-lab format honors I-do/We-do/You-do with a 45-min You-do block.
V2 · Framework lineage
✅ PASS (4/4)
Companion OS distinguished from Tiago Forte's PARA (2017) and Building a Second Brain — both organized by actionability; Companion OS organizes by lifecycle stage AND evidence type. Retro slot anchored to Google SRE's blameless-postmortem template.
V3 · Continuity across Course 1
✅ PASS (3/3)
Worked example reuses the Polaris narrow-path artifact from Lesson 1.6 §7 as Companion slot #3. Adoption-note metrics consistent with Lesson 1.4. Lifecycle anchors carried forward from 1.4.
V4 · Logical consistency
✅ PASS (3/3)
Section times sum to 120 min. Seven slots are exhaustive across the lifecycle (2 Diagnose + 1 Prototype + 1 Evaluate + 2 Adopt + 1 Retro), non-overlapping, each testable by a Yes/No criterion. Bloom progression Remember → Understand → Apply with Create satisfied by the populated repo.
Two FDEs apply for the same senior role. Same years of experience; same caliber of customers. The first sends a polished resume and a portfolio site with five case studies — hero images, clean "client" / "challenge" / "approach" / "results" blocks: "Architected a scalable, production-ready AI assistant that transformed customer support operations and unlocked significant ROI."
companion-os. One sub-folder per engagement. Inside each, exactly seven files. Brief. Workflow map. Narrow-path diagram (the same one she wrote for Lesson 1.6 §7). Eval — a Markdown file with agreement rate 0.91, p95 latency 180 ms, $0.04/turn, the regression-gate commit hash. Demo — a Loom link plus three Slack screenshots of operators using the path. Adoption note — "Pam Cheng is the Day-2 owner; she runs the eval-update meeting every other Tuesday; deflection moved 0% → 37% in 30 days." Retro — three things that worked, three that didn't, two changes she's made to her own defaults.
The gap is not skill — both can do the work. The gap is in what evidence each has accumulated, in a shape a senior reviewer can interrogate. Marketing is auditable on the surface only; evidence is auditable all the way down. By the end of this lesson you will have set up your own Companion OS, populated all seven slots for one prior engagement, and filed at least one piece of evidence that a skeptical senior FDE would accept.
By the end of this lesson, you will be able to:
The §7 lab produces a populated repo for one of your real prior engagements. The model in §4 is the lens. The §6 evidence-vs-marketing rewriter is the forcing function that prevents portfolio-style filling. Create is the load-bearing outcome — the act of producing real evidence, not describing it.
Today's lesson is the operating-system layer beneath everything in 1.4 through 1.6. The Trinity, the Maturation Loop, the Lifecycle, founder-like ownership, and the Narrow Path are all useless across engagements unless their outputs accumulate somewhere a future you can audit. The Companion OS is that somewhere. The §7 narrow-path diagram you wrote in Lesson 1.6 is slot #3 of your first engagement.
Why "operating system," not portfolio or wiki
The Companion OS is named operating system on purpose. It is not a portfolio site (its audience is your future self before it is any hiring panel). It is not a wiki (its shape is fixed, not free-form). It is not a knowledge base (it stores evidence about your engagements, not facts about the world). The closest popular analog is Tiago Forte's PARA method (Projects, Areas, Resources, Archives), which organizes information by actionability. The Companion OS borrows PARA's discipline of organizing by usage but swaps the dimension: instead of actionability, the organizing dimension is lifecycle stage and evidence type. That swap is the entire point.
The seven slots — click to explore
Each engagement gets a folder. Inside, exactly seven slots, exhaustive across the lifecycle and non-overlapping. Click any slot in the file tree on the left to see its contents and fullness criterion.
What closes the loop between Prototype and Adopt
Of the seven slots, four sit clearly inside a single lifecycle stage and three operate as bridges. The most important bridge — and this lesson's spaced-review answer — is slot 4, the eval. The eval is the artifact that lets a Prototype cross into Adopt without the rung-3 stall Lesson 1.4 named. Without an eval, "shipping" stays "shipping" and the Day-2 owner is never confident enough to take ownership. The eval is the contract under which Adopt happens.
Cross-engagement layer (Patterns)
Below the seven slots in each engagement folder, the Companion OS holds two cross-engagement folders. patterns/ collects observations that hold across multiple engagements — phrasings that worked in a defense, eval techniques that surfaced a class of failures, demo formats that landed with skeptical operators. templates/ holds the blank versions of slots 1–7 so each new engagement starts in 30 seconds, not 30 minutes. Both are PARA-style "Resources" in Forte's vocabulary; they sit above engagements in your repo and are the place reused FDE judgment lives.
Tool agnostic. The same seven slots can live in a private GitHub repo, a Notion workspace, an Obsidian vault, or a folder on your laptop. Tool choice is personal preference; the slot structure is the contract.
The senior FDE's Polaris Companion folder, exactly as it sits in her repo today (twelve weeks after the §1.6 narrow-path conversation with Janet). For each slot: the actual compressed contents, and the one filing decision that distinguishes the entry from a portfolio version of the same thing.
Three sentences from real portfolio sites of working FDEs. Each is marketing language. Rewrite each as evidence — a statement that a skeptical senior FDE could verify or falsify in two minutes. Your rewrite must (a) name a specific number or artifact, (b) be locatable (link, file, or commit), and (c) survive the "so what?" test. Live checks run as you type.
Scaffold drop. Notice that evidence rewrites are typically twice as long as the marketing originals. That is the cost of evidence — and the reason most portfolios stay marketing. The §7 lab will ask for the same discipline on your own slots.
Brief
Pick one prior engagement of yours — finished or current. Use the populator below to draft all seven slots. The populator persists locally; you can come back to it. Mark each slot Full or Placeholder honestly. At the end, export as Markdown and drop into your repo of choice (GitHub, Notion, Obsidian, or a plain folder).
Acceptance criteria (peer-checked)
- All seven slot files exist, named per the §4 convention.
- At least three slots pass the evidence-vs-marketing standard from §6.
- The slot 7 retro names you (the FDE) by behavior — not the customer by mistake.
- The README (auto-generated on export) explicitly labels placeholders as placeholders.
- A peer reviewer can open any slot and explain back what is in it within 30 seconds.
Honesty clause: On most prior engagements, slots 4, 5, and 6 will be partially or entirely empty. That is expected and is itself useful information — it is the signal that prompts the next engagement to file differently. The lab is not graded on how full your repo is; it is graded on how honestly the slots reflect the engagement's actual evidence.
Re-creating a portfolio instead of an operating system
The repo becomes a brand asset for hiring panels — hero images, polished narratives, selective omissions of failures. Useful for a job hunt; useless for the future you who needs to remember what actually happened.
Correction
Reverse the audience. The first reader of every entry is your future self trying to do better work on the next engagement. The hiring panel is a fortunate side effect, not the goal. If a slot is written to impress, refile.
Filling slots with marketing language
"Architected a scalable, production-ready AI assistant." "Drove successful adoption." Adjectives in place of artifacts. The repo passes a visual skim and fails the §6 evidence-vs-marketing test.
Correction
Every entry must (a) name a specific number or artifact, (b) be locatable, and (c) survive the "so what?" test. If a sentence has more than two unfalsifiable adjectives, rewrite it with the §6 template.
Skipping the retro slot
Slot 7 is the slot most commonly empty in real Companion repos. It's also the slot that compounds — every retro feeds the patterns/ folder, which feeds the next engagement's defaults. Without retros, the Companion OS is a filing cabinet, not an operating system.
Correction
Write the retro within two weeks of engagement close — one page max, blameless (Google SRE template). Name yourself by behavior. If you can't name two changes to your own defaults, you haven't finished the retro.
Look at the seven-slot Companion you just built. Answer honestly.
The Companion OS is the single Course 1 artifact that compounds across engagements. Trinity, Maturation, Lifecycle, Ownership, Narrow Path — all are taught once. The Companion OS is the substrate in which those frames accumulate evidence and improve over a career. This reflection is your first deposit.
Which Companion artifact closes the loop between Prototype and Adopt?
Success criterion: The eval (slot 4). It is the contract under which Adopt happens — the artifact a Day-2 owner needs to take ownership and the document a customer's security and operations teams need to put the system in front of real users.
Next lesson
1.8 is the Course 1 mastery gate; it uses your populated Companion OS as one of two evidence inputs to a 30-minute positioning conversation.
Capstone hook
Capstone M6 is graded against a Companion OS folder for the capstone engagement, populated to today's seven-slot standard. Today's repo is the template you instantiate at M1 and populate across M1–M6.
Optional reading
The PARA chapter — to understand what the Companion OS borrows and what it deliberately swaps. Pair with Google SRE Book ch. 15 (Postmortem Culture) — the source template for slot 7.
Companion OS
File today's lab output under this tag. Open the repo before every new engagement kickoff and after every engagement close.