← graph

vaughn-agency-edit

Vaughn agency: edit v3.1 + website + paste guide IN PLACE to elevate his role as agency designer

Metadata

Statusdone
Assignedagent-282
Agent identityf51439356729d112a6c404803d88015d5b44832c6c584c62b96732b63c2b0c7e
Created2026-05-02T03:33:41.099326903+00:00
Started2026-05-02T03:34:02.409118291+00:00
Completed2026-05-02T03:43:35.972099564+00:00
Tagsgrant,urgent,spot-fix,vaughn,edit, eval-scheduled
Eval score0.87
└ blocking impact0.95
└ completeness0.90
└ constraint fidelity0.70
└ coordination overhead0.90
└ correctness0.85
└ downstream usability0.85
└ efficiency0.95
└ intent fidelity0.88
└ style adherence0.95

Description

Description

Erik flagged: Vaughn Tan designed 'the agency' subsystem of WorkGraph — the system that develops, manages, and evaluates agent primitives (the named agent roles like 'Default Evaluator', 'Careful Programmer', 'Default Documenter' visible in coordinator logs as 'Lightweight assignment: agent=...'). The agency framework is based on his organizational research applied directly to making WorkGraph itself function as a coordinated multi-agent system.

This means Vaughn is co-architect of a product subsystem with concrete outputs, NOT just an embedded ethnographer studying others' use. v3.1 currently undersells him.

This task EDITS THE FILES IN PLACE. No specs. No notes docs. Real edits to:

  1. workgraph_google_application_FINAL_v3_1.md (committed at 986222f on main; edit on a worktree, commit, the merge-back happens automatically)
  2. ~/poietic.life/notes/v3-1-form-mapping-paste-guide-20260502.md (the paste guide Erik is pasting from RIGHT NOW)
  3. ~/poietic.life/index.html (the live landing page)

Erik is at the Google.org form actively pasting. Speed matters more than thoroughness. Time-box: ≤20 min wall-clock.

What to read

  1. workgraph_google_application_FINAL_v3_1.md
  2. ~/poietic.life/notes/v3-1-form-mapping-paste-guide-20260502.md (the paste guide)
  3. ~/poietic.life/index.html
  4. CLAUDE.md for Vaughn's track record
  5. Optional: .wg/agency/ directory if it has metadata clarifying what agency primitives actually are

What to do

Edit #1: v3.1 §17 (approach)

Find the §17 paragraph(s) describing the approach. Add ONE sentence (or modify an existing sentence) so the agency subsystem is named. Suggested phrasing direction: 'Vaughn's organizational research is applied as the agency framework, the subsystem of WorkGraph that develops and evaluates agent primitives — the named roles that allocate work to capable agents.'

Word cap: §17 subsections are 75w each. Recount after edit. If at cap, trim adjacent prose.

Edit #2: v3.1 §26 (uniquely positioned)

Find Vaughn's track record line. Currently mentions hybrid teams research, ASQ paper, Columbia book. Add: he designed the agency framework as direct application of his organizational research. Word cap: §26 = 150w (currently 147 — only 3 words headroom).

If §26 is at the cap and you can't add without trimming someone else, prioritize: tighten Erik or Luca's line by 3-5 words to make room for Vaughn's agency mention. Erik's vg/PGGB track record can absorb tightening; Luca's CRISPRme line less so given the precise framing rule.

Edit #3: Form §30 in paste guide (key team members, no individual names)

Find the §30 draft in the paste guide. The 4-role description should be revised so the 'organizational researcher' role explicitly describes designing the agency framework, NOT just doing case studies. Suggested phrasing direction: 'organizational researcher: designs the agency framework that develops agent primitives and matches work to agent capabilities, drawing on hybrid-teams-under-uncertainty research.'

Word cap: §30 = 100w. Recount.

Edit #4: Website mission p3 (or the latest deployed version)

Find the Vaughn sentence. Currently reads 'Vaughn uses the resulting traces as material for his research on hybrid teams.' That's backwards — his research SHAPES the agency that runs the work. Replace with something like: 'Vaughn designed the agency framework, the layer that develops WorkGraph's agent primitives from his organizational research on hybrid teams under uncertainty.'

This edit goes in the deployed ~/poietic.life/index.html. If a synthesis-driven rewrite of mission p3 was already deployed, edit on top of that current state. Commit and push to the poietic-pbc/poietic.life repo so the live site updates.

Edit #5: Optional, if time permits — v3.1 §43-§46 (milestones)

If a milestone naturally accommodates 'agency framework v2' or 'expanded agency primitives' as a deliverable, add it. Otherwise skip.

Workflow

  1. Edit each file in place on this worktree (or the appropriate worktree for the website repo, which is checked out at ~/poietic.life)
  2. Recount every touched section against its word cap
  3. Style sweep on touched text: no em-dashes, no PI, no v1 terms, founder order preserved
  4. Commit each file separately with clear messages
  5. Push the website commit (poietic.life repo) so live site updates
  6. wg log summary listing every file touched and the diff hunks

Output

A short note at ~/poietic.life/notes/vaughn-agency-edits-applied-20260502.md (under 400 words) summarizing:

  • Files edited
  • Diff hunks (terse before/after for each)
  • Final word counts on touched sections
  • Live URL of the website if updated
  • Anything Erik should re-paste from v3.1 / paste guide given the edits

Constraints

  • HARD: edit IN PLACE. Do not produce specs without applying them.
  • HARD: word caps respected. Recount.
  • HARD: no em-dashes, no PI, no v1, no recursion claim.
  • HARD: founder order Erik / Luca / Vaughn.
  • HARD: time-boxed ≤20 min.
  • SOFT: surgical edits only. Don't rewrite Erik or Luca's lines unless trimming is needed for word-cap room.

Validation

  • v3.1 §17 and §26 edited in place; word caps respected
  • Paste guide §30 draft edited in place
  • Website index.html mission p3 edited and pushed live
  • Each touched section's final word count documented
  • No em-dashes introduced
  • Output note at ~/poietic.life/notes/vaughn-agency-edits-applied-YYYYMMDD.md

Depends on

Required by

Log