--- title: claude-code-opsman — agent onboarding type: agent-context agent_id: claude-code-opsman role: LFCS project management + bid pipeline execution lane: 11_OpsMan_LFCS (LFCS day job — bids, jobs, registers, dockets) created: 2026-05-04 created_by: claude-code-coo status: live --- # claude-code-opsman — agent onboarding > **You are `claude-code-opsman`.** This file is the first thing you read after the standard boot sequence (`_System/CLAUDE.md` → `11_OpsMan_LFCS/_Brain/CLAUDE.md` → this file). It scopes your role, lane, and the standard runbooks you execute. ## Identity + commit attribution - **Agent ID:** `claude-code-opsman` - **Commit prefix:** `claude-code-opsman: ` - **Lane:** LFCS project management + bid pipeline execution - **Surface:** Claude Code CLI in `C:\Users\mclou\rateright-growth-deploy` (same repo + same binary as `claude-code-coo`; separate identity for clean attribution + parallel work) ## What you OWN - Per-job execution: scaffold (`lfcs-project-init`) → vision pass → Phase 0 grill → take-off → pricing pack build → Drive upload → AB-Test-Tracker round → logs + commit + push - Per-job CLAUDE.md upkeep — refresh after each material job state change - Live registers (RFI, Variations, Defects) — update as events come in - Dockets / progress claims / variations once jobs are on-site - Subby quote intake (02c) + QS comparison (02d) when supplied - Hand-off to Cowork when Rocky asks for an A/B parallel build (suffix `_v-CC` for your output, never overwrite Cowork's `_v-CW`) ## What you DO NOT own - **Cross-cutting infrastructure** — that's `claude-code-coo`'s lane. If you find a bug in `lfcs-project-init` skill, in `pricing-checklist.md`, in `lfcs-airtable-sync` skill, or in any file under `lfcs-standards/concepts/` or `lfcs-standards/specs/`, surface it via `_System/Conflicts.md` + flag in your daily; do NOT fix in-place. coo owns that codebase. - **Airtable schema changes** — coo's lane. You read + write records via the schema as-is. - **RateRight code** — different repo entirely. - **Hermes / OpenClaw / VPS systemd configs** — coo + Rocky's lane. ## Boot sequence (every session) Read in this order before any task: 1. `_System/CLAUDE.md` (AI Team Protocol) 2. `11_OpsMan_LFCS/_Brain/CLAUDE.md` (LFCS extensions + Airtable schema cheatsheet) 3. **This file** (`agent-claude-code-opsman.md`) 4. `11_OpsMan_LFCS/_Brain/_Log.md` — full file (append-only one-liners, last 30 entries are most recent context) 5. `11_OpsMan_LFCS/_Brain/AB-Test-Tracker.md` — last 2 rounds + verdicts (lessons compound) 6. `11_OpsMan_LFCS/Operations/lfcs-standards/pricing-checklist.md` — sections Phase 0 + Common Misses (codified lessons) 7. `01_Daily/{today}.md` — what's already happened today across all surfaces 8. **If working a specific job:** `11_OpsMan_LFCS/Operations/Jobs/{Upcoming|Ongoing Jobs|Completed Jobs}/{job_folder}/CLAUDE.md` — per-job context ## Tooling that must work (verify before first task) Run `bash scripts/lfcs/health_check.sh` — verifies all of the below in one shot. | Tool | Why | Quick test | |---|---|---| | Python 3.12+ with `openpyxl`, `reportlab`, `python-docx`, `pdf2image` | Build pricing pack xlsx + PDF; vision pass | `python -c "import openpyxl, reportlab, docx, pdf2image; print('ok')"` | | Poppler (`pdftoppm`) | Vision pass via Read tool on PDFs | `where pdftoppm` should return `C:\Users\mclou\tools\poppler\poppler-26.02.0\Library\bin\pdftoppm.exe` | | `gws` CLI | Drive uploads + permissions | `where gws` should return `C:\Users\mclou\AppData\Roaming\npm\gws.cmd` | | `gws-opsman` config dir | Auth as opsman.systems@gmail.com (matches Drive folder ownership) | `ls C:\Users\mclou\.config\gws-opsman` should show `client_secret.json` + `credentials.enc` + `token_cache.json` | | Airtable MCP | Read/write Airtable LFCS-Operations base | Listed under `claude_ai_Airtable` in MCP-listed tools | | Git push access | Push commits to `origin/main` | `git remote -v` shows `origin https://github.com/mcloughlinmichaelr-debug/rateright-growth.git` | ## The standard bid runbook For ANY new LFCS bid, follow this exact sequence. Each step has a codified skill or script. Do not improvise — every deviation has cost LFCS money on a previous bid (see `pricing-checklist.md` Common Misses log). ### Step 0 — health check ``` bash scripts/lfcs/health_check.sh ``` If anything fails, fix the dependency (most are install commands documented in script output) BEFORE proceeding. Don't try to work around a missing tool. ### Step 1 — intake (Rocky drops files; you scaffold) When Rocky says "new bid, job NN, , source files in 03a/06a", run `lfcs-project-init` skill. It scaffolds: - 11-section vault folder (`folder-spec.md` canonical) - Per-job CLAUDE.md (with Patterns wikilinks based on `job_type`) - 00-brief.md, 00-Bid-Prep.md, README.md - Drawing-Index.md (text-pass extract from 03a PDFs) - Inclusions-Exclusions.md (draft pre-grill) - Pre-Call-Questions-{date}.md - Airtable Jobs row + Drawings rows seeded - Drive folder created (mirroring vault 11-section, using `&` + en-dash naming) - Source files copied from Cowork uploads OR vault drop into 03a + 06a + 02b as appropriate - Source files (large PDFs, BoQ xlsx) uploaded to Drive 03a / 02b via gws CLI ### Step 2 — vision pass on every drawing in 03a ``` Run lfcs-drawing-extract-vision skill against {job}. ``` Read tool natively renders PDFs (Poppler installed). Vision findings append as `vision_findings:` YAML block per drawing in `Drawing-Index.md`. **Augment-only — never overwrite text-pass content.** For drawings out of LFCS scope (P&ID / Mech / Elec / locator-only civils), defer to post-submission unless you find a clash flag during pass. ### Step 3 — Phase 0 Pre-Pricing-Grill **MANDATORY before any rate set.** Two paths: - **Live:** Rocky available → walk through 7 Q-categories interactively (per `pricing-checklist.md` Phase 0) - **Async:** Rocky unavailable → draft `Pre-Pricing-Grill-{date}.md` async with all assumptions captured + 10 open items isolated for Rocky's next-available verbal-confirm. Same as 2629 pattern. Output: `02b/Pre-Pricing-Grill-{date}.md` signed off (or marked "drafted-pending-rocky-signoff"). ### Step 4 — build pricing pack For most bids, follow the 2629 pattern. Either: - **Reuse 2629 build script as template:** copy `scripts/lfcs/build_2629_pricing.py` → `scripts/lfcs/build_{NN}_pricing.py`, change quantity constants + element line item descriptions at top, re-run. Output: 7 deliverables in vault 02a + 02b - **Or build a generic `lfcs-pricing-pack` skill** if pattern stabilises across 5+ jobs (coo's call to promote) Outputs (filename suffix `_v-CC` for your runs): - `02b/{NN}-Pre-Pricing-Grill_v-CC.pdf` - `02b/{NN}-Take-Off_v-CC.xlsx` - `02b/{NN}-Rate-Buildup_v-CC.xlsx` - `02a/{NN}-Tender-Summary_v-CC.xlsx` - `02a/{NN}-Tender-Summary-Cover_v-CC.pdf` - `02a/{NN}-Inclusions-Exclusions_v-CC.pdf` - `02a/{NN}-Submission-Cover_v-CC.pdf` ### Step 5 — Drive upload ``` bash scripts/lfcs/lfcs-drive-upload.sh "" "" ``` Bakes in `--json` body pattern (correct mimeType + name + parents on first try). Auto-shares each file with `mcloughlinmichael.r@gmail.com` Editor no notification. **DO NOT** call `gws drive files create --params '{...}'` directly. That's the broken pattern (Common Misses 2026-05-04 entry — files land as "Untitled" in My Drive root, xlsx becomes unreadable). ### Step 6 — Airtable sync Call `lfcs-airtable-sync` skill — upserts Bid + Bid Line Items + any new Drawings/Drawing Elements rows discovered during vision pass. Failure non-blocking (vault is source of truth). ### Step 7 — log + commit + push Per AI Team Protocol Write Protocol: 1. Append AB-Test-Tracker round entry (file IDs + lessons applied + verdict-pending block) 2. Append `11_OpsMan_LFCS/Operations/skills/_Log.md` one-liner per skill invoked 3. Append `11_OpsMan_LFCS/_Brain/_Log.md` one-liner with backlinks 4. Append `01_Daily/{today}.md` under `## HH:MM — claude-code-opsman — {short title}` with full structure (decisions / blockers / insights / actions / resume notes) 5. Update `00-brief.md` open items (tick completed boxes; add new items) 6. `git add` specific files (NOT `git add -A`); commit with prefix `claude-code-opsman: ` 7. Push to `origin/main` ONLY if Rocky explicitly asks (default: leave for VPS auto-sync to push every 30 min) ## The standard bid kickoff prompt When Rocky pastes this into your terminal, you have full context to execute end-to-end: ``` Job - - . Bid due <date>. Head contractor: <name + email>. Scope per their email: <scope summary>. Source files already in vault 03a + 06a (<list>). Run the standard bid runbook (per agent-claude-code-opsman.md): 1. health check 2. lfcs-project-init scaffold 3. vision pass on every drawing in 03a 4. Phase 0 grill (drafted async if I'm not available live - flag open items for my next verbal) 5. build pricing pack v-CC (reuse build_2629_pricing.py template, swap constants) 6. lfcs-drive-upload.sh to push to Drive folder <id> 7. lfcs-airtable-sync 8. logs + commit (don't push unless I say) Posture: defensible-for-variations unless I tell you otherwise. Productivity: Rate Card V1.7 day shift, 15% redundancy, 30-day rate validity, mob/sup baked into m2/m3 rates per feedback_lfcs_no_separate_prelims_line.md. ``` ## Live job patterns to know (current state 2026-05-04) | Job | State | Active Bid | Last action | Next action | |---|---|---|---|---| | 2602 Munmorah Bridge | Bid submitted v1 ($407K ex GST) | Airtable recGdAkZHQklVAgUR | claude-code-coo v1 build complete; Cowork v-CW pending | Tue QS call answers + post-call rev2 if material changes | | 2626 Mack Civil Stormwater Pit | Bid in rev5 ($43K ex GST FRP-install-only) | recJFeA83SRGOne1s | rev5 settled after 5 revs + 4 AB rounds | Submit rev5 to Mack OR pivot per Rocky | | 2627 St Clares Convent Refurb | Bid submitted ($71K ex GST) | (TBC Airtable) | claude-code-coo v-CC matched Husse $71K, structurally enhanced | Await Girvan response | | 2628 Vaughan Civil Mason Park BESS | A/B test integrity broken | (TBC) | Cowork v-CW-rev1 ($542K ex GST) — A/B integrity issue noted | Future A/B tests need `--ab-blind-against=` flag (codified in pricing-checklist) | | 2629 TCE Erskine Park WWTP Slab | Pricing pack v-CC built ($219.8K ex GST) | (TBC post-grill) | claude-code-coo built + uploaded; Drive xlsx mimeType bug found + fixed | Tue 6 May Rocky verbal grill confirm; Wed rev2 if changes; Thu PM submit | Read each per-job CLAUDE.md before touching the job. ## Quick handlers — common Rocky asks - **"What's outstanding on 2629?"** → `Jobs/Upcoming/2629 - TCE - Erskine Park WWTP Slab/00-brief.md` open items + `Pre-Pricing-Grill-2026-05-04.md` 10 open items (Rocky verbal Tuesday) - **"Run the bid for 26NN"** → use the standard kickoff prompt above - **"Re-run pricing for 26NN with updated quantities"** → edit constants at top of `scripts/lfcs/build_{NN}_pricing.py` + re-run + re-upload via `lfcs-drive-upload.sh` - **"What did Cowork ship for X?"** → `_Brain/AB-Test-Tracker.md` — find the round; full v-CW Drive URLs + lessons logged per round - **"Show me the rate basis"** → `lfcs-standards/rate-card.md` (canonical day rates) + `lfcs-standards/concepts/Defensible-for-variations-posture.md` (posture decision tree) - **"What spec governs X?"** → `lfcs-standards/specs/` (mirrored MD summaries from spec PDFs) + per-job `Drawing-Index.md` `vision_findings.construction_notes_visible` for drawing-only spec callouts ## Hard rules — never violate (lane-specific) - **Never edit cross-cutting infrastructure** (`lfcs-standards/`, `Operations/skills/`, top-level CLAUDE.md hierarchy outside per-job + this file). Surface bugs to coo via `_System/Conflicts.md` + daily flag. - **Never push to `origin/main` without Rocky's explicit ask.** VPS auto-sync handles every 30 min. - **Never call `gws drive files create --params '{...}'` directly** — use `lfcs-drive-upload.sh` (Common Misses 2026-05-04 entry). - **Never overwrite Cowork's `_v-CW` outputs.** Use `_v-CC` suffix exclusively. Both versions sit side-by-side in same Drive subfolder per AB convention. - **Never proceed past Phase 0 grill if any answer is "TBC" / unanswered** — draft async with open items isolated, OR halt and ask Rocky. - **Never invent quantities** — vision-pass derived OR drawing-derived OR BoQ-derived. If a number isn't in source, mark `*` AfC-confirm + qualify in submission. - **Never delete records from Airtable** — mark `Status = Superseded` instead. - **Append-only on _Log.md + daily + _AgentLog/** — corrections appended with backlink to original, never edit prior. ## Where I (claude-code-coo) live for backup / arbitration If you hit a cross-cutting issue (skill bug, schema gap, posture ambiguity not in concept notes), don't try to fix it in your lane. Surface via: 1. `_System/Conflicts.md` — append entry with file path + what you wanted to change + why 2. Daily note — flag under "Blockers" 3. Continue your task with a workaround if possible (mark workaround as `*` for follow-up) claude-code-coo will see the flag in the daily on next session start + handle the cross-cutting fix.