Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
c0dfaff
spec(project): Workforce: Layer 2 Abstraction
claude Sep 17, 2026
c012d78
ci: port the project/* spec-folder exemption onto this branch
claude Sep 17, 2026
5f57332
spec(project): Channel is the L2 noun; room was retired before I wrot…
claude Sep 17, 2026
a51ef15
spec(project): status refresh — W4 enters, W3 at 16/21
claude Sep 18, 2026
478afe4
spec(project): commit the absorbed Linear content, which the first bu…
claude Sep 18, 2026
28ff52b
spec(project): W1 is Todo, not held — and the two surfaces that disagree
claude Sep 18, 2026
47342c5
project(workforce-layer-2-abstraction): W4 in flight, five children, …
claude Sep 19, 2026
fc656e4
spec(project): W4's set size is the epic's sign-off, not this table's
claude Sep 19, 2026
d9385b1
spec(project): restore W4's five — the approval existed, my derivatio…
claude Sep 19, 2026
ba72aa0
project(workforce-layer-2-abstraction): W5 filed — six epics, status …
claude Sep 19, 2026
37cead0
project(workforce-layer-2-abstraction): W5 through its gate — and W3 …
claude Sep 20, 2026
5f6532f
project(workforce-layer-2-abstraction): fold both wraps — W3 and W4
claude Sep 20, 2026
dab47e6
project(workforce-layer-2-abstraction): org/channels becomes an ask, …
claude Sep 20, 2026
a33c66e
project(workforce-layer-2-abstraction): the kitchen-sink rebuild is i…
claude Sep 20, 2026
706128d
project(workforce-layer-2-abstraction): refresh — FIX-1528 plane isol…
claude Sep 23, 2026
fb22dc6
Merge main into the project branch; drop this branch's ci.yml fork
claude Sep 23, 2026
8ac2384
project(workforce-layer-2-abstraction): update — FIX-1528 approved an…
claude Sep 24, 2026
2164fe3
project(workforce-layer-2-abstraction): update — FIX-1528 plane isola…
claude Sep 24, 2026
7b83ed8
project(workforce-layer-2-abstraction): update — W5 release QA wrapped
claude Sep 24, 2026
9ac0f48
project(workforce-layer-2-abstraction): update — kitchen-sink rebuild…
claude Sep 24, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 67 additions & 0 deletions spec/_projects/workforce-layer-2-abstraction/BUSINESS-RULES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Rules — Workforce: Layer 2 Abstraction

[Spec](SPEC.md) · [Decisions](DECISIONS.md) · **Rules** · [Plan](PLAN.md)

What every epic under this project obeys. Each rule has **exactly one owner** — the epic that
implements and proves it; the others inherit it. A rule with two owners is a seam; a rule with none
is a wish.

| | Rule | Owner | Checked where |
|---|---|---|---|
| **PR-1** | When a concept is proposed for this project, then it ships here only if there are **several valid assemblies** of it; exactly one → it is substrate and lives in `core` / `engine` / `orchestration` | FIX-1332 | The epic objective gate |
| **PR-2** | When a convention needs behaviour, then it **composes Layer 1 primitives** and never introduces a parallel primitive — Layer 2 stays transparently implemented, no black box | FIX-1332 | Package-boundary review |
| **PR-3** | When a convention ships, then it ships with a **reader and a consumer that exercises it**, not a format alone | FIX-1351 | The thin pentest lab |
| **PR-4** | When a file declares a thing, then every key the convention **derives** is refused by name — a file may not say where it lives, what its identity is, or what its state shape is | FIX-1351 | Reader tests, per-convention |
| **PR-5** | When a new surface names a Layer 2 concept, then it uses the **settled name** (Role, Strategy, Instructions, stream visibility), never the superseded one | FIX-1407 | A check over the changing epic's own diff. W4 met it that way (ER-19); the repo-wide pass is **unowned** |
| **PR-6** | When an epic writes a hireable worker kind, then it **composes `workerConfigSchema()`** — the four imposed keys `instructions`, `teamInstructions`, `seatSkills`, `seatTools` — and a file that authors any of them is refused by name | FIX-1351 | The closed schema at every mint; a kind that cannot take the bag refuses at boot, naming the key |
| **PR-7** | When an epic needs a fence on a hired seat, then it sits at a framework seam (dispatch, admission or read) and is proved on the real path, **never only in kitchen-sink or a Lab**, where a host that copies the app gets no fence | FIX-1528 | The epic objective gate; `goals/hire-plane/` on the real router and worker pool |

**No epic may:**

- Add a **second claim system**. There is one task board and correctness depends on that (PD-2).
- Expose the **agent bundle** — Persona, Skills, Memory, Instructions, Strategy — as the public
API. An Agent is invoked or assigned work, not decomposed (PD-3).
- Run the **propagation pass** before the vocabulary locks (PD-4). Renaming an unratified model
costs the rename twice. **W4's wrap is folded and the answer is that the pass did not run:** what
FIX-1385 owed was a name check over W4's own diff, ER-19 was narrowed to exactly that, and the
repo-wide pass was **named out at the wrap with no owner**
([Decisions](DECISIONS.md) → *Recorded at the wrap*). The prohibition now stands on PD-4 alone,
with no epic holding it and nobody scheduled to run it.
- Introduce **Agent, Team, Channel, MessageBoard or TeamFlow as a Layer 1 type**. This is the
standing instance of PR-1 and it is carried in the invent-kill of every epic body under this
project, W2 through FIX-1455. It is listed by name because a prohibition every epic restates
privately is one the next epic can miss.
- Stand up a **parallel plane beside boards and seats** for a job they already do — a second
human-in-the-loop work plane outside them (a person answers through a **flow action** on a row an
agent owns and parked), a per-app config store beside the shipped persistence, or a seat
assembled through `@flow-state-dev/patterns` factories rather than hired as a kind. Each is a
second of something PD-1 says there is one of.
- Add a **`FlowNavigator` slot** without the owner. Row actions go in `leafToolbar`, content under
an open leaf in `leafDetail`, and that exception was the owner's (FIX-1561 D1)
([Decisions](DECISIONS.md) → *decided once*).
- Put a concept here **because it is convenient**. PR-1 is a test, not a preference.

**PR-7 was FIX-1528's ER-12, promoted at its wrap** because two live siblings were bound by it.
Both have wrapped, W5 and then the kitchen-sink rebuild. The kitchen-sink rebuild shipped a manager seat that hires (FIX-1527) and an org and seat path in
its rail (FIX-1500) with no local fence; where it had to touch access, FIX-1563 changed only **who
the caller is** and left reaching the seat to the pin ([Decisions](DECISIONS.md) → *decided once*).
No epic is running now, so PR-7 binds whichever comes next.

---

## Where PR-4 came from, and why it is worded this way

PR-4 is the one rule here that was **corrected after it was first written**, and the correction is
the reason it names *derived keys* rather than a specific key.

It began inside [FIX-1354](https://linear.app/fixpoint-labs/issue/FIX-1354) §7 as a table of seven inherited shape rules — a rule set living inside a
document it governs, where a sibling epic could not find it. Two of those rules were wrong; the
correction reached a comment on a Linear issue and never reached the table. Review then found, by
running it, that carrying the remaining frontmatter through verbatim let a file point itself at
another document's storage row.

So the rule is stated as the general form — *every derived key is refused* — rather than as the one
key that happened to be found first. **That generalization is the rule; a list of refused key names
would rot the same way the original table did.**

This is also the clearest argument for why this document exists at project altitude at all.
Loading
Loading