Skip to content

docs(readme): prerequisites, cost, CI details, and surface sample excerpt#2

Open
jlynshue wants to merge 1 commit into
mainfrom
docs/readme-polish
Open

docs(readme): prerequisites, cost, CI details, and surface sample excerpt#2
jlynshue wants to merge 1 commit into
mainfrom
docs/readme-polish

Conversation

@jlynshue

Copy link
Copy Markdown
Owner

Factual / honesty-only README clarity fixes. No fabricated screenshots, demo output, metrics, or claims — every addition is verified against the repo source.

Changes

  1. Quick Start → Prerequisites — states an AWS account with Amazon Bedrock model access (Console → Bedrock → Model access) is required. Documents the exact default model and region verified from leverage_os/runner.py and .env.example: us.anthropic.claude-sonnet-4-6 in us-east-1, plus the override paths (BEDROCK_MODEL_ID/AWS_REGION, --model/--region). Notes --no-ai / manual provider needs no AWS account.

  2. Quick Start → Cost — a full audit makes 4 Bedrock calls (one per framework, verified: cli.py loops ALL_AUDITS = 4 entries, one invoke_model each), each capped at 4096 output tokens (from runner.py). Links to the official Bedrock pricing page instead of guessing a dollar figure.

  3. Development → CI line — states exactly what CI runs, verified from .github/workflows/ci.yml: ruff check . + the structural eval harness (python -m leverage_os.evals --provider manual) on Python 3.11/3.12, over the 3 fixture personas in tests/fixtures/ × 4 audits. The repo has no pytest suite, so the line deliberately does not claim a pytest count.

  4. Example Output — lifts a 3-line excerpt (Leverage Index + Biggest Leverage Leak) of the existing in-<details> sample above the fold. The text is copied verbatim from the existing sample — nothing invented.

Markdown verified to parse.

Not done (needs a human)

  • A real screenshot of the Rich terminal output — cannot be fabricated.

🤖 Generated with Claude Code

https://claude.ai/code/session_017zfynhEadteeMKwYFAq4V8

… excerpt

Factual README clarity fixes, all derivable from the repo:
- Quick Start: add Prerequisites (AWS account + Bedrock model access; default
  model us.anthropic.claude-sonnet-4-6 / us-east-1 from runner.py + .env.example)
- Quick Start: add cost note — a full audit makes 4 Bedrock calls (one per
  framework in ALL_AUDITS), each capped at 4096 output tokens; link to Bedrock
  pricing rather than guess a dollar figure
- Development: state exactly what CI runs (ruff + structural eval harness via
  manual provider, py3.11/3.12, 3 fixtures x 4 audits) per .github/workflows/ci.yml
- Example Output: lift a 3-line excerpt of the existing sample above the <details>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017zfynhEadteeMKwYFAq4V8
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant