docs(readme): refresh workflow provider guide

[ArchonVII]

Summary

• Rewrite README around the current reusable workflow provider model.
• Replace stale named-persona framing with GitHub-native workflow/review policy language.
• Add current workflow inventory: 18 reusable workflows plus 2 provider self-tests.
• Plan/status artifacts: not applicable; no repo-facing plan/status artifact was created for this lane.

Verification

• npm test
• git diff --check
• Workflow inventory check: reusable=18, self_tests=2
• Local README link-target check
• Targeted README scan for legacy explicit role markers

Verification Notes

npm test passed: 6 test files, 122 tests.

git diff --check exited 0. Git emitted only the expected Windows line-ending warning for README/changelog files.

Workflow inventory command confirmed 18 files with workflow_call: under .github/workflows and 2 direct provider self-test workflows.

Local README link-target check reported: All local README link targets exist.

Targeted README scan for Release-Admiral, Project-Lieutenant, LIEUTENANT, Release Commander, and Project Lieutenant returned no README matches.

Docs / Changelog

Updated README.md and added .changelog/unreleased/65-readme-refresh.md.

Linked Issue

Closes #65

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: caf3cfe2cc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Add the required repo update log entry

This change updates protected/config documentation such as README.md, AGENTS.md, .github/PULL_REQUEST_TEMPLATE.md, and .agent/startup-baseline.json, but the commit does not append the required entry to docs/repo-update-log.md. The repo's AGENTS.md policy requires that ledger for PRs changing code, config, behavior, protected docs, tracked workflows, or repository policy, so this lane is missing required closeout evidence and should add the operational log entry before review.

Useful? React with 👍 / 👎.