Forge Platform

Handbook

L3 — Use-case slice

Status: Demonstrated — PoC runs with cross-layer and E2E evidence (lenses-production-l3-ci).

Level at a glance
Autonomous unit End-to-end user-visible flow inside one existing app (UI + logic + data + tests)
What stays fixed Existing architecture, single platform
Human gate Intent + acceptance in; review out

Canonical policy: Autonomy levels (Blueprints).

Building blocks at this level

Building block Role at L3 Handbook link
Forge Dark Factory (PoC) Multi-unit plan across layers; E2E verification script Bounded execution examples
forge-lcdl Patch units tagged by layer (logic, docs, ui); proof with E2E Platform reference architecture §5
forge-workcells Worker ladder per layer unit Forge micro-agent
forge-lenses Evidence review posture (intent in, review out) Workflows and runs
blueprints L3 assay: ≥2 layers, .py + non-.py, E2E in tests_run Autonomy levels

Reference architecture flow

  [Intent + acceptance criteria in]
        |
        v
  +------------------+
  | Dark Factory PoC |
  | decompose (M)    |
  +--------+---------+
           |
           v
  +------------------+
  | plan: 3 units    |
  | logic | docs | ui|
  +--------+---------+
           |
     +-----+-----+-----+
     v     v     v
  [.py]  [md]  [html]   apply+verify per unit
     |     |     |
     +-----+-----+
           |
           v
  +------------------+
  | E2E verification |  verify-docs-health-l3.py
  | (Playwright etc.)|
  +--------+---------+
           |
           v
  +------------------+
  | assay gate       |  layers >= 2
  |                  |  .py + non-.py changed
  |                  |  e2e_pass recorded
  +--------+---------+
           |
           v
  [Human: review out + merge]

Gates and evidence

All L2 evidence, plus when final_status == pass:

  • ≥2 distinct layers touched (logic, docs, ui, etc.)
  • Both .py and non-.py files in the changed-files union
  • E2E pass recorded in tests_run (Playwright, verify-docs-health-l3, or equivalent)

PoC evidence: L3-ui-smoke and L3-scan-flow (lenses-production-l3-ci campaign) — sandbox docs-health-l3:

  • app/scanner.py (logic)
  • README.md (docs)
  • ui/index.html (ui)
  • E2E: scripts/verify-docs-health-l3.py

Implemented vs planned
Implemented L3 assay rules in assay_gate.py; multi-layer PoC campaigns; E2E verification hook
Not implemented Platform ForgeRun-native L3 enforcement; production app slices outside PoC sandbox
Planned Lenses ForgeRun campaigns with L3 manifest constraints; Playwright integration in workcells