{
  "markdown": "# twiceshy\n\n> Once bitten, twice shy.\n\nA self-hosted service that feeds hard-won engineering experience — issues,\ndead-ends, root causes, validated fixes — to LLM coding agents at decision\ntime, so they stop repeating known mistakes on autopilot. Records are\ngit-backed and provenance-aware; automatic retrieval applies a relevance floor\nso a weak match can return nothing.\n\n## Hosted alpha\n\nThe hosted instance runs at [twiceshy.app](https://twiceshy.app) — self-serve\ntokens, remote MCP endpoint `https://api.twiceshy.app/`. External\ncontributions require a signed CLA before merge\n([ADR-0002](docs/adr/ADR-0002-licensing-strategy.md)).\n\n## How it works (the locked architecture)\n\n- **Source of truth:** git-backed markdown experience records (YAML frontmatter\n  + narrative) — format in [docs/SCHEMA.md](docs/SCHEMA.md). The corpus is a\n  separate versioned data product (`twiceshy-corpus`,\n  [ADR-0021](docs/adr/ADR-0021-decouple-corpus-as-a-data-product.md)); the engine\n  ships a small frozen fixture (`internal/testcorpus/`) for tests.\n- **Index:** one derived, always-rebuildable SQLite file (FTS5 plus cached,\n  pure-Go dense vectors for pull retrieval).\n- **Retrieval:** fingerprint-exact → BM25 → dense (RRF), stack-fingerprint\n  filtered, hard cap k≤3 with a relevance floor — below it, *nothing* is\n  injected.\n- **Channels:** push (Claude Code hooks → trap cards), pull (MCP tools over\n  streamable HTTP), index (generated one-liners).\n- **Trust:** agent-proposed records are quarantined; promotion = sandbox\n  fail-to-pass validation + human PR review. A new record IS a pull request.\n- **Doctors:** background jobs that dedup, staleness-check, *re-execute\n  repros* (CI for memories), decay, and abstract.\n\nFull rationale: [docs/research/EXPERIENCE_SERVICE_RESEARCH.md](docs/research/EXPERIENCE_SERVICE_RESEARCH.md)\nand [docs/adr/ADR-0001-architecture.md](docs/adr/ADR-0001-architecture.md).\n\n## Status\n\nThe core service is available as a hosted alpha. For the canonical snapshot of\nwhat ships now and the current roadmap, see\n[docs/NEXT_FEATURES.md](docs/NEXT_FEATURES.md); deployment and operating details\nlive in [docs/DEPLOY-public-alpha.md](docs/DEPLOY-public-alpha.md).\n\n## Development\n\n```sh\nmake ci    # lint + race tests + coverage floor — what CI runs\n```\n\nSee [docs/CONVENTIONS.md](docs/CONVENTIONS.md) and\n[docs/CONTEXT.md](docs/CONTEXT.md) first.\n\n## License\n\n[AGPL-3.0-only](LICENSE). Contribution and corpus licensing:\n[docs/adr/ADR-0002-licensing-strategy.md](docs/adr/ADR-0002-licensing-strategy.md).\n",
  "bytes": 2534,
  "sha": "da9eb8066c1519f8df31c04a7451cf953e3adc6d6efae964024a3889f24c952f",
  "repo_slug": "dotts-h/twiceshy",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_twiceshy_twiceshy_8d4d2ff9/readme"
}