C.W.K.
Stream
Lesson 01 of 04 · published

The Boundary

~9 min · boundary, consume-not-absorb, separation-of-concerns

Level 0Lone Machine
0 XP0/37 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete
"The engine records and executes. The brain judges. Draw that line once, and both halves get to be whole."

Two owners, one clean line

By the end of this quest the division is sharp. Watchfire owns fleet facts and durable operation state: the registry, the observations, the operations, the campaigns, the audit trail. cwkPippa owns Pippa's identity, judgment, tool routing, and cross-brain delegation. Neither reaches into the other's half. The engine never starts making the calls; the brain never starts holding the fleet's ledger.

Consume, don't absorb — one level up

You met this rule in the second track, about apps: Watchfire consumes a sibling engine's documented health but never copies its internal diagnostics into itself. The very same rule governs the Watchfire-and-Pippa boundary. Watchfire may ask Pippa for judgment and hand Pippa an operation to assist with; it does not become a second brain, and Pippa does not become a second fleet-state store. Consume the contract; leave the internals where they live.

Why the line stays clean

Blur it and you get the worst of both: an engine that half-judges and a brain that half-remembers the fleet, each drifting out of sync with the real owner. The boundary isn't bureaucracy — it's what lets each side be authoritative about exactly one thing. Watchfire is the truth about the machines; Pippa is the judgment about what to do. Two whole halves beat four leaking quarters.

The engine has no second brain

Concretely: Watchfire embeds no agent runtime. Long or disconnect-sensitive work is committed to Watchfire first as a durable operation, and a Pippa delegate executes against that operation's id. The conversation is never the operation store; the engine is never the judge. Each stays exactly what it is, and the seam between them is a contract, not a merge.

Let the engine be the truth and the brain be the judgment. A clean boundary is what keeps a two-part system from becoming two half-systems.

Code

Two owners, one contract between them·python
OWNERSHIP = {
    "watchfire": ["fleet registry", "observations", "operations", "campaigns", "audit"],
    "cwkpippa":  ["pippa identity", "judgment", "tool routing", "delegation"],
}

# The seam is a CONTRACT, not a merge:
#   Watchfire -> Pippa:  "here is an operation id; assist / judge"
#   Pippa -> Watchfire:  reads facts, proposes typed operations
#
# Watchfire embeds NO agent runtime. cwkPippa stores NO fleet-state copy.
# Consume the other's contract; never absorb the other's internals.

External links

Exercise

Take two components in a system you've built that talk to each other (a service and its client, an app and its database, a UI and an API). Write the one thing each is authoritative about, and the contract between them. Then find one place where one component reaches into the other's internals — and describe the drift that will eventually cause.
Hint
The reach-in is usually a shortcut: the client reads the service's private table directly 'because it's faster.' It works until the service changes that table's shape, and now the two are coupled in a way no contract documented. The clean version consumes a stable interface and never touches the internals behind it.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.