Onboarding manual: Layer 1a/1b, ledger, Now vs Later, competitor risk note

This commit is contained in:
Ty
2026-08-03 05:14:59 +00:00
parent c43689df7d
commit ee34720331
@@ -1,10 +1,12 @@
# Employee Onboarding Manual — Digital Operations Partner (v1) # Employee Onboarding Manual — Digital Operations Partner (v1.1)
**Audience:** Any employee, contractor, or operator joining the company **Audience:** Any employee, contractor, or operator joining the company
**Purpose:** Give you everything you need to work inside DOP without guessing **Purpose:** Give you everything you need to work inside DOP without guessing
**Source of truth:** The Gitea repository `Tony_tech/digital-operations-partner` **Source of truth:** The Gitea repository `Tony_tech/digital-operations-partner`
**Status:** Active operating guide (reflects system as of 2026-08-02) **Status:** Active operating guide (reflects system as of 2026-08-02)
**Read README “Now vs Later” first.** Strategy docs (`strategic-frame.md`, `whitepaper.md`) are horizon, not day-to-day SOP.
--- ---
## 1. What this company does ## 1. What this company does
@@ -64,6 +66,8 @@ Memorize these. They govern every task.
7. **Gitea is the system of record.** 7. **Gitea is the system of record.**
Client work, templates, playbooks, and decisions live in the repo under the documented paths. Do not keep the “real” version only in chat or email. Client work, templates, playbooks, and decisions live in the repo under the documented paths. Do not keep the “real” version only in chat or email.
8. **Competitor claims about other businesses** are Tier 2 by default, never the primary threat claim, and require snapshot date + source. Wrong third-party claims are a higher risk class — prefer omit.
--- ---
## 3. Where everything lives ## 3. Where everything lives
@@ -80,7 +84,9 @@ Memorize these. They govern every task.
| Templates | `docs/templates/` | | Templates | `docs/templates/` |
| Client instances | `docs/clients/<client-name>/` | | Client instances | `docs/clients/<client-name>/` |
| GBP Snapshot HTML form | `tools/gbp-snapshot-form.html` | | GBP Snapshot HTML form | `tools/gbp-snapshot-form.html` |
| Task reliability ledger | `docs/operations/task-reliability-ledger.md` |
| This manual | `docs/operations/employee-onboarding-manual-v1.md` | | This manual | `docs/operations/employee-onboarding-manual-v1.md` |
| Strategy (LATER, not SOP) | `docs/strategic-frame.md`, `docs/whitepaper.md` |
**Client artifact naming (standard):** **Client artifact naming (standard):**
- `data-inventory-v1.md` - `data-inventory-v1.md`
@@ -99,7 +105,8 @@ Every real client engagement follows these layers **in order**. Do not skip.
| Layer | Name | What you produce | Human gate | | Layer | Name | What you produce | Human gate |
|-------|------|------------------|------------| |-------|------|------------------|------------|
| 1 | Account Intelligence | Data Inventory | Inventory accurate before Layer 2 | | **1a** | Public Account Intelligence | Data Inventory (public / Tier 2 ceiling) | Inventory matches what was publicly observable |
| **1b** | Owner-access Intelligence | Upgraded inventory (Tier 1 eligible) | Owner-gated fields confirmed |
| 2 | Threat Diagnosis | Threat Register | Each threat verified/downgraded/rejected | | 2 | Threat Diagnosis | Threat Register | Each threat verified/downgraded/rejected |
| 3 | Economics & Pricing | Economics doc + pricing bands | Owner conversation required | | 3 | Economics & Pricing | Economics doc + pricing bands | Owner conversation required |
| 4 | Requirements | Outcome-based requirements | Scoped to pricing band | | 4 | Requirements | Outcome-based requirements | Scoped to pricing band |
@@ -107,7 +114,9 @@ Every real client engagement follows these layers **in order**. Do not skip.
| 6 | Agent Build & Test | Working agents on real data | Human reviews full run | | 6 | Agent Build & Test | Working agents on real data | Human reviews full run |
| 7 | POC Delivery | Demo + gap doc + retainer framing | Owner has seen live draft alert | | 7 | POC Delivery | Demo + gap doc + retainer framing | Owner has seen live draft alert |
**Layer 3 cannot be skipped.** Without owner economics, downstream pricing and scope are speculative and must be labeled as such. **Cold audits complete at Layer 1a** (or Draft Benchmark). Do not claim full Layer 1 engagement-ready without 1b or explicit Tier 2 ceiling acceptance.
**Layer 3 cannot be skipped** for paid path. Without owner economics, downstream pricing and scope are speculative and must be labeled as such.
Full detail: `docs/architecture/path-to-poc-sequencing.md` Full detail: `docs/architecture/path-to-poc-sequencing.md`
@@ -115,7 +124,7 @@ Full detail: `docs/architecture/path-to-poc-sequencing.md`
## 5. Day-one cold audit workflow (what you actually do) ## 5. Day-one cold audit workflow (what you actually do)
This is the current production procedure for a **new prospect / first assessment**. This is the current production procedure for a **new prospect / first assessment****Layer 1a path**.
### Step A — Open a client folder ### Step A — Open a client folder
1. Create `docs/clients/<client-slug>/` if it does not exist. 1. Create `docs/clients/<client-slug>/` if it does not exist.
@@ -148,9 +157,9 @@ Leonard must:
- Fire **only** threat rules R1R3 if conditions match - Fire **only** threat rules R1R3 if conditions match
- Not invent fields or write solutions - Not invent fields or write solutions
You (human) then review and approve or correct. You (human) then review and approve or correct. Record scored runs in `docs/operations/task-reliability-ledger.md`.
### Step D — Data Inventory (Layer 1) ### Step D — Data Inventory (Layer 1a)
Use `docs/templates/data-inventory-template.md` and the Audit Playbook. Use `docs/templates/data-inventory-template.md` and the Audit Playbook.
Required minimum sources: Required minimum sources:
@@ -160,10 +169,10 @@ Required minimum sources:
- Booking/scheduling (or “not visible”) - Booking/scheduling (or “not visible”)
- Review surfaces if observable - Review surfaces if observable
Exit only when a human has signed the review gate. Exit only when a human has signed the review gate**Locked (1a)** or **Draft Benchmark** with blockers.
### Step E — Threat Register (Layer 2) ### Step E — Threat Register (Layer 2)
Only after Layer 1 is human-confirmed (or explicitly accepted as Draft Benchmark with documented blockers). Only after Layer 1a is human-confirmed (or explicitly accepted as Draft Benchmark with documented blockers).
Rules from the Audit Playbook: Rules from the Audit Playbook:
- One primary fact per threat - One primary fact per threat
@@ -171,6 +180,7 @@ Rules from the Audit Playbook:
- Data Recency must reference inventory snapshot dates - Data Recency must reference inventory snapshot dates
- No solution language (“fix the 404s” is forbidden here) - No solution language (“fix the 404s” is forbidden here)
- Severity: Critical / Major / Minor — when unsure, choose lower - Severity: Critical / Major / Minor — when unsure, choose lower
- Competitor facts: secondary only, Tier 2, snapshot + source
### Step F — Stop at the gate ### Step F — Stop at the gate
Do **not** invent economics. Do **not** write requirements or workflows until Layers 2 and 3 allow it. Do **not** invent economics. Do **not** write requirements or workflows until Layers 2 and 3 allow it.
@@ -196,7 +206,7 @@ If GBP is still incomplete, either:
- GBP ingest without the execution card is out of process. - GBP ingest without the execution card is out of process.
### Scoring Leonard (training) ### Scoring Leonard (training)
Use the rubric in `docs/agents/audit-playbook-v1.md` (02 on evidence, tier discipline, scope, recency, template fidelity). Pass ≥ 7/10 with no zeros. Use the rubric in `docs/agents/audit-playbook-v1.md` (02 on evidence, tier discipline, scope, recency, template fidelity). Pass ≥ 7/10 with no zeros. **Log every scored run in the task reliability ledger.**
--- ---
@@ -206,7 +216,7 @@ High-level path (see full doc for detail):
1. Prospect 1. Prospect
2. Qualification 2. Qualification
3. Initial Assessment (Layers 12 style work) 3. Initial Assessment (Layers 1a2 style work)
4. Evidence classification 4. Evidence classification
5. Proof-of-Concept fix (low-risk, scoped, human-approved before publish) 5. Proof-of-Concept fix (low-risk, scoped, human-approved before publish)
6. Before/After report 6. Before/After report
@@ -250,14 +260,14 @@ Anything that changes a **client-facing surface** requires human approval first,
- Website or directory updates - Website or directory updates
- Business/service descriptions - Business/service descriptions
Until a specific task type has a documented reliability run of **≥ 100 error-free executions**, the human gate stays on for that task type. Until a specific task type has a documented reliability run of **≥ 100 error-free executions** in `docs/operations/task-reliability-ledger.md`, the human gate stays on for that task type. Empty ledger = never auto-publish.
--- ---
## 10. Communication standards ## 10. Communication standards
### Internal docs ### Internal docs
- Status header: Draft / Human Review / Locked - Status header: Draft / Human Review / Locked (and 1a vs 1b where relevant)
- Last Updated date - Last Updated date
- Evidence tier on factual claims - Evidence tier on factual claims
- Blockers listed explicitly - Blockers listed explicitly
@@ -267,6 +277,7 @@ Until a specific task type has a documented reliability run of **≥ 100 error-f
- No scare tactics from Tier 2 alone - No scare tactics from Tier 2 alone
- No guaranteed rankings, AI citations, or “well get you #1 - No guaranteed rankings, AI citations, or “well get you #1
- Reports answer: what we watched, what changed, what we found, what we fixed/recommended, what remains at risk, what happens next - Reports answer: what we watched, what changed, what we found, what we fixed/recommended, what remains at risk, what happens next
- Competitor comparisons: provisional, relative, never prosecution from thin Tier 2 alone
--- ---
@@ -274,13 +285,13 @@ Until a specific task type has a documented reliability run of **≥ 100 error-f
**Day 1 — Orientation** **Day 1 — Orientation**
- [ ] Read this manual end to end - [ ] Read this manual end to end
- [ ] Read `README.md`, Agent Charter, Audit Playbook - [ ] Read `README.md` (including Now vs Later), Agent Charter, Audit Playbook
- [ ] Skim Path to PoC sequencing and Client Lifecycle - [ ] Skim Path to PoC sequencing and Client Lifecycle
- [ ] Open `tools/gbp-snapshot-form.html` and click through once (empty is fine) - [ ] Open `tools/gbp-snapshot-form.html` and click through once (empty is fine)
**Day 2 — Shadow the system** **Day 2 — Shadow the system**
- [ ] Read Overcome Fitness client folder end to end (`docs/clients/overcome-fitness/`) - [ ] Read Overcome Fitness client folder end to end (`docs/clients/overcome-fitness/`)
- [ ] Note what is Draft vs what is still blocked - [ ] Note what is Draft vs what is still blocked; identify 1a vs full Layer 1
- [ ] Identify the open GBP gate and why Layer 3 is blocked - [ ] Identify the open GBP gate and why Layer 3 is blocked
**Day 3 — Practice cold audit mechanics** **Day 3 — Practice cold audit mechanics**
@@ -290,10 +301,10 @@ Until a specific task type has a documented reliability run of **≥ 100 error-f
**Day 4 — Threat discipline** **Day 4 — Threat discipline**
- [ ] Write 23 practice threats that each contain exactly one primary fact + evidence snippet + recency + tier - [ ] Write 23 practice threats that each contain exactly one primary fact + evidence snippet + recency + tier
- [ ] Have a lead score them against the playbook rubric - [ ] Have a lead score them against the playbook rubric and log the score in the ledger
**Day 5 — Gate fluency** **Day 5 — Gate fluency**
- [ ] Explain aloud when Layer 1 can lock, when Layer 2 can lock, and why Layer 3 needs an owner - [ ] Explain aloud when Layer **1a** can lock, when **1b** is needed, when Layer 2 can lock, and why Layer 3 needs an owner
- [ ] List V1 exclusions from memory - [ ] List V1 exclusions from memory
--- ---
@@ -302,11 +313,12 @@ Until a specific task type has a documented reliability run of **≥ 100 error-f
**Real and usable now** **Real and usable now**
- Mission, evidence model, operating rule - Mission, evidence model, operating rule
- Full Path to PoC sequence - Full Path to PoC sequence with Layer **1a / 1b**
- Templates for Layers 1245 - Templates for Layers 1245
- Audit Playbook + Leonard GBP execution card - Audit Playbook + Leonard GBP execution card + competitor evidence rules
- GBP HTML form - GBP HTML form
- First benchmark client instance (Overcome Fitness) in Draft - Task reliability ledger (counters start at zero)
- First benchmark client instance (Overcome Fitness) in Draft on **1a path**
**Not built yet / do not pretend exists** **Not built yet / do not pretend exists**
- Locked production client package with full economics - Locked production client package with full economics
@@ -314,8 +326,9 @@ Until a specific task type has a documented reliability run of **≥ 100 error-f
- Fully automated Leonard → Gitea commit loop without human facilitation - Fully automated Leonard → Gitea commit loop without human facilitation
- Standard client-facing report template (still to productize) - Standard client-facing report template (still to productize)
- Implementation code under `implementation/` (scaffold only) - Implementation code under `implementation/` (scaffold only)
- Public Assessment AI / fixed-fee product stack (strategy horizon only)
When in doubt: if it is not in the repo as a Locked or Active doc, it is not process. When in doubt: if it is not in the repo as a Locked or Active **operating** doc, it is not process.
--- ---
@@ -339,6 +352,8 @@ Default action when stuck: **document the blocker, do not invent past it.**
| **GBP** | Google Business Profile (Maps / local panel listing) | | **GBP** | Google Business Profile (Maps / local panel listing) |
| **DOP** | Digital Operations Partner | | **DOP** | Digital Operations Partner |
| **Tier 1 / Tier 2** | Verified vs Indicative evidence | | **Tier 1 / Tier 2** | Verified vs Indicative evidence |
| **Layer 1a** | Public baseline inventory (cold audit) |
| **Layer 1b** | Owner-access inventory (engagement) |
| **Locked** | Human-approved; safe to build the next layer on | | **Locked** | Human-approved; safe to build the next layer on |
| **Draft Benchmark** | Training/reference package; not client-locked | | **Draft Benchmark** | Training/reference package; not client-locked |
| **WTP** | Willingness to pay | | **WTP** | Willingness to pay |
@@ -347,6 +362,6 @@ Default action when stuck: **document the blocker, do not invent past it.**
--- ---
**Version:** v1 **Version:** v1.1
**Maintainer:** Lead / Director **Maintainer:** Lead / Director
**Update rule:** When Path to PoC, Playbook, or cold-audit tooling changes, this manual must be updated in the same change set or immediately after. **Update rule:** When Path to PoC, Playbook, or cold-audit tooling changes, this manual must be updated in the same change set or immediately after.