app.twiceshy/twiceshy
Experience memory for coding agents: validated traps, fixes and dead-ends at decision time.
Open source Repository Open in the app JSON README (API)
About
Experience memory for coding agents: validated traps, fixes and dead-ends at decision time.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- app.twiceshy
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.0
- Last push
- 2026-07-10T23:40:10Z
- Repository state
- ativo
- Language
- Go
- License
- AGPL-3.0
- Added
- 2026-08-29 03:00:47
- Updated
- 2026-08-29 03:00:47
- Origin id
app.twiceshy/twiceshy
README
# twiceshy > Once bitten, twice shy. A self-hosted service that feeds hard-won engineering experience — issues, dead-ends, root causes, validated fixes — to LLM coding agents at decision time, so they stop repeating known mistakes on autopilot. Records are git-backed and provenance-aware; automatic retrieval applies a relevance floor so a weak match can return nothing. ## Hosted alpha The hosted instance runs at [twiceshy.app](https://twiceshy.app) — self-serve tokens, remote MCP endpoint `https://api.twiceshy.app/`. External contributions require a signed CLA before merge ([ADR-0002](docs/adr/ADR-0002-licensing-strategy.md)). ## How it works (the locked architecture) - **Source of truth:** git-backed markdown experience records (YAML frontmatter + narrative) — format in [docs/SCHEMA.md](docs/SCHEMA.md). The corpus is a separate versioned data product (`twiceshy-corpus`, [ADR-0021](docs/adr/ADR-0021-decouple-corpus-as-a-data-product.md)); the engine ships a small frozen fixture (`internal/testcorpus/`) for tests. - **Index:** one derived, always-rebuildable SQLite file (FTS5 plus cached, pure-Go dense vectors for pull retrieval). - **Retrieval:** fingerprint-exact → BM25 → dense (RRF), stack-fingerprint filtered, hard cap k≤3 with a relevance floor — below it, *nothing* is injected. - **Channels:** push (Claude Code hooks → trap cards), pull (MCP tools over streamable HTTP), index (generated one-liners). - **Trust:** agent-proposed records are quarantined; promotion = sandbox fail-to-pass validation + human PR review. A new record IS a pull request. - **Doctors:** background jobs that dedup, staleness-check, *re-execute repros* (CI for memories), decay, and abstract. Full rationale: [docs/research/EXPERIENCE_SERVICE_RESEARCH.md](docs/research/EXPERIENCE_SERVICE_RESEARCH.md) and [docs/adr/ADR-0001-architecture.md](docs/adr/ADR-0001-architecture.md). ## Status The core service is available as a hosted alpha. For the canonical snapshot of what ships now and the current roadmap, see [docs/NEXT_FEATURES.md](docs/NEXT_FEATURES.md); deployment and operating details live in [docs/DEPLOY-public-alpha.md](docs/DEPLOY-public-alpha.md). ## Development ```sh make ci # lint + race tests + coverage floor — what CI runs ``` See [docs/CONVENTIONS.md](docs/CONVENTIONS.md) and [docs/CONTEXT.md](docs/CONTEXT.md) first. ## License [AGPL-3.0-only](LICENSE). Contribution and corpus licensing: [docs/adr/ADR-0002-licensing-strategy.md](docs/adr/ADR-0002-licensing-strategy.md).