Work Packets

A work packet is a small grounded slice of FPF for doing one job. It is not a replacement for the full specification.

What this page is

This is the task-sized operating surface for using FPF in real work. It turns the framework into bounded packets for project review, PR review, product-role feedback, spec writing, role analysis, and agent workflows.

Methodology

Each packet keeps five things separate: the goal, the relevant route or pattern IDs, the operating questions, the constraints, and the acceptance checks. Start with the packet, retrieve exact source only when needed, and stop when the done condition is satisfied.

Project review packet

Goal: make a project legible enough to decide the next work move.

Use:

Packet:

  • Context: what bounded context is this work inside?
  • Roles: who or what is acting, promising, deciding, or evidencing?
  • Method: what abstract way of doing is claimed?
  • Work: what actual work happened or must happen next?
  • Evidence: what would show that the next move is real?

Done when: the project has one shared context statement, one role/method/work split, one next owner, and one acceptance check.

PR or code review packet

Goal: find behavioral risk, missing evidence, or semantic drift.

Use:

  • E.8 Authoring conventions for FPF pattern or specification wording changes
  • E.19 — Pattern Quality Gates: Review & Refresh Profiles as the pattern change-record gate
  • route:writing-or-reviewing-patterns via Routes only when the PR changes FPF pattern or specification text
  • route:boundary-burden via Routes for APIs, contracts, protocols, or CI/deploy gates
  • Otherwise use this packet as the review checklist and retrieve exact IDs only when a finding depends on FPF wording

Packet:

  • Claim: what does this change promise?
  • Boundary: what interface, workflow, or invariant changed?
  • Evidence: what test, build, deploy, or trace proves it?
  • Risk: what could regress for a user or maintainer?
  • Verdict: merge, fix first, or split scope.

Done when: every finding points at a concrete behavior, file, or missing check.

Product-role feedback packet

Goal: act as one concrete user role and turn product friction into evidence-backed adoption feedback.

Use:

Packet:

  • Persona: which role is trying the product, and what job do they need done?
  • Surface: docs wiki, hosted MCP, CLI, evaluator, deploy evidence, or automation feedback.
  • Job: what concrete task should be possible without pasting the full FPF?
  • Friction: what explanation, route, affordance, evidence, or compact context was missing?
  • Evidence: URL, command, MCP call, screenshot, issue, discussion, or log path.
  • Feedback: one proposed improvement, severity, and validation path.

Done when: the role/job can be replayed by another person, the feedback points at exact evidence, and the output is either a focused PR, issue, GitHub Discussion, or no-new-feedback checkpoint.

Specification writing packet

Goal: write a spec that can be checked and evolved.

Use:

Packet:

  • Problem frame: what burden does the spec carry?
  • Scope: what is in and out?
  • Norms: which claims are requirements, recommendations, or descriptions?
  • Harness: what acceptance or regression check proves the spec holds?
  • Change record: what semantic move was made and why?

Done when: the spec has a checkable invariant, a reader-facing order, and an explicit evolution record.

Role, promise, and capability analysis packet

Goal: separate ability, promise, responsibility, and performed work.

Use:

Packet:

  • Ability: what can the system or actor do?
  • Promise: what is externally committed?
  • Role assignment: who is accountable in this context?
  • Commitment: what binds the promise to an accountable role?
  • Performance: what actual work or evidence exists?

Done when: ability, promise, role, commitment, performance, and evidence are not collapsed into one word.

Agent workflow use packet

Goal: let an agent use FPF without loading the whole FPF.

Use:

Packet:

  • Ask the agent to name the work type first.
  • Assign the work to a role before giving it write, merge, or publishing authority.
  • Retrieve the route or 3-8 exact IDs through MCP.
  • Ask for assumptions, model, options, pick, tests, risks, and next move.
  • Require citations to FPF IDs when the framework changes a decision.
  • Keep full-text pattern reads on demand.

Done when: the conversation includes enough FPF to steer the work, and not enough to bury the work.