BitSafe's company-wide AI: built to run the company and advise the company.
A case study + the docs to learn from BitSafe's implementation of NanoClaw.
The docs (with worked examples) for how BitSafe — a crypto-finance startup building on the Canton Network — uses NanoClaw to run day-to-day operations and to advise on strategy.
This is case study content, not a framework manual. The upstream NanoClaw project at qwibitai/nanoclaw is the framework; this repo is BitSafe's implementation, customizations, and lessons.
| # | Layer | Title | Source | Status |
|---|---|---|---|---|
| 1 | Infra + Security | Building a Company-Wide AI Assistant | 01-company-wide-ai-assistant.md |
published |
| 2 | Foundation | NanoClaw Architecture | 02-architecture.md |
published |
| 3 | Operations | The Autonomous Engine — Loops, CI/CD, ARQ + Swarms, Observability | 03-autonomous-engine.md |
drafting |
| 4 | Substrate | The Substrate — Notion-as-OS, Data, Code, Knowledge, and Tools | 04-substrate.md |
drafting |
| 5 | App / Top | Working With NanoClaw — Personas, Alerts, Memory, Decision Support, and How Humans Teach the AI | 05-working-with-nanoclaw.md |
drafting |
| 6 | Lessons | Cost Discipline — Why the Bill Grew, What We Caught, How to Catch It Sooner | 06-cost-discipline.md |
published |
| 7 | Lessons | Monitors & Alerts — Catching What You Can't Prevent | 07-monitors-and-alerts.md |
drafting |
| 8 | Lessons | Capability Coverage & Harness Guards — Why the Model Shouldn't Have to Remember What It Can Do | 08-capability-coverage-and-harness-guards.md |
drafting |
| 9 | Lessons | Guard Parity — A Guard Only Protects Where It's Wired | 09-guard-parity.md |
drafting |
| 10 | Lessons | The Completeness Trap — You Can't Audit Your Own Blind Spots | 10-completeness-trap.md |
drafting |
| 11 | Lessons | Retros, Recursively — How the AI Studies Its Own Output | 11-retros-recursively.md |
drafting |
Articles are published as-ready to BitSafe's hub (hub.bitsafe.finance); drafts and source live here.
Forward-looking architecture proposals (separate from the retrospective case-study articles).
| Spec | Source |
|---|---|
| Code Factory MVP — 24x7 Autonomous SDLC Pipeline | code-factory-mvp-spec.md |
Issues + PRs welcome. The system itself reviews proposed changes — there's an adversarial reviewer bot that argues against any PR by default (it's a feature). Address it head-on in your PR description and you'll have an easier review.
How new articles land: push article commits straight to main. The README-freshness guard (pre-commit hook + check-readme-articles CI) is the only gate — it blocks any article that isn't listed in both README indexes, and otherwise content auto-merges with no human approval step. Run bash scripts/install-git-hooks.sh once after cloning to install the local guard.
See CONTRIBUTING.md for specifics.
- Prose (articles, docs): CC-BY-SA-4.0
- Code snippets and any tooling: Apache 2.0
- Upstream framework: qwibitai/nanoclaw
- BitSafe public hub: hub.bitsafe.finance
- BitSafe: bitsafe.finance