Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,44 @@ For cluster topology, the 7 Laws, and ops procedures see **[CLUSTER.md](CLUSTER.

---

## Active Focus Window (Revenue Priority)

**Current objective:** V1 Solo Technician — Telegram bot answers from KB with citations.

**IN SCOPE — touch freely:**
- `services/troubleshoot/**` — Telegram polling bot + engine
- `services/diagnosis/**` — RAG retrieval + LLM diagnosis
- `services/brain/**` — Mem0 vector KB ingest/retrieval
- `services/llm-router/**` — LLM provider failover
- `kb/**` — Knowledge base ingestion + chunking
- `brain/**` — KB schemas (Herodotus, Hammurabi)
- `openclaw/**` — Message gateway
- `services/telegram/**` — Telegram adapter
- `diagnosis/**` — Fault rules + prompts
- `tests/` — Any tests for the above
- `docs/specs/factorylm-system-spec-v1.md` — Architecture spec
- `CLAUDE.md` — Governance only
- `CLUSTER.md` — Cluster ops only
- `scripts/deploy-charlie-brain.sh` — Deployment

**OUT OF SCOPE — do NOT modify without explicit human approval:**
- `my-ralph` submodule
- `.serena/**`
- `.infra/**`
- `demos/**`
- `apps/mission-control/**` (read-only for monitoring, no feature work)
- `apps/conveyor-lab/**`, `apps/cmms/**`, `apps/portal/**`, `apps/web/**`
- `antfarm/**` — workflow automation (post-V1)
- `cosmos/**`, `analytics/**`, `video/**`, `media/**`
- `scripts/run_dtu_remote.py`, `scripts/scenario_runner_upload.py`
- `tests/e2e/screenshots/**`

If a change seems helpful but is outside the IN SCOPE list, **STOP and ask Mike.**

**Focus rule:** Until the Telegram bot can answer from KB with citations AND be paid for by a stranger, nothing outside the money path gets touched.

---

## VPS Change Protocol

When making changes to OpenClaw on the VPS (100.68.120.99):
Expand Down
46 changes: 46 additions & 0 deletions docs/ops/traces/2026-03-08-revenue-focus-lockdown.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Ops Trace: Revenue Focus Lockdown

**Date:** 2026-03-08
**Author:** Claude (CTO agent)
**Type:** governance

## What Changed

1. **CLAUDE.md** — Added "Active Focus Window (Revenue Priority)" section
- Defines IN SCOPE paths (14 directories) for V1 bot work
- Defines OUT OF SCOPE paths (12+ directories) that require human approval
- Hard stop rule: if outside scope, ask Mike

2. **7 GitHub PRs tagged as post-V1**
- #132 (KB auto-ingest) — post-V1
- #131 (workflow graph) — post-V1
- #127 (MCP factory tools) — post-V1
- #125 (README video) — post-V1
- #124 (crash-safe recording) — post-V1
- #122 (Open Brain fallback) — post-V1.1
- #106 (Discord health check) — post-V1

3. **GitHub labels created**
- `revenue-v1` (green) — In the V1 money path
- `post-v1` (red) — Deferred until after revenue bot ships

4. **PR #135 merged** (by Mike) — Mission Control Phase 2-3 + Telegram bot on CHARLIE

## Why

The repo had 8 open PRs spanning every corner of a 43-directory monorepo. Every Claude session was touching everything. Only one PR (#135) was in the path to "Telegram bot that answers from KB with citations." This lockdown draws a hard boundary so every session and PR is either shipping the bot or explicitly deferred.

## Architecture Decision

**Focus rule:** Until the Telegram bot can (1) answer from KB with citations and (2) be paid for by a stranger — nothing outside the money path gets touched.

## Risks

- Low: Deferred PRs may drift further from main over time
- Mitigation: PRs stay open, not closed. Can be rebased when V1 ships.

## Rollback

- `git revert` the CLAUDE.md commit
- `gh label delete post-v1 && gh label delete revenue-v1`
- Remove this trace