Start in Claude Code

Follow these steps to set up the Agent Readiness Operator in Claude Code:

1. Open this folder (agent-readiness-operator/) as the working directory in Claude Code.

2. Send a URL or paste the raw source of a page.

The operator runs the full audit and drafts all fix artifacts. On your confirmation, it can apply fixes in-place to existing files.

Validate structured data artifacts

Before applying any JSON-LD fix, confirm it parses cleanly against the schema.org vocabulary:

1. Open the drafted artifact from proposed-fixes/ (e.g. jsonld-localbusiness.json).
2. Paste the JSON-LD block into the Schema Markup Validator.
3. Confirm zero errors — warnings about recommended (non-required) properties are acceptable.

If the validator returns errors, ask the operator to correct the artifact before applying. The operator will re-draft and re-confirm.

Drafting vs applying

• Drafting to proposed-fixes/ is ungated — no confirmation required.
• In-place apply is the only confirmation gate. The operator will ask before overwriting any existing file.

Reversibility without git

Reversibility comes from two things:

1. Backups — Every file the operator would overwrite is copied to proposed-fixes/backup/ before the write.

2. Deploy manifest — Every applied change is recorded in proposed-fixes/MANIFEST.md with the original path and exact change made.

To revert any applied fix, copy the backup back over the live file. No git required, no git assumed.