diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..98dd98d --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,31 @@ +# AGENTS.md — Client Engine + +> Hive context pack (Dexter + Evens Louis hive). Full canon: n8n-cursor `docs/hive/`. + +## What this is + +**Private business OS: leads → builds → proofs → AI with operator approval.** + +- Lane: `hive_core` · Maturity: `wip` +- Apex path: `/pro` +- Canonical home: https://evenslouis.ca/pro +- **Not** the product of: ProofCheck QC, Scorpion, or AutoFlow Finance +- Do not confuse with: proof-qc-assist, scorpion, autoflow-finance + +## Read first + +1. `PROJECT_CONTEXT.md` +2. `docs/hive/SOLO_MODE.md` and `docs/hive/HIVE_MODE.md` +3. Hub (when available): `docs/hive/README.md` in snevemoney/n8n-cursor + +## Rules + +- Keep this repo **solo-usable**. +- Respect hive anti-overlap (one money OS = Client Engine; one agent face = OpenClaw; one cockpit = Scorpion). +- HITL for spend, client send, prod deploy, delete data, secrets, `openclaw.json`. +- Medium+ features: Product → Architecture → Program design → Vertical slices (see `docs/program-design/README.md`). +- Prefer execute+verify; docs ≠ done. + +## Sacred (if applicable) + +If this repo touches OpenClaw: never wipe SOUL/AGENTS/IDENTITY/USER/TOOLS/HEARTBEAT/MEMORY/topics. diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md index c14fa8d..2ec213b 100644 --- a/PROJECT_CONTEXT.md +++ b/PROJECT_CONTEXT.md @@ -227,3 +227,9 @@ Before deploy to production, ensure: --- **Cursor:** Read this file first in new chats. Treat it as the single source of truth for what ships now, what’s next, and what’s out of scope. + +--- + +## Hive pack (added) + +Also see `docs/hive/SOLO_MODE.md` and `docs/hive/HIVE_MODE.md`. Hub canon: snevemoney/n8n-cursor `docs/hive/`. diff --git a/docs/adr/README.md b/docs/adr/README.md new file mode 100644 index 0000000..df3b09f --- /dev/null +++ b/docs/adr/README.md @@ -0,0 +1,3 @@ +# ADRs + +Record architecture decisions here. Hub template: n8n-cursor `templates/adr-template.md`. diff --git a/docs/external/README.md b/docs/external/README.md new file mode 100644 index 0000000..c11dea5 --- /dev/null +++ b/docs/external/README.md @@ -0,0 +1,3 @@ +# External context + +Document env **names**, domains, and contacts — never secret values. diff --git a/docs/hive/HIVE_MODE.md b/docs/hive/HIVE_MODE.md new file mode 100644 index 0000000..8ca8c8f --- /dev/null +++ b/docs/hive/HIVE_MODE.md @@ -0,0 +1,22 @@ +# Hive mode — Client Engine + +## Role in hive + +**One money OS.** OpenClaw/n8n may draft and register; they must not auto-send or auto-build. + +## Talks to + +| System | Relationship | +|--------|----------------| +| OpenClaw / philanthropy | Intent + tools; HITL queue for money actions | +| n8n | Optional glue / research feeds — not the money controller | +| Scorpion | Ops/knowledge sibling (Layer 4 ecosystem) — do not derail money path | +| Builder service | Separate Docker API CE calls | + +## Register + +Money-touching outcomes register here. Ops health goes to Scorpion. + +## Unfinished (chats) + +`/pro` smoke to near_ship; 9-skills prod wiring; YouTube reliability; voice keys; cadence worker; true Start Engine / Review Results loop. diff --git a/docs/hive/SOLO_MODE.md b/docs/hive/SOLO_MODE.md new file mode 100644 index 0000000..06b411d --- /dev/null +++ b/docs/hive/SOLO_MODE.md @@ -0,0 +1,24 @@ +# Solo mode — Client Engine + +Private **Money Path Machine** for Evens (operator-only unless later white-labeled). + +## Purpose (from chats) + +Quiet client OS: inbound lead → paid project. Proof > hype. No cold DMs. Runs while Evens is at a 9–5; returns a short review queue — not a dashboard to babysit. + +## Money path (non-negotiable) + +`CAPTURE → ENRICH → SCORE → POSITION → PROPOSE → (OWNER APPROVAL) → BUILD` + +- No auto-send, no auto-build +- No silent PATCH of status / approvedAt / proposalSentAt / dealOutcome + +## Solo capabilities + +Brain / Command Center / site builder API / YouTube learning (human-approved) / voice follow-up / proof / portal / cadences. + +## How to work + +1. Prefer execute+verify on prod when that's where CE lives. +2. Site builder must respect 9 phases/skills + brand colors — no generic green. +3. Learning proposals are proposal-driven (human promotes). diff --git a/docs/program-design/README.md b/docs/program-design/README.md new file mode 100644 index 0000000..48abe82 --- /dev/null +++ b/docs/program-design/README.md @@ -0,0 +1,7 @@ +# Program design (thin copy) + +For medium+ work: Product → Architecture → Program design → Vertical slices. + +Full guide + templates live in hub repo `snevemoney/n8n-cursor`: +- `docs/program-design/` +- `templates/program-design/`