OB Engine Community

OB Engine Community is the public base of OBE — Optimization-Based Engine — an open-source WordPress optimization and automation engine for safe content operations, SEO workflows, translation cleanup, metadata mapping, and maintainer-friendly website automation.

The project is built for WordPress maintainers and developers who need to reduce repetitive operational work while keeping safety controls such as dry-runs, audit logs, review gates, role checks, and secret masking.

Why OB Engine exists

WordPress maintenance often involves repetitive but risky tasks:

• auditing content and metadata
• preparing SEO-ready drafts
• mapping custom fields
• validating structured data
• managing translation strings
• preventing accidental publishing
• keeping staging and production workflows reviewable

OB Engine aims to make these workflows more structured, predictable, and safe.

Current focus

This repository is currently defining the public product blueprint before PHP implementation work begins. The community version focuses on:

• safety-first workflow contracts
• dry-run-first write operations
• draft or needs_review content defaults
• explicit approval for publishing and destructive actions
• BYOK provider settings with masked API keys
• addon-friendly contracts
• logs, snapshots, and rollback expectations
• a strict public/private boundary

Safety principles

OB Engine is designed around safety gates:

• all writes must support dry-run first
• content writes default to draft or needs_review
• no hidden auto-publish
• destructive actions require explicit user approval
• capability checks and nonce validation
• masked BYOK secrets
• audit logs, snapshots, and rollback contracts
• predictable workflow execution
• staging-first mindset

Status

This repository is the community/open-source version of OB Engine. The project is early, active, and under ongoing development.

Project status

• Current plugin version: 0.11.0
• Current stage: Manual Generate to Library complete
• Next runtime target: v0.12.0 Dry-run / Write Draft Safety Runtime
• Command center: PROJECT.md
• Detailed status: Project Status

Product blueprint

• Product brief

• Architecture

• Master Architecture OBE v1.0

• AI Engine Architecture

• Responses API Strategy

• AI / Responses API Contract

• AI Request / Response Contract

• Provider Interface Contract

• AI Task Types and Model Profiles

• Structured Output Schemas

• AI Usage, Error, and Redaction Contract

• Information Architecture

• Admin UI Blueprint — WordPress-native OBE admin cockpit, menu structure, pages, and safety-first UI flows.

• Design tokens — machine-readable OBE admin UI tokens for coding agents and future implementation.

• UI Design System — page widths, spacing, typography, colors, cards, forms, badges, tables, and confirmations.

• Addons Integration Blueprint — addon placement inside OBE and module detail page contracts.

• Auto Post Workflow Blueprint — source-to-draft import pipeline and review-first workflow.

• Build Sequence

• Safety contract

• Addon contract

• Workflow contract

• Public/private boundary

• Roadmap

• Release plan

• Decisions

Contributing

Contributions, bug reports, and ideas are welcome. See CONTRIBUTING.md.

Security

If you find a security issue, please do not open a public issue. See SECURITY.md.

License

This project is licensed under GPL-2.0-or-later.