Skip to content

OPAL Content Extraction Agents

These prompts extract structured engineering knowledge from the NJ Stormwater BMP Manual and N.J.A.C. 7:8 source PDFs and output content ready to paste into OPAL MkDocs pages.

Preferred source files are in ../../Sources/, with ../docs/ retained as a fallback mirror. Resolve active phase-generation uploads through ../source_document_manifest.yaml.

Agent Index

Agent File Populates Pages
Agent 1 — BMP Content Extractor agent-01-bmp-content-extractor.md BMP_PAGE_TEMPLATE 21 BMP pages (Ch9, Ch10, Ch11)
Agent 2 — Regulatory Mapping agent-02-regulatory-mapping.md REGULATORY_TOPIC_TEMPLATE 5 Regulatory Explorer pages
Agent 3 — Constraint Analysis agent-03-constraint-analysis.md ENGINEERING_CONSTRAINT_TEMPLATE 5 Engineering Constraint pages
Agent 4 — Workflow Stage agent-04-workflow-stage.md WORKFLOW_STAGE_TEMPLATE 5 Design Workflow pages

Run Order

Follow the build sequence in Agents/10_build_sequence.md:

Phase C — Run Agent 1 for 3 core BMPs (Bioretention, Infiltration Basin, Extended Detention)
Phase D — Run Agent 2 for 5 regulatory topics
Phase E — Run Agent 3 for 5 engineering constraints
Phase F — Run Agent 4 for 5 workflow stages
Phase G — Run Agent 1 for remaining 18 BMPs

Do not advance to the next phase until pages from the current phase pass all 4 QC layers defined in Agents/11_quality_control_protocol.md.

How to Use an Agent

  1. Open the agent prompt file
  2. Fill in all [PLACEHOLDERS]
  3. Attach the listed PDFs by resolving each filename through ../source_document_manifest.yaml and preferring ../../Sources/
  4. Run in your AI tool (Google Opal, Gemini AI Studio, or any model with document upload)
  5. Paste the output into the target .md file in docs/
  6. Run mkdocs build and check for errors
  7. Validate against QC checklist in Agents/11_quality_control_protocol.md

Page Template Reference

All templates are defined in Agents/03_component_templates.md.

Template Sections
BMP_PAGE_TEMPLATE Overview · Design Criteria · Siting Constraints · Maintenance · Common Failure Points · Regulatory References
REGULATORY_TOPIC_TEMPLATE Regulatory Summary · Engineering Interpretation · BMP Implications · Cross References
ENGINEERING_CONSTRAINT_TEMPLATE Concept Explanation · Engineering Evaluation · Affected BMPs · Related Regulations
WORKFLOW_STAGE_TEMPLATE Stage Purpose · Engineering Tasks · Relevant BMPs · Supporting Regulations

Phase C Target Files

These are the three core BMP pages to complete first (Agent 1):

BMP Target File PDFs to Attach
Small-Scale Bioretention docs/bmp-library/ch9-small-scale-gi/bioretention.md 2026_BMP_9_7_Small_Scale_Bioretention_Systems.pdf + 2023_BMP_9_7_Small_Scale_Bioretention_Systems.pdf
Small-Scale Infiltration Basin docs/bmp-library/ch9-small-scale-gi/infiltration-basin.md 2026_BMP_9_8_Small_Scale_Infiltration_Basins.pdf + 2023_BMP_9_8_Small_Scale_Infiltration_Basins.pdf
Extended Detention Basin docs/bmp-library/ch11-non-gi/extended-detention.md 2026_BMP_11_2_Extended_Detention_Basins.pdf + 2023_BMP_11_2_Extended_Detention_Basins.pdf