A record from the Factory repository, docs/composition.json, shown exactly as committed. Every hash, date and count is as recorded. The build review says what the Factory's receipts support.
{
"schema": "factory-composition/1",
"asOf": "2026-10-03",
"factory": {
"status": "progress",
"summary": "A bounded local composition of caller-prepared public stages, preserving native authority, original work identities and existing allowances. Portfolio scheduling, live providers and customer release retain separate commissions.",
"capabilities": [
"Runs thirteen prepared native stage kinds",
"Stops for missing input and retains original identities",
"Preserves native Authority and Budget",
"Recovers original uncertain integration before fresh work",
"Offers observational Marketing with current supported facts"
],
"uses": [
"local-fixture-worker",
"guarded-verification",
"portfolio",
"dashboard",
"attention",
"owner-digest",
"owner-policy",
"project-guidance",
"guidance-acceptance",
"branch-health",
"prevention-register",
"lifecycle-schedule",
"provider-events",
"provider-subscriptions",
"provider-events-rpc",
"provider-guidance-tools",
"factory-workflow"
],
"composes": [
"research",
"planning",
"implementation",
"verification",
"release",
"end-to-end-delivery",
"marketing",
"outcome-validation",
"repair",
"simplification",
"service-access-operations",
"knowledge"
],
"ensemble": [
"portfolio",
"dashboard",
"attention",
"project-guidance",
"lifecycle-schedule"
]
},
"workflows": [
{
"id": "research",
"name": "Research",
"status": "progress",
"summary": "Turns a question or Objective into attributed findings and proposals, on demand, with no Factory schedule.",
"guide": null,
"capabilities": [
"Reads commissioned public Sources with checkable citations",
"Keeps findings attributed, with unknowns and expiry",
"Proposes work; selecting a Slice is a separate decision"
],
"uses": [
"discovery-sources",
"evidence-assurance",
"command-journal",
"intelligence",
"research-semantics"
],
"plannedUses": [
"lifecycle-schedule",
"temporal-planning"
],
"missing": [
"Full root and exact-main CI qualification"
],
"nested": [],
"ensemble": [
"discovery-sources",
"intelligence",
"evidence-assurance",
"lifecycle-schedule",
"command-journal"
],
"source": "guide/research-semantics.md"
},
{
"id": "planning",
"name": "Planning and prioritisation",
"status": "planned",
"summary": "Chooses the next most valuable Slice within capacity and dates, and records why.",
"guide": null,
"capabilities": [
"Ranks needs by evidenced value and cost",
"Relates sourced dates, capacity and dependencies",
"Frames Slices with Outcome, scope and acceptance"
],
"uses": [],
"plannedUses": [
"project-guidance",
"portfolio",
"temporal-planning",
"capacity-planning",
"proposal-ownership",
"architecture-practice"
],
"missing": [
"Opportunity gate",
"Owner decision bundle",
"Objective and Capability records"
],
"nested": [],
"ensemble": [
"project-guidance",
"portfolio"
],
"source": "implementation.md#e14--spend-delivery-capacity-on-the-strongest-evidenced-need"
},
{
"id": "implementation",
"name": "Implementation",
"status": "progress",
"summary": "A rigorous engineering loop: turns a ready, scoped Slice with a stated Outcome into an immutable Candidate and its execution Evidence.",
"guide": null,
"capabilities": [
"Takes a ready Slice, snapshot, workspace and Budget",
"Proposes bounded edits; seals one immutable Candidate",
"Records execution Evidence; never judges its own work"
],
"uses": [
"execution",
"attempt-fence",
"repository",
"product-gate",
"producer",
"evidence-assurance",
"implementation-workflow"
],
"plannedUses": [
"project-guidance",
"intelligence",
"architecture-practice"
],
"missing": [
"Full root and exact-main CI qualification",
"A qualified live model provider"
],
"nested": [],
"ensemble": [
"product-gate",
"producer",
"attempt-fence",
"execution",
"repository"
],
"source": "guide/implementation-workflow.md"
},
{
"id": "verification",
"name": "Verification",
"status": "progress",
"summary": "Gives an independently justified Verdict for a Candidate, including one produced outside Factory.",
"guide": null,
"capabilities": [
"Runs frozen checks on a sealed Candidate in a sandbox",
"Judges stored Evidence: Verified, Failed or Inconclusive",
"Keeps the verifier independent of the implementer"
],
"uses": [
"product-gate",
"repository",
"attempt-fence",
"repository-collector",
"confined-executor",
"evidence-assurance",
"repository-assurance",
"verification-workflow"
],
"plannedUses": [],
"missing": [
"Full root and exact-main CI qualification"
],
"nested": [],
"ensemble": [
"repository-collector",
"confined-executor",
"repository-assurance",
"evidence-assurance",
"attempt-fence"
],
"source": "guide/verification-workflow.md"
},
{
"id": "release",
"name": "Release and recovery",
"status": "planned",
"summary": "Exposes a verified change by risk, watches customer health and restores service first when harm appears.",
"guide": null,
"capabilities": [
"Integrates only on a current Verdict",
"Exposes changes progressively by risk",
"Restores service before diagnosing incidents"
],
"uses": [],
"plannedUses": [
"repository",
"product-gate",
"branch-health",
"service-access"
],
"missing": [
"Action gateway",
"Release adapter",
"Independent recovery controller"
],
"nested": [],
"ensemble": [
"repository",
"product-gate",
"service-access"
],
"source": "implementation.md#e03--prove-the-pilot-can-be-exposed-and-recovered-safely"
},
{
"id": "end-to-end-delivery",
"name": "End-to-end delivery",
"status": "progress",
"summary": "Runs authored local Delivery through native verification, guarded integration and observational assessment. Production release and live customer outcomes require separate adapters and authority.",
"guide": null,
"capabilities": [
"Binds and freezes a caller-authored Slice",
"Runs native Implementation and independent Verification",
"Integrates once and assesses retained evidence"
],
"uses": [
"delivery-composition"
],
"plannedUses": [
"architecture-practice"
],
"missing": [
"Full root and exact-main CI qualification",
"Customer release and live qualification"
],
"nested": [
"implementation",
"verification"
],
"ensemble": [],
"source": "guide/delivery.md"
},
{
"id": "marketing",
"name": "Marketing",
"status": "progress",
"summary": "Produces truthful, fact-linked material from confirmed release and benefit facts. Steps 1 and 2 are integrated drafts, not accepted; publishing is separate and optional.",
"guide": "guide/marketing-workflow.md",
"capabilities": [
"Writes only from typed, current, supported facts",
"Checks competitors' public claims first",
"Runs as a resumable job with a pluggable drafter",
"Times and publishes only through authorised adapters"
],
"uses": [
"command-journal"
],
"plannedUses": [
"intelligence",
"material-timing",
"temporal-planning",
"lifecycle-schedule",
"service-access",
"discovery-sources"
],
"missing": [
"A qualified drafting model",
"Publication adapter with Receipts",
"Release and benefit fact sources",
"Action gateway"
],
"nested": [],
"ensemble": [
"service-access",
"lifecycle-schedule",
"intelligence",
"command-journal"
],
"source": "implementation.md#e33--produce-truthful-marketing-independently"
},
{
"id": "outcome-validation",
"name": "Outcome validation",
"status": "planned",
"summary": "Compares independently checked observations with a Slice's intended Outcome and records the Assessment.",
"guide": null,
"capabilities": [
"Measures against a predeclared rule and window",
"Concludes Supported, Rejected or Inconclusive",
"Never hides a Rejected result"
],
"uses": [],
"plannedUses": [
"product-gate",
"evidence-assurance",
"operational-signals"
],
"missing": [
"Measurement contracts",
"Experiment evaluator"
],
"nested": [],
"ensemble": [
"product-gate",
"evidence-assurance"
],
"source": "implementation.md#e05--know-whether-the-pilot-helped"
},
{
"id": "repair",
"name": "Repair",
"status": "planned",
"summary": "Turns operational failures into bounded repairs whose production result and source feedback are independently accounted for.",
"guide": null,
"capabilities": [
"Reads redacted crash and performance Signals",
"Reproduces before repairing; verifies before and after",
"Closes the source only through an authorised Action"
],
"uses": [
"operational-signals"
],
"plannedUses": [
"proposal-ownership",
"product-gate",
"service-access",
"architecture-practice"
],
"missing": [
"Source adapters and detectors",
"Case and episode state",
"Production evaluator",
"Action gateway"
],
"nested": [
"implementation",
"verification"
],
"ensemble": [
"service-access",
"producer",
"repository",
"repository-assurance",
"product-gate"
],
"source": "implementation.md#e38--repair-operational-failures-through-verified-production-closure"
},
{
"id": "simplification",
"name": "Simplification and retirement",
"status": "planned",
"summary": "Keeps the parts small and deep: refactors where evidence shows friction and retires what no longer earns its cost.",
"guide": null,
"capabilities": [
"Finds duplication and boundary friction weekly",
"Proposes refactors that keep every ability",
"Retires behaviour without stranding customers"
],
"uses": [],
"plannedUses": [
"intelligence",
"repository",
"architecture-practice"
],
"missing": [
"Capability records",
"Retirement obligation checks"
],
"nested": [],
"ensemble": [
"intelligence",
"repository"
],
"source": "implementation.md#e25--simplify-weekly-without-losing-abilities"
},
{
"id": "service-access-operations",
"name": "Service access operations",
"status": "planned",
"summary": "Keeps every Product's access to outside services available within Authority, without exposing secret values.",
"guide": null,
"capabilities": [
"Knows which services each Product uses",
"Brokers credentials without revealing their values",
"Renews and revokes access within Authority"
],
"uses": [],
"plannedUses": [
"service-access"
],
"missing": [
"Access runbooks",
"Credential vault",
"Credential broker"
],
"nested": [],
"ensemble": [],
"source": "implementation.md#e20--keep-operating-access-available-within-authority"
},
{
"id": "knowledge",
"name": "Knowledge capture and retrieval",
"status": "progress",
"summary": "Keeps decisions and lessons findable, so later work starts from what is already known.",
"guide": null,
"capabilities": [
"Documents architecture and practice decisions",
"Records decisions with their reasons and sources",
"Retrieves relevant prior decisions for new work"
],
"uses": [
"knowledge-core"
],
"plannedUses": [
"architecture-practice"
],
"missing": [
"Full root and exact-main CI qualification"
],
"nested": [],
"ensemble": [],
"source": "guide/knowledge.md"
}
],
"groups": [
{
"id": "records",
"name": "Records and runs",
"summary": "The shared durable store and the foundations every job relies on."
},
{
"id": "isolation",
"name": "Isolation and execution",
"summary": "Bounded, owned and sandboxed work."
},
{
"id": "assurance",
"name": "Assurance",
"summary": "Independent checks and Verdicts from stored Evidence."
},
{
"id": "delivery",
"name": "Repository and delivery",
"summary": "Proposals, sealed Candidates and guarded integration."
},
{
"id": "architecture",
"name": "Architecture and knowledge",
"summary": "Design decisions in proportion to scale and risk."
},
{
"id": "guidance",
"name": "Planning and guidance",
"summary": "Values, dates, capacity and proposals that inform choices."
},
{
"id": "operations",
"name": "Operations and signals",
"summary": "Health, failures, guardrails and timed checks."
},
{
"id": "owner",
"name": "Portfolio and owner view",
"summary": "What the owner sees, is asked and has decided."
},
{
"id": "provider",
"name": "Provider events",
"summary": "Scoped notifications to the owner's assistant."
},
{
"id": "shared",
"name": "Models, research and access",
"summary": "Model routes, public Sources and where credentials live."
}
],
"modules": [
{
"id": "command-journal",
"name": "Command journal",
"group": "records",
"status": "accepted",
"guide": "guide/command-journal.md",
"portrait": "brand/assets/family-v2/plumb-command-journal.png",
"capabilities": [
"Records each Command once, with result and Events",
"Replays the recorded answer on retry",
"Refuses stale or conflicting commands"
]
},
{
"id": "execution",
"name": "Execution",
"group": "records",
"status": "accepted",
"guide": "guide/execution.md",
"portrait": "brand/assets/family-v2/plumb-execution.png",
"capabilities": [
"Owns each Run and Attempt",
"Holds a fixed Budget and durable cancellation",
"Starts nothing on its own"
]
},
{
"id": "evidence-assurance",
"name": "Evidence / Assurance",
"group": "records",
"status": "accepted",
"guide": "guide/evidence-assurance.md",
"portrait": "brand/assets/family-v2/plumb-evidence-assurance.png",
"capabilities": [
"Keeps content-addressed, attributable Evidence",
"Folds Evidence into a three-valued Verdict",
"Missing Evidence never passes"
],
"parts": [
{
"name": "Evidence store",
"does": "Stores each process observation once, content-addressed"
},
{
"name": "Assurance judge",
"does": "Judges gathered Evidence into a local-fixture Verdict"
}
]
},
{
"id": "attempt-fence",
"name": "Attempt fence / workspace",
"group": "isolation",
"status": "accepted",
"guide": "guide/attempt-fence.md",
"portrait": "brand/assets/family-v2/plumb-attempt-fence.png",
"capabilities": [
"One ownership gate per Attempt",
"A fresh private workspace",
"Stale owners cannot resume"
],
"parts": [
{
"name": "Attempt fence",
"does": "Gates Attempt ownership with a kernel-released lock"
},
{
"name": "Attempt workspace",
"does": "Provisions and disposes a private directory per Attempt"
}
]
},
{
"id": "local-fixture-worker",
"name": "Local fixture worker",
"group": "isolation",
"status": "accepted",
"guide": "guide/local-fixture-worker.md",
"portrait": "brand/assets/family-v2/plumb-local-fixture-worker.png",
"capabilities": [
"Runs built-in fixtures as bounded processes",
"Records process Evidence",
"Leaves judgement to Assurance"
],
"parts": [
{
"name": "Fixture worker",
"does": "Runs one fixture as a bounded child and stores Evidence"
},
{
"name": "Fixture programs",
"does": "Provides the pass, fail, hang and noisy child programs"
},
{
"name": "Fence gate preload",
"does": "Makes the child hold the Attempt fence before code runs"
},
{
"name": "Execution manifest",
"does": "Hashes the guarded fixture sources into one digest"
}
]
},
{
"id": "confined-executor",
"name": "Confined executor",
"group": "isolation",
"status": "accepted",
"guide": "guide/confined-executor.md",
"portrait": "brand/assets/family-v2/plumb-confined-executor.png",
"capabilities": [
"Runs one program against read-only snapshots",
"A macOS sandbox with no network or writes",
"Observes and reports; never judges"
]
},
{
"id": "guarded-verification",
"name": "Guarded verification / recovery",
"group": "assurance",
"status": "accepted",
"guide": "guide/guarded-verification.md",
"portrait": "brand/assets/family-v2/plumb-guarded-verification.png",
"capabilities": [
"Verifies a fixture under exclusive ownership",
"Settles orphaned Attempts within Budget",
"Separates a past Verdict from current validity"
],
"parts": [
{
"name": "Verification policy",
"does": "Verifies, recovers, cancels and inspects guarded Runs"
},
{
"name": "Attempt ledger",
"does": "Records Attempt preparations, reports and fence proofs"
},
{
"name": "Fixture command line",
"does": "Runs verify, inspect, cancel and recover from the shell"
}
]
},
{
"id": "repository-collector",
"name": "Repository collector",
"group": "assurance",
"status": "accepted",
"guide": "guide/repository-collector.md",
"portrait": "brand/assets/family-v2/plumb-repository-collector.png",
"capabilities": [
"Runs a Candidate's frozen checks in the sandbox",
"Stores one Evidence record per run",
"Refuses mismatched pins before anything runs"
],
"parts": [
{
"name": "Check collector",
"does": "Runs each process check once and stores its Evidence"
},
{
"name": "Snapshot store",
"does": "Keeps frozen Slice fixture inputs, written once"
}
]
},
{
"id": "repository-assurance",
"name": "Repository Assurance",
"group": "assurance",
"status": "accepted",
"guide": "guide/repository-assurance.md",
"portrait": "brand/assets/family-v2/plumb-repository-assurance.png",
"capabilities": [
"Judges a sealed Candidate from stored Evidence",
"Authenticates its manifest and base",
"Never relabels fixture proof"
],
"parts": [
{
"name": "Frozen Slice records",
"does": "Parses and digests acceptance, recipe and environment"
},
{
"name": "Observation format",
"does": "Encodes and decodes repository observation records"
},
{
"name": "Repository judge",
"does": "Judges Candidate Evidence into a repository Verdict"
}
]
},
{
"id": "repository",
"name": "Repository sealing / export and integration",
"group": "delivery",
"status": "accepted",
"guide": "guide/repository.md",
"portrait": "brand/assets/family-v2/plumb-repository.png",
"capabilities": [
"Seals bounded edits as an immutable Candidate",
"Exports the exact bytes",
"Moves a branch at most once; no blind retry"
],
"parts": [
{
"name": "Candidate sealing",
"does": "Seals proposals as Candidates and exports their bytes"
},
{
"name": "Guarded integration",
"does": "Moves the target ref once per prepared Action"
},
{
"name": "Shared wire grammar",
"does": "Parses identities and intents and encodes Git objects"
}
]
},
{
"id": "product-gate",
"name": "Product gate and delivery records",
"group": "delivery",
"status": "accepted",
"guide": "guide/product-gate.md",
"portrait": "brand/assets/family-v2/plumb-product-gate.png",
"capabilities": [
"Holds per-Product grants, revocation and stop",
"Freezes Slices with allowances",
"Admits integration only on a current Verdict"
],
"parts": [
{
"name": "Product gate",
"does": "Admits production, checks and integration per Product"
},
{
"name": "Pre-effect check",
"does": "Answers whether an admitted dispatch may act now"
},
{
"name": "Delivery records",
"does": "Keeps create-once delivery inputs and results"
},
{
"name": "Assessment derivation",
"does": "Derives a Slice Assessment from a reproduced Verdict"
}
]
},
{
"id": "producer",
"name": "Producers",
"group": "delivery",
"status": "accepted",
"guide": "guide/producer.md",
"portrait": "brand/assets/family-v2/plumb-producer.png",
"capabilities": [
"Asks a model once for proposed edits",
"Returns an untrusted Proposal for sealing",
"Never applies, integrates or judges"
],
"parts": [
{
"name": "Producer contract",
"does": "Defines the provider-neutral request, result and gate"
},
{
"name": "Claude producer",
"does": "Proposes edits through the pinned Claude Code CLI"
},
{
"name": "OpenAI producer",
"does": "Proposes edits through the OpenAI Responses API"
},
{
"name": "Qualification script",
"does": "Runs a bounded live qualification and writes Receipts"
}
]
},
{
"id": "architecture-practice",
"name": "Architecture and practice guidance",
"group": "architecture",
"status": "proposed",
"guide": null,
"portrait": null,
"capabilities": [
"Recommends architecture and practice per delivery mode",
"Explains what each delivery mode gains and costs",
"Drafts ADRs citing patterns, practice and idioms",
"Advises only; flags usage outgrowing the mode"
],
"parts": [
{
"name": "Delivery mode advisor",
"does": "Explains each mode and proposes a mode review"
},
{
"name": "Code analysis",
"does": "Reads a pinned snapshot read-only under a cap"
},
{
"name": "Practice catalogue",
"does": "Holds reviewed styles, patterns, practices and idioms"
},
{
"name": "ADR drafter and validator",
"does": "Drafts a proposed ADR and rejects incomplete ones"
}
]
},
{
"id": "project-guidance",
"name": "Project guidance",
"group": "guidance",
"status": "accepted",
"guide": "guide/project-guidance.md",
"portrait": "brand/assets/family-v2/plumb-project-guidance.png",
"capabilities": [
"Up to eight core values per Product",
"Immutable revisions and pins",
"Names exactly which guidance applied"
],
"parts": [
{
"name": "Guidance core",
"does": "Records Product values as pinned, digest-bound revisions"
},
{
"name": "Values editor",
"does": "Lets the owner view and edit values in the browser"
}
]
},
{
"id": "temporal-planning",
"name": "Temporal Planning",
"group": "guidance",
"status": "accepted",
"guide": "guide/temporal-planning.md",
"portrait": "brand/assets/family-v2/plumb-temporal-planning.png",
"capabilities": [
"Keeps attributed date claims and precision",
"Checks dependencies and notice windows",
"Retains disagreements and unknowns"
]
},
{
"id": "capacity-planning",
"name": "Capacity planning",
"group": "guidance",
"status": "accepted",
"guide": "guide/capacity-planning.md",
"portrait": "brand/assets/family-v2/plumb-capacity-planning.png",
"capabilities": [
"Conditional capacity scenarios",
"Shows deficits, reserves and unknowns",
"Reserves no quota and admits nothing"
],
"parts": [
{
"name": "Capacity forecast",
"does": "Forecasts headroom and a completion range"
},
{
"name": "Outcome comparison",
"does": "Compares a recorded forecast with the actual outcome"
}
]
},
{
"id": "material-timing",
"name": "Material Timing",
"group": "guidance",
"status": "accepted",
"guide": "guide/material-timing.md",
"portrait": "brand/assets/family-v2/plumb-material-timing.png",
"capabilities": [
"Checks material slots against calendar rules",
"Readiness, embargo, notice and DST checks",
"Publishes nothing; reserves no channel"
]
},
{
"id": "proposal-ownership",
"name": "Proposal ownership",
"group": "guidance",
"status": "accepted",
"guide": "guide/proposal-ownership.md",
"portrait": "brand/assets/family-v2/plumb-proposal-ownership.png",
"capabilities": [
"Keeps immutable typed proposals",
"First offer fixes ownership permanently",
"Starts no delivery"
],
"parts": [
{
"name": "Proposal ownership",
"does": "Fixes one owner per proposal generation at first offer"
},
{
"name": "Notification ownership",
"does": "Owns one notification occurrence on the same record"
}
]
},
{
"id": "guidance-acceptance",
"name": "Guidance acceptance",
"group": "guidance",
"status": "accepted",
"guide": "guide/guidance-acceptance.md",
"portrait": "brand/assets/family-v2/plumb-guidance-acceptance.png",
"capabilities": [
"Applies one offered Guidance command",
"Reconciles it against recorded history",
"Replay returns the original revision"
]
},
{
"id": "branch-health",
"name": "Branch health",
"group": "operations",
"status": "accepted",
"guide": "guide/branch-health.md",
"portrait": "brand/assets/family-v2/plumb-branch-health.png",
"capabilities": [
"Reads branch checks and workflow history",
"Red, green or unknown per Product",
"Keeps failure episodes; mirrors blockers"
],
"parts": [
{
"name": "Health and episode core",
"does": "Derives Product health and failure episodes per poll"
},
{
"name": "GitHub reader",
"does": "Reads branch checks and workflow runs, read-only"
},
{
"name": "Portfolio mirror",
"does": "Mirrors each episode as a Portfolio blocker fact"
}
]
},
{
"id": "operational-signals",
"name": "Operational Signals",
"group": "operations",
"status": "accepted",
"guide": "guide/operational-signals.md",
"portrait": "brand/assets/family-v2/plumb-operational-signals.png",
"capabilities": [
"Accepts redacted, authenticated observations",
"Commits Signals and coverage together",
"A gap is never shown as healthy"
]
},
{
"id": "prevention-register",
"name": "Prevention register",
"group": "operations",
"status": "progress",
"guide": "guide/prevention-register.md",
"portrait": "brand/assets/family-v2/plumb-prevention-register.png",
"capabilities": [
"Says whether each guardrail is in place",
"Records results and owner exemptions",
"Never a default pass"
],
"parts": [
{
"name": "Guardrail templates",
"does": "Holds three frozen, digest-pinned guardrail rules"
},
{
"name": "Presence evaluation",
"does": "Turns supplied reads into one presence fact per rule"
},
{
"name": "Write-once records",
"does": "Records results and owner exemptions once"
},
{
"name": "Visibility read",
"does": "Reads repository visibility with one GitHub request"
}
]
},
{
"id": "lifecycle-schedule",
"name": "Lifecycle schedule",
"group": "operations",
"status": "progress",
"guide": "guide/lifecycle-schedule.md",
"portrait": "brand/assets/family-v2/plumb-lifecycle-schedule.png",
"capabilities": [
"Keeps the timetable of named checks",
"Admits, defers and settles each occurrence once",
"Runs nothing by itself yet"
],
"parts": [
{
"name": "Occurrence timetable",
"does": "Names, admits, defers and settles each occurrence"
},
{
"name": "Provider call ledger",
"does": "Admits each provider call within the weekly ceiling"
},
{
"name": "LaunchAgent renderer",
"does": "Returns LaunchAgent text without writing or loading it"
}
]
},
{
"id": "portfolio",
"name": "Portfolio",
"group": "owner",
"status": "accepted",
"guide": "guide/portfolio.md",
"portrait": "brand/assets/family-v2/plumb-portfolio.png",
"capabilities": [
"Registers each Product with one checkout",
"Shows sourced facts and usage",
"Unknown is never shown as zero"
],
"parts": [
{
"name": "Product registry",
"does": "Registers Products, each bound to one Git checkout"
},
{
"name": "Fact and usage streams",
"does": "Records sourced facts and usage Receipts per Product"
},
{
"name": "Sourced views",
"does": "Builds Product, Portfolio, condition and blocker views"
},
{
"name": "Read-only collectors",
"does": "Inspects checkouts and maps model results to Receipts"
}
]
},
{
"id": "dashboard",
"name": "Dashboard",
"group": "owner",
"status": "accepted",
"guide": "guide/dashboard.md",
"portrait": "brand/assets/family-v2/plumb-dashboard.png",
"capabilities": [
"A local browser view of progress and usage",
"Actions, values and the digest in one place",
"Guarded Portfolio and configured milestone commands"
],
"parts": [
{
"name": "JSON contract",
"does": "Defines the versioned records the browser reads"
},
{
"name": "View projection",
"does": "Projects Portfolio, attention and guidance reads"
},
{
"name": "HTTP server",
"does": "Serves loopback routes and configured guarded commands"
},
{
"name": "Browser app",
"does": "Formats and lays out pages without computing counts"
}
]
},
{
"id": "attention",
"name": "Required actions and blockers",
"group": "owner",
"status": "accepted",
"guide": "guide/attention.md",
"portrait": "brand/assets/family-v2/plumb-attention.png",
"capabilities": [
"One list of reported actions and blockers",
"Names an owner before saying it needs you",
"Guides blocker resolution"
],
"parts": [
{
"name": "Attention list",
"does": "Projects sourced conditions into actions and notices"
},
{
"name": "Blocker detail",
"does": "Shows a blocker report, standing and retained history"
},
{
"name": "Actions and blocker pages",
"does": "Lists items and blocker detail in the browser"
}
]
},
{
"id": "owner-digest",
"name": "Owner digest",
"group": "owner",
"status": "accepted",
"guide": "guide/owner-digest.md",
"portrait": "brand/assets/family-v2/plumb-owner-digest.png",
"capabilities": [
"Cited exception batches",
"A short weekly digest",
"Green only when the evidence agrees"
],
"parts": [
{
"name": "Exception batches",
"does": "Forms up to three daily batches of new episodes"
},
{
"name": "Weekly digest",
"does": "Renders a cited Monday digest of at most 150 words"
},
{
"name": "Owner notes",
"does": "Records delight and frustration notes per week"
},
{
"name": "Factory reader",
"does": "Reads Branch health, Portfolio and Attention"
}
]
},
{
"id": "owner-policy",
"name": "Owner policy",
"group": "owner",
"status": "accepted",
"guide": "guide/owner-policy.md",
"portrait": "brand/assets/family-v2/plumb-owner-policy.png",
"capabilities": [
"Records asks, answers and minutes",
"Keeps rules you confirm, on test data (draft)",
"Weekly counts with honest unknowns"
],
"parts": [
{
"name": "Ask ledger",
"does": "Records and counts owner asks per ISO week"
},
{
"name": "Owner rules",
"does": "Keeps owner-confirmed rules and answers whether to ask",
"status": "draft"
}
]
},
{
"id": "provider-events",
"name": "Provider events",
"group": "provider",
"status": "accepted",
"guide": "guide/provider-events.md",
"portrait": "brand/assets/family-v2/plumb-provider-events.png",
"capabilities": [
"Projects one scoped notification",
"Checks caller permission and pins",
"Quiet when nothing changed"
]
},
{
"id": "provider-subscriptions",
"name": "Provider subscriptions",
"group": "provider",
"status": "accepted",
"guide": "guide/provider-subscriptions.md",
"portrait": "brand/assets/family-v2/plumb-provider-subscriptions.png",
"capabilities": [
"Bounded subscription lifecycle",
"Rechecks permission before contact",
"Signed verification only; no delivery"
]
},
{
"id": "provider-events-rpc",
"name": "Provider event requests",
"group": "provider",
"status": "accepted",
"guide": "guide/provider-events-rpc.md",
"portrait": "brand/assets/family-v2/plumb-provider-events-rpc.png",
"capabilities": [
"Routes list, subscribe and unsubscribe",
"A lost reply stays unknown",
"Starts no server and sends no events"
]
},
{
"id": "provider-guidance-tools",
"name": "Provider Guidance tools",
"group": "provider",
"status": "accepted",
"guide": "guide/provider-guidance-tools.md",
"portrait": "brand/assets/family-v2/plumb-provider-guidance-tools.png",
"capabilities": [
"Inspects one offered Guidance proposal",
"Applies it through its existing receiver",
"No new authority or automatic retry"
],
"parts": [
{
"name": "Inspect offer tool",
"does": "Reads one offered Guidance generation, read-only"
},
{
"name": "Apply offer tool",
"does": "Requests only the original commissioned Guidance command"
}
]
},
{
"id": "intelligence",
"name": "Intelligence",
"group": "shared",
"status": "accepted",
"guide": "guide/intelligence.md",
"portrait": "brand/assets/family-v2/plumb-intelligence.png",
"capabilities": [
"Says which modules may use a model and why",
"Owner-approved model lists per task",
"Refuses rather than substitutes"
],
"parts": [
{
"name": "Intelligence registry",
"does": "Declares where each Module may use a model, and why"
},
{
"name": "Model selector",
"does": "Picks the first eligible approved model for a task"
},
{
"name": "Declaration tables",
"does": "Renders the README and reference Intelligence tables"
}
]
},
{
"id": "discovery-sources",
"name": "Discovery sources",
"group": "shared",
"status": "accepted",
"guide": "guide/discovery-sources.md",
"portrait": "brand/assets/family-v2/plumb-discovery-sources.png",
"capabilities": [
"Reads commissioned public Sources",
"Keeps short, re-verifiable citations",
"Refuses oversize input; never truncates"
],
"parts": [
{
"name": "Source collector",
"does": "Fetches commissioned public Sources into Captures"
},
{
"name": "Citations and drift",
"does": "Makes, verifies and re-checks quoted Citations"
},
{
"name": "Capture cache",
"does": "Holds Capture text on disk, re-hashed on every read"
},
{
"name": "Text operations",
"does": "Extracts items, normalises text and checks quotes"
}
]
},
{
"id": "service-access",
"name": "Service access",
"group": "shared",
"status": "accepted",
"guide": "guide/service-access.md",
"portrait": "brand/assets/family-v2/plumb-service-access.png",
"capabilities": [
"Maps each Product's outside services",
"Knows where credentials live, by name only",
"Lists vault items without values (draft)",
"Never reads or records a secret value"
],
"parts": [
{
"name": "Service catalogue",
"does": "Defines frozen Service kinds, slots and signatures"
},
{
"name": "Service discovery",
"does": "Scans trees and listings for names into a Service map"
},
{
"name": "Access records",
"does": "Records bindings and pins and answers readiness"
},
{
"name": "Vault lister",
"does": "Lists one 1Password vault by names, never values",
"status": "draft"
}
]
},
{
"id": "work-items",
"name": "Work items",
"group": "owner",
"status": "progress",
"guide": "guide/work-items.md",
"portrait": null,
"capabilities": [
"Keeps per-Product work ownership",
"Refuses undeclared duplicate work",
"Reports read Git lanes without deleting them"
]
},
{
"id": "milestone-objectives",
"name": "Milestone objectives",
"group": "owner",
"status": "progress",
"guide": "guide/milestone-objectives.md",
"portrait": null,
"capabilities": [
"Retains objectives and their immutable revisions",
"Selects one next priority or none",
"No automatic Research, tickets or resource ETA"
]
},
{
"id": "milestone-research",
"name": "Milestone research handoff",
"group": "guidance",
"status": "progress",
"guide": "guide/milestone-research.md",
"portrait": null,
"capabilities": [
"Prepares an attributed first-plan draft",
"Prepares the original unassessed M01 request",
"No Research launch or new work authority"
]
},
{
"id": "milestone-work-brief",
"name": "Milestone work brief",
"group": "guidance",
"status": "progress",
"guide": "guide/milestone-work-brief.md",
"portrait": null,
"capabilities": [
"Copies one selected implementation generation",
"Keeps captured dates, counts and unknowns",
"Produces an unadmitted work brief"
]
},
{
"id": "research-jobs",
"name": "Research jobs",
"group": "shared",
"status": "progress",
"guide": "guide/research-jobs.md",
"portrait": null,
"capabilities": [
"Collects once under an existing source commission",
"Keeps untriaged coverage and short citations",
"Never renews an original allowance"
]
},
{
"id": "provider-diagnostics",
"name": "Provider diagnostics",
"group": "provider",
"status": "progress",
"guide": "guide/provider-diagnostics.md",
"portrait": null,
"capabilities": [
"Projects bounded historical provider observations",
"Keeps the original result unchanged",
"No inferred causes, retry permission or provider calls"
]
},
{
"id": "provider-event-delivery",
"name": "Provider event delivery",
"group": "provider",
"status": "progress",
"guide": "guide/provider-event-delivery.md",
"portrait": null,
"capabilities": [
"Delivers one retained notification within fixed bounds",
"Reconciles original attempts and unknown contact",
"A receipt does not prove processing or domain work"
]
},
{
"id": "delivery-composition",
"name": "Delivery composition (D4)",
"group": "delivery",
"status": "progress",
"guide": "guide/delivery.md",
"portrait": null,
"capabilities": [
"Binds a Product store and freezes authored work",
"Seals Candidates and re-derives repository Verdicts",
"Source composition with acceptance still pending"
],
"parts": [
{
"name": "Plan source records",
"does": "Retains bounded canonical fixture roots after freeze"
},
{
"name": "Authored composition",
"does": "Joins authored work to existing gate checks"
}
]
},
{
"id": "checkout-git",
"name": "Checkout Git (R7)",
"group": "delivery",
"status": "progress",
"guide": "guide/checkout-git.md",
"portrait": null,
"capabilities": [
"Reads one bounded committed blob by inspected commit",
"Preserves checkout files and configuration",
"No model, repository mutation or independent package entry"
]
},
{
"id": "research-semantics",
"name": "Research semantics",
"group": "shared",
"status": "progress",
"guide": "guide/research-semantics.md",
"portrait": null,
"capabilities": [
"Synthesises commissioned native Research evidence",
"Retains shared allowance and uncertain collection exposure"
]
},
{
"id": "knowledge-core",
"name": "Knowledge",
"group": "architecture",
"status": "progress",
"guide": "guide/knowledge.md",
"portrait": null,
"capabilities": [
"Retains reviewed lessons and current permissions",
"Offers bounded advice and authenticated planning drafts"
]
},
{
"id": "implementation-workflow",
"name": "Implementation worker workflow",
"group": "delivery",
"status": "progress",
"guide": "guide/implementation-workflow.md",
"portrait": null,
"capabilities": [
"Dispatches a real worker under a native Product hold",
"Retains original Attempt, Budget and restart identity"
]
},
{
"id": "verification-workflow",
"name": "External verification workflow",
"group": "assurance",
"status": "progress",
"guide": "guide/verification-workflow.md",
"portrait": null,
"capabilities": [
"Preflights an independently sealed caller Candidate",
"Finds original witnesses without uncertain recollection"
]
},
{
"id": "factory-workflow",
"name": "Factory concert workflow",
"group": "delivery",
"status": "progress",
"guide": "guide/factory-workflow.md",
"portrait": null,
"capabilities": [
"Composes prepared native stages through public contracts",
"Recovers original integration and stable completed replay"
]
},
{
"id": "calendar",
"name": "Calendar",
"group": "guidance",
"status": "progress",
"guide": "guide/calendar.md",
"portrait": null,
"capabilities": [
"Shared Gregorian civil-date and ISO-week arithmetic",
"Canonical host-zone conversion with fixed fold and gap rules",
"No storage, scheduling, clock read or authority"
]
}
]
}
