GWR Review Workflow (In-House)¶

Internal Operating Guide · Rev 1

6-phase dual-lane operating workflow for agents and interns conducting GWR permit reviews using the Tool_GWR_Rev1 package.

Overview¶

The GWR review is executed in six phases, each with an agent lane (autonomous execution) and an intern lane (supervised execution). Each phase has a pass/fail checkpoint before proceeding.

Phase	Name	Primary Gate(s)	Output
0	Problem Definition & Authority Lock	G0	TCD confirmed, era locked
1	Constraints & Criteria	G1, G2	Fatal constraints cleared, K_design established
2	Concept Development	Architecture check	BMP inventory, gate applicability matrix
3	Preliminary Design	G3, G4	Storage and drain time verified
4	Detailed Design / Audit Execution	G5, G6	SHWT separation + NJGRS reconstruction
5	Verification & Delivery	G7	CSV export, deficiency report, review log

Phase 0 — Problem Definition & Authority Lock¶

Objective: Freeze the governing rule era before any calculations begin.

Locate the Technical Completeness Date (TCD) from the NJDEP submission.
Compare TCD to January 20, 2026 to determine era (2023 Legacy or 2026 REAL Rule).
Set the checklist header fields (project, county, era, date).
Review Gate G0 items.

PASS checkpoint: TCD documented, era locked, G0 items reviewed.

→ See full instructions: Toolbox/Tool_GWR_Rev1/agent_workflows/phases/phase_0_problem_definition.md

Phase 1 — Constraints & Criteria (Fail-Closed Gates)¶

Objective: Confirm fatal constraints are addressed and K_design is established.

Review Gate G1 items: HPL source areas, contamination/RAWP, pretreatment.
If any G1 item is FAIL: export CSV and stop. Do not proceed.
Review Gate G2 items: test pit logs, test method, basin flood computations, K_design.
Record K_design (ft/hr) = K_field / 2.0.

PASS checkpoint: All G1 items PASS or N/A; K_design value documented.

→ See full instructions: Toolbox/Tool_GWR_Rev1/agent_workflows/phases/phase_1_constraints_criteria.md

Phase 2 — Concept Development (Audit Architecture)¶

Objective: Calibrate the gate sequence for this project before executing math.

Build BMP inventory table (BMP ID, type, dimensions, elevations).
Confirm gate applicability (required vs N/A).
Run phantom storage pre-screen (void ratio 0.40 check).
Confirm era-specific criteria matrix.

PASS checkpoint: BMP inventory complete; gate applicability documented.

→ See full instructions: Toolbox/Tool_GWR_Rev1/agent_workflows/phases/phase_2_concept_development.md

Phase 3 — Preliminary Design (Storage & Drain Time)¶

Objective: Verify storage volume (G3) and drain time (G4) for each BMP.

Use the Storage Calculator in the checklist tool for each BMP.
Use the Drain Time Calculator: t = V / (A × K_design).
Compare computed drain time to limit (≤ 72 hr or ≤ 48 hr subsurface).

PASS checkpoint: G3 and G4 items reviewed; no deficits or over-limit drain times.

→ See full instructions: Toolbox/Tool_GWR_Rev1/agent_workflows/phases/phase_3_preliminary_design.md

Phase 4 — Detailed Design / Audit Execution (SHWT & NJGRS)¶

Objective: Verify SHWT separation (G5) and NJGRS recharge reconstruction (G6).

G5: - Establish SHWT elevation from boring logs. - Compute separation = d_EXC elevation − SHWT elevation. - For 2026 era: apply mound apex correction if static separation < 5 ft. - Required: effective separation ≥ 2 ft.

G6 (if NJGRS credit claimed): - Verify pre-construction cover (2026: must be "Wooded/Good"). - Verify county rainfall factor applied (2026 only). - Spot-check credited recharge volume against order-of-magnitude estimate.

PASS checkpoint: G5 and G6 items reviewed; separation documented; NJGRS inputs confirmed.

→ See full instructions: Toolbox/Tool_GWR_Rev1/agent_workflows/phases/phase_4_detailed_design.md

Phase 5 — Verification & Delivery¶

Objective: Final QC, export artifacts, and package handoff.

Review Gate G7 deliverable integrity items.
Run 7-point unit sanity check (volume, K_design, void ratio, SHWT cross-references).
Export CSV (gwr-checklist-[Project]-[Date].csv).
Export deficiency report PDF if any FAIL or ND items.
Append row to review log.

PASS checkpoint: G7 reviewed, all items have status, CSV and PDF exported, log updated.

→ See full instructions: Toolbox/Tool_GWR_Rev1/agent_workflows/phases/phase_5_verification_delivery.md

Build & Publish¶

To update the published tool after modifying seed files or the HTML:

cd c:\Opal_Rev1
python scripts/run_gwr_workflow.py
# Optional site rebuild:
python scripts/run_gwr_workflow.py --build-site

See scripts/run_gwr_workflow.py for all options.

System Prompt for Agent-Assisted Reviews¶

When using an LLM to assist with a GWR review, load the system prompt from: Toolbox/Tool_GWR_Rev1/agent_workflows/prompts/gwr_auditor_system_prompt.md

Key hard rules encoded in the system prompt: - Authority lock before any calculations - Fatal constraints before storage math - No assumption of missing data (NOT DEMONSTRATED classification) - K_design = K_field / 2.0 (FOS = 2.0) - Void ratio ceiling = 0.40 - 2026 SHWT reference = mound apex - 2026 NJGRS cover = Wooded/Good