← All skills & workflows

business

bob-ai-audit

Productizes the BOB-native "living Operational Audit" system: instead of shipping a one-off PDF of findings, hidden costs, and recommended AI initiatives (the APG-style audit model), this skill authors those as real Obsidian entities — `audit-finding`, `audit-waste`, `ai-initiative`, `audit-process`, `client-audit-summary` — that render live in Obsidian Bases, update in place as work progresses, and generate a proper BPMN process diagram. Entities are the source of truth; nothing in this skill treats JSON as storage.

Inputs

  • source_process — Path to the source `type: process` note produced by business-baseline
  • out_dir — Audit folder for the converted note — (company) or (client copy). Never _demo-carebridge.
  • audit — Audit engagement id this process belongs to (added to tags)
  • process_definition — The process to map — its steps, tools/lanes, and flow between steps, gathered from the audit conversation or discovery notes
  • audit_dir — Company-scope audit folder, e.g. , or a client-delivery copy under
  • card_data — The pain point, hidden cost, or blueprint initiative to record, including its id, severity/category, and any supporting quote/citation
  • audit_dir — Same audit folder as map-process
  • vault_path — Absolute path to the vault root
  • audit_dir — Company-scope audit folder to scan
  • client_id — Client identifier — must match a folder
  • audit_dir — Audit folder containing the initiative note
  • initiative_id — id of an ai-initiative note with no client_id set
  • kpi_context — The KPI id this initiative should move (must match a KPI note field), a target value (a business judgment call from the audit conversation), and optionally a baseline value and review date
  • audit_dir — Audit folder to scan for ai-initiative notes
  • audit_dir — Audit folder to scan
  • title — Report title, e.g. '<Client Name> — Operational Audit'
  • brand_theme — Path to a brand-theme note; omit for generic pdf-report defaults
  • audit_dir — Audit folder to scan for entity notes
  • vault_name — Obsidian vault name for the obsidian:// links (default brncx-skills — override in client-vault deployments)
  • out_dir — Output folder (default: the audit folder). Required for read-only inputs like the _demo fixture — write to instead.
  • client_share — Also emit a second variant with all obsidian:// links stripped (plain text, no dead links) for sending outside the vault
  • vault — Vault root or any path inside it
  • port — 127.0.0.1 port (default 8123 — do NOT use 8888, taken by the TaskNotes plugin API)
  • vault_name — Obsidian vault name for the cards' obsidian:// deep links (default brncx-skills)
  • emit_embed_note — Audit id — write {audit-id}-live-dashboard.md (iframe + start instructions) next to the audit and exit, without starting the server

How you ask

  • import this process into the audit
  • convert this business-baseline process
  • map this process for the audit
  • log this pain point
  • log this hidden cost
  • create an AI initiative card
  • generate the BPMN for this process
  • set up my Operational Audit dashboard

Outputs

  • (type: reference; only with --emit-embed-note)
  • audit-dashboard-note (markdown)
  • audit-report-pdf (pdf)
  • bpmn-diagram (bpmn)
  • card-note (markdown)
  • embed-note (markdown)
  • http://127.0.0.1:{port}/{audit-id} (shell), /api/audits + /api/audit/{audit-id} (JSON, re-scanned per request)
  • initiative-note (markdown)
  • live-dashboard (http)
  • matrix-svg (svg)
  • portal-html (html)
  • portal-html-client (html)
  • process-note (markdown)
  • summary-note (markdown)
  • workspace-config (json)
  • {audit_dir}/audit-dashboard.md
  • {audit_dir}/effort-impact-matrix.svg
  • {audit_dir}/{audit-id}-audit-report.pdf (or caller-chosen path)
  • {audit_dir}/{card-id}.md
  • {audit_dir}/{initiative_id}.md (kpi_experiment field updated)
  • {audit_dir}/{process-id}.bpmn
  • {audit_dir}/{process-id}.md
  • {initiative title} ({initiative_id}).md
  • {initiative title} ({initiative_id}).md` — kpi-experiment-tasknote (markdown)
  • {out_dir}/{audit-id}-portal-client.html (only with --client-share; links stripped)
  • {out_dir}/{audit-id}-portal.html (owner variant, obsidian:// links)
  • {out_dir}/{process-id}.bpmn (only with --generate-bpmn)
  • {out_dir}/{process-id}.md (type: audit-process, status: draft)
  • {vault}/.obsidian/plugins/bob-workspace/workspace.json
Levelbeginner
Inputconversation
Outputdocument
Setup[none]
Roles[CEO / Founder, Operations Manager]