docs: Level A README — hero line, Mermaid diagram, CI badge, cross-links

Reframes autopilot-core for portfolio visibility:
- Hero line describing the AI operator capability
- Mermaid flowchart showing end-to-end repair pipeline
- CI and License badges
- Cross-links to sibling repos and wiki

Satisfies ACOR-01

Author: OgeonX-Ai

README.md

@@ -1,53 +1,57 @@
-# Autopilot Core
+# autopilot-core
 
-Organization-level control plane and operator for CI Autopilot.
+[![CI](https://github.com/Coding-Autopilot-System/autopilot-core/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Coding-Autopilot-System/autopilot-core/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-## Architecture
+**Org-level AI autopilot operator** — scans GitHub issues labeled `autofix + queued`, invokes Codex to generate fixes, and opens pull requests automatically across the Coding-Autopilot-System organization.
 
-```
-[Workflow Failure]
-       |
-       v
-[autopilot-create-issue.yml]
-  - create/update issue (labels)
-       |
-       v
-[autopilot-operator.yml] (self-hosted)
-  - scans queued issues
-  - runs Codex
-  - opens PRs
-```
+Part of the [Coding-Autopilot-System](https://github.com/Coding-Autopilot-System) autonomous CI repair platform alongside [ci-autopilot](https://github.com/Coding-Autopilot-System/ci-autopilot) and [autopilot-demo](https://github.com/Coding-Autopilot-System/autopilot-demo).
 
 ## How it works
-- Failures trigger issue intake in the originating repo.
-- Issues labeled `autofix` + `queued` are eligible for automation.
-- The operator runs on a self-hosted runner and attempts safe fixes.
 
-## Quick start
-1) Set org variable `ORG` in GitHub Actions for this repo.
-2) Install `autopilot-create-issue.yml` into target repos.
-3) Ensure a self-hosted runner is online for this repo.
-4) Run `autopilot-operator.yml` manually to validate.
+```mermaid
+flowchart LR
+    A[CI Failure] --> B[autopilot-create-issue.yml]
+    B --> C[Issue: autofix + queued]
+    C --> D[autopilot-operator.yml]
+    D --> E[Codex Fix Generation]
+    E --> F[Pull Request Opened]
+    F --> G[Auto-merge / Review]
+```
 
-## Org installer
-`autopilot-org-installer.yml` scans the org hourly and opens PRs for repos that opt in via `.autopilot/opt-in`.
+1. A CI failure in any opted-in repo triggers `autopilot-create-issue.yml`, creating an issue labeled `autofix + queued`.
+2. `autopilot-operator.yml` runs on a schedule on the self-hosted Windows runner, scanning for labeled issues.
+3. For each eligible issue, the operator invokes Codex to generate a targeted fix.
+4. The fix is committed to a branch and a pull request is opened in the target repo.
+5. `autopilot-org-installer.yml` scans the org hourly and installs the intake workflow into repos that opt in via `.autopilot/opt-in`.
 
-## Dashboard
-- Live dashboard: https://coding-autopilot-system.github.io/autopilot-core/
-- Status snapshot: `docs/status.md`
+## Quick start
 
-## Current Autopilot Status
-<!-- AUTOPILOT-STATUS:START -->
-Last updated: 1970-01-01T00:00:00Z
-See `docs/status.md` for the full status table.
-<!-- AUTOPILOT-STATUS:END -->
+1. Set org variable `ORG` in GitHub Actions for this repo.
+2. Install `autopilot-create-issue.yml` into target repos (or use `autopilot-org-installer.yml`).
+3. Ensure a self-hosted Windows runner with Codex and `OPENAI_API_KEY` is online.
+4. Trigger `autopilot-operator.yml` manually to validate the setup.
 
 ## Safety guardrails
-- Acts only on `autofix + queued` issues.
-- Skips anything labeled `risky` or `needs-design`.
-- Minimal diffs, no secrets, no destructive ops.
+
+- Acts only on issues labeled `autofix + queued`.
+- Skips issues labeled `risky` or `needs-design`.
+- Minimal diffs only — no secrets, no destructive operations.
 - Best-effort verification before PR creation.
 
-## Demos
-- `docs/demos/demo-repo.md`
-- `templates/demo-repo/`
+## Workflows
+
+| Workflow | Trigger | Purpose |
+|----------|---------|---------|
+| `ci.yml` | push/PR to main | Portfolio CI — YAML validation (ubuntu-latest) |
+| `autopilot-operator.yml` | schedule + dispatch | Core operator — scan issues, run Codex, open PRs |
+| `autopilot-org-installer.yml` | hourly + dispatch | Install intake workflow into opted-in repos |
+| `autopilot-create-issue.yml` | workflow_run failure | Create intake issue when monitored workflow fails |
+| `autopilot-docs-daily.yml` | daily | Update dashboard status page |
+
+## Documentation
+
+- [Wiki](https://github.com/Coding-Autopilot-System/autopilot-core/wiki) — setup guide, architecture, configuration reference
+- [Dashboard](https://coding-autopilot-system.github.io/autopilot-core/) — live autopilot status
+- `docs/status.md` — status snapshot
+- `docs/runbooks/` — operational runbooks