{
  "markdown": "# aeo-howto-generation-runtime\n\nGenerates a how-to article for one shop from a shared template and that shop's\nonboarding record — and measures how close it landed to every other shop's\narticle from the same template.\n\nDeployed as an **AWS Bedrock AgentCore Runtime** (ARM64, Python 3.12). Called by\n`aeo-backend`. Writes nothing.\n\n```\nPOST /invocations   template + org context  ->  draft article + similarity + audit\nGET  /ping          liveness\n```\n\n## Why this exists\n\nAuto shops compete on price because nothing distinguishes them in the answers\ncustomers actually see. How-to content published on the shop's own domain\nsignals expertise to answer engines — but only if each shop's article is\ngenuinely different from every other shop's. Fifty near-identical articles get\ndeduplicated down to one indexed page, and the other forty-nine shops pay for\nsomething nobody is ever shown.\n\nSo the articles are **generated per shop**, not templated with the names\nswapped, and the runtime records a lexical similarity score so a reviewer can\nsee when that is failing.\n\n## Quick start\n\n```bash\npython -m venv .venv\n.venv/Scripts/python -m pip install -r requirements.txt pytest httpx\nbash scripts/gate.sh\n```\n\nThe whole suite runs with **no AWS credentials, no network and no Bedrock SDK**.\nThat is a tested property, not a happy accident.\n\nTo serve it locally with canned articles:\n\n```bash\nHOWTO_GENERATION_USE_STUB_MODEL=true .venv/Scripts/python -m uvicorn app.howto_generation.server:app --port 8090\n```\n\n## Where things are\n\n| | |\n|---|---|\n| `app/howto_generation/slots.py` | Which shop facts may be used, and which are refused |\n| `app/howto_generation/similarity.py` | MinHash Jaccard over 5-word shingles |\n| `app/howto_generation/regenerate.py` | Preserving human edits, and refusing when it cannot |\n| `app/howto_generation/prompt.py` | The differentiation instruction |\n| `app/howto_generation/runtime.py` | The pipeline |\n| `okf/` | The knowledge bundle — **start at `okf/service.md`** |\n\n## Docs\n\n- What it does, as scenarios: `okf/capabilities/howto-article-generation.md`\n- How each one is proven: `okf/qa/howto-article-generation.md`\n- Running it here: `okf/playbooks/run-locally.md`\n",
  "bytes": 2198,
  "sha": "d0682be9b99f9273120e795d16b18229c4c6a79169f337a264fbd56fab78d842",
  "repo_slug": "conexustech/aeo-howto-generation-runtime",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_conexustech_aeo_howto_generation_runtime_c5de6026/readme"
}