I’m Michael Costea. I help people understand AI, choose useful workflows, and build practical systems that keep humans in control.I help people use AI clearly and safely.
My current role is Head of Tech, AI & Systems, where I turn messy tools, handoffs, data, and daily operations into clearer business systems.
I’m especially passionate about AI education and enablement: making AI easier to understand, safer to adopt, and more useful for real people and teams — without the hype.
NEW RESOURCE
Agentic Framework SessionHermes, safe agent setup, shared memory, and Discord as a team operating room.
Current role: Head of Tech, AI & SystemsAI educationWorkflow enablementHuman-reviewed automation
CURRENT ROLEHEAD OF TECH, AI & SYSTEMS · AI-powered business operating systems
Ready. System status: Useful AI.AI: LIVEOPS: ONLINE
Programs
Applications hidden until release. Public webapps, games, demos, and internal tools are hidden until they are rebuilt to the MICHAEL OS 89 style guide and ready for public release.
My Computer - Current Operating Profile
Current Operating Profile
Name: Michael Costea
Current role: Head of Tech, AI & Systems — All Electric Homes
Location: Melbourne, Victoria, Australia
Direction: Helping people and businesses get practical value from AI through clearer workflows, safer automation, and human-reviewed systems.
What I am building now
A practical AI help and workflow layer that helps individuals, teams, and growing businesses move from scattered AI experiments to useful systems with clear owners, evidence, and review gates.
More business context visible across teams and systems.
Less duplicate entry, fragmented handoffs, and manual admin.
Faster lead response, quote preparation, and conversion flow.
More consistent customer experience from first touchpoint to job completion.
Automation that is reviewable, measurable, and safe by design.
Resume.doc - Michael Costea
Michael Costea
Head of Tech, AI & Systems · CTO-track Technology Leader · Business Systems & Automation Operator
Technology and operations leader currently owning the design and execution of technology, automation, AI, and growth systems across a multi-brand electrical and energy services group. My career has moved from electrical delivery, sales, operations, process improvement, and marketing into full ownership of systems, automation, digital infrastructure, and technical strategy.
I am building a scalable AI and workflow layer over core business systems so the company can grow faster, operate more efficiently, and deliver a better customer experience without unnecessary headcount growth in support functions. This is a CTO-track operating role: clear system boundaries, practical automation, measurable workflows, and human review where risk, quality, or customer trust matters.
Current Strategic Focus
Own and manage multi-brand websites, digital infrastructure, lead systems, and internal tooling.
Design and optimise lead generation, conversion flow, lead routing, and qualification systems.
Build and deploy AI-powered automation using agent workflows, including OpenClaw and related local systems.
Integrate marketing, sales, customer service, operations, finance, and admin workflows into a clearer architecture.
Oversee customer journey from first touchpoint to job completion.
Reduce manual admin workload and enable scalable growth without increasing operational overhead.
Experience
Head of Tech, AI & Systems — All Electric Homes
Feb 2026 - Present · Melbourne · On-site
Lead the design and execution of technology, automation, and growth systems across a multi-brand electrical and energy services group. Own digital infrastructure, websites, lead systems, AI-powered automation, customer journey systems, internal tooling, process automation, and technical strategy.
Impact: reduced manual admin workload, improved lead response speed and conversion flow, centralised systems across multiple brands, and enabled scalable growth without increasing operational overhead.
Business Development & Marketing Manager — Want A Heat Pump / Want A Sparky / All Electric Homes
Feb 2024 - Apr 2026 · Australia
Drove B2B and partner client relations, revenue generation, client acquisition and retention, digital strategies, website management, user-metric analysis, lead generation pathways, IVR overhaul, online review automation, chatbot integration, targeted email campaigns, partner programs, and community master class education.
Sales Manager — Want A Heat Pump
Nov 2023 - Apr 2026 · Melbourne
Worked with authorised retailers and delivered heat pump upgrades across residential and commercial sectors under the Victorian Energy Upgrade Program. Managed CRM-driven sales activity, conversion flow, customer relationships, and strategic marketing support.
Electrician — Want A Sparky
Apr 2023 - Jun 2024 · Mornington / South East Melbourne
Delivered domestic, commercial, and emergency electrical services across Want a Sparky, Want A Charger, Want a Heat Pump, and All Electric Homes. Supported the business transition toward electrification and greener energy services.
Electrician — Wired By MJD
Jun 2022 - Apr 2023 · Melbourne
Worked across smart home and integration electrical projects including custom builds, undergrounds, fault finding, renovations, high-end A/V and cinema installs, large rack builds, data, security, TV, KNX wiring, C-Bus diagnosis, custom lighting, and architectural builds exceeding $4M.
Electrician — Ezzy R Electrics
Feb 2018 - Jun 2022 · Melbourne
Built broad electrical trade experience across intercoms, telecommunications, A/V installation, fault finding, medical installations, renovations, custom installs, residential/commercial maintenance, network configuration, pool, garden and deck lighting.
Operations Manager / Owner — Bloom Coffee Bar
Jul 2017 - Feb 2018 · Carlton
Assisted in establishing and operating an owner/operator cafe, developing hands-on experience in people management, operations, customer experience, and small-business execution.
Optus — Sales Operations Support Manager / Process & Content Manager / Business Process Specialist / Retention Consultant
Aug 2010 - Jun 2017 · Melbourne
Managed retail support operations across 352 stores, maintained knowledge bases serving 5,000+ employees and 500,000 monthly visits, led process redesigns, support operations, credit policy improvements, training, communications, and large-scale change management.
Selected impact: 74% increase in work outputs over 12 months, removal/rewrite of hundreds of duplicate processes, support-ticket reduction, improved knowledge search accuracy, and redesigned operational reporting.
Core Capabilities — AI, Systems & CTO-Track Execution
AI Strategy & Roadmappingidentify high-leverage automation opportunities, prioritise by risk/ROI, define AI adoption roadmap, and translate business problems into practical technical systems.
Business Systems Architectureconnect marketing, sales, CRM, ops, finance, admin, field delivery, reporting, and customer journey into clear system boundaries with orchestration between them.
Digital Infrastructure Ownershipmulti-brand websites, domains, hosting, analytics, conversion pathways, landing pages, lead capture, webapp prototypes, and technical vendor/tool rationalisation.
Lead Gen & Conversion Systemslead routing, qualification, response-speed improvement, nurture/follow-up automation, review management, IVR/chatbot improvements, and conversion-flow optimisation.
Data, Reporting & Visibilityoperational dashboards, exception surfacing, KPI/report redesign, source-of-truth thinking, clean data capture, workflow measurement, and decision-support views.
Process Automation & Admin Reductionremove duplicate entry, simplify fragmented handoffs, automate routine admin, standardise operating procedures, and reduce support workload without hiding risk.
Integration MethodsAPI-first integration, browser automation as fallback, desktop/manual last resort, structured handoff design, audit trails, and measurable control points.
Customer Journey Systemsfirst-touch to job-completion visibility, escalation handling, customer communications, partner/client workflows, technician support, and consistent service experience.
Change & Knowledge Systemstraining packs, internal communications, knowledge-base design, process rollout, adoption support, stakeholder alignment, and team enablement.
Operations & Field Contextlicensed electrical background, heat-pump/electrification context, smart-home integration, customer-facing delivery, field constraints, and practical service-business execution.
Leadership & Commercial Judgmentbridge sales, operations, technology, marketing, partners, and leadership; balance automation with quality, customer trust, risk, approvals, and growth strategy.
What I Build - Business AI Enablement
What I Build
I build the environment that enables the business and the people inside it to become better with AI: shared context, safe agent workflows, dashboards, training loops, and operating habits that turn staff into confident AI users instead of passive tool consumers.
Environment over tools: the goal is not one clever chatbot. It is a visible operating layer where staff can learn, delegate, review, improve workflows, and become AI-capable operators inside the business.
Lead Response & Customer JourneyLead intake, qualification, quote prep, follow-up, review requests, warranty loops, and handoff summaries so fewer opportunities go stale.AI Agent WorkflowsOpenClaw/Hermes-style agents with bounded tools, Telegram accountability, logs, receipts, review gates, and fail-closed permission rules.Business AI Enablement EnvironmentStaff become AI-capable operators through shared context, repeatable prompts, visible handoffs, training packs, safe review loops, and practical examples from their own work.Dashboards & Exception RadarOperational views that surface overdue jobs, stale leads, missing payments, review gaps, bottlenecks, and evidence links — not vanity charts.CRM / Ops / Admin IntegrationClear workflow boundaries between sales, marketing, admin, finance, field teams, reporting, and customer communications.Knowledge & Process SystemsSOPs, repeated-question capture, training packs, internal answers, source-of-truth cleanup, and process simplification before automation.Multi-Brand Digital InfrastructureWebsites, landing paths, lead capture, analytics, content systems, release gates, and technical vendor/tool rationalisation across brands.
Useful AI Principles
Useful before impressiveClarity before automationHumans keep judgmentEvery workflow needs receiptsSmall proven loops first
How the first useful loop starts
1. Workflow mapPick one contained workflow before scaling: where the request starts, who owns each handoff, what data is trusted, and where the work currently stalls.2. Safe first loopBuild the smallest useful path with bounded tools, clear success criteria, and no customer, money, or quality impact without review.3. Evidence dashboardShow status, owner, source links, exceptions, and results. Human approval stays in the path until the loop earns trust.
Projects - AI Systems Portfolio
Project Showcase
Positioning: this is the showcase wall for the main projects, repos, dashboards, and operating systems I am actively building or maintaining. Public links are included where safe; private/internal systems show the shape, proof, and current status without exposing customer data, secrets, or fragile prototypes.
active reposscreenshotslive demosproof receiptshuman-reviewed automation
Showcase lens: what it does → why it matters → where it lives → what proof/screenshot exists.
Main Projects & Repos
michaelcostea.com / MICHAEL OS 89
The live portfolio operating system itself: a Win95/Nous-zine showcase for AI education, project proof, demos, deck previews, intake, and repo cards, deployed through GitHub Pages.
Current repo: five0nit/michaelcostea-com.
Acts as the public hub for the active builds below, with direct routes, mobile polish, screenshots, and proof links.
Recent focus: make the projects page read like a polished showcase wall rather than a hidden internal index.
portfolio · GitHub Pages · MICHAEL OS 89 · proof hub
RebateSignal
Victoria-first API service draft for quoting energy upgrade rebate payout ranges across VEU/VEEC, STC, and Solar Victoria, with source-version posture and evidence checks.
Draft tester shows line items, payout low/high, blockers, warnings, and confidence.
Next: replace sample logic with official rule packs.
Invoice automation system with OCR/media smoke tests and a commercial private mirror. The showcase screenshot captures the product surface while repo access stays private.
Public operating standard for turning rough AI requests into better first-pass builds, reports, and handoffs: one strong brief, the right existing base, a maintainability gate, anti-slop finish, and proof receipts.
Includes the Brief2Ship skill, templates, workflow docs, report/document lane, examples, and receipt shape.
Designed for apps, dashboards, landing pages, client docs, QA reports, audits, and handoffs where “done” needs evidence.
AI build standard · report lane · proof receipts · repo-first
Automated Social Life & Brand Engine
End-to-end personal brand automation: AI industry monitoring, repo discovery, draft calendars, Shorts packages, LinkedIn posts/reposts/comments, analytics feedback, and Telegram receipts.
n8n + local Python workflows keep content moving without silent autopublish.
pixel indie game · Lemmings-inspired · chain reactions · AI character
Social Content Engine
Private social automation system for turning research signals into draft packets, QA-gated Shorts, YouTube package checks, channel-specific lanes, calendars, analytics, and approval-first publishing.
Research → draft repository → media package → channel gate.
social engine · content ops · QA gates · analytics
UseAIForMe.com
Early-access AI operator marketplace and consultancy surface: buyers post a real outcome, operators show proof and pricing, and paid work starts only after scope, fit, and approval are confirmed.
Education and enablement deck explaining Hermes, safe agent setup, shared memory, Discord/team rooms, review gates, and how businesses can use agents without silent risk.
Live deck preview is built into this portfolio.
Supports client-facing AI education and onboarding.
n8n/Hermes profile-site generator that turns structured person/company inputs, evidence, screenshots, and source receipts into polished profile pages for clients, founders, and operators.
Generates desktop/mobile previews and source-receipt artifacts.
Public repo: five0nit/ai-profile-sites.
Useful as a client-facing “AI website from real context” demo.
Local-first coordination package for teams of AI agents: shared mailboxes, relay demos, handoffs, visible receipts, bootstrap docs, security notes, and public-alpha packaging.
Built to make overnight/local agents visible instead of silent.
Includes architecture, bootstrap flow, install docs, examples, and release notes.
Local package path: automation/multi-agent-control-kit.
multi-agent control · mailbox · handoffs · receipts
Codex Account Usage + Auth Rotator
Private operator tool for tracking Codex account usage, reset windows, active account status, warmup, switching, and auth rotation across a pool without guessing which login is safe to use.
Shows 5h/7d usage, reset timers, account status, and active selection.
Two small public operator-safety repos: one pushes AI builders to discover the best existing base before greenfield work; the other adds a visible cursor-control countdown and hard UI-control rule.
five0nit/repo-first-starter for base selection and entropy gate.
five0nit/cursor-covenant for visible mouse/keyboard control discipline.
Strategic AI and workflow layer across sales, operations, finance, admin, reporting, customer experience, lead flow, and job completion.
Maps core workflows and handoffs.
Defines automation boundaries, approval gates, and escalation rules.
Turns fragmented work into measurable operating loops.
AI strategy · business systems · operating leverage
2. Agent Infrastructure & Shared Context
Personal and business agent stack using OpenClaw, Hermes, Telegram, dashboards, scheduled jobs, watchdogs, memory, and shared context across devices.
Visible task receipts instead of silent automation.
Shared memory/state so agents do not restart from zero.
Phone-first command path with reviewable outputs.
OpenClaw · Hermes · Telegram · memory · watchdogs
3. Customer Journey & Revenue Automation
AI-assisted customer and lead workflows: fast response, qualification, quote preparation, follow-up, stale-lead detection, review loops, and handoff summaries.
Lead intake → CRM context → next best action.
Quote/admin prep with missing-info flags.
Human approval before customer-impacting sends.
CRM · lead conversion · customer experience
4. Data Visibility & Exception Radar
Dashboard and reporting patterns that turn scattered operational data into clear action lists: overdue work, missing payments, stale leads, customer risks, and review gaps.
Exception-first reporting, not vanity dashboards.
Evidence links and audit trails for decisions.
Cleaner data capture at workflow source.
dashboards · KPI redesign · exception surfacing
New Repo - Brief2Ship
New Repo: Brief2Ship
One brief. Better build. Proof included.
Brief2Ship is a lightweight operating standard for AI-assisted builds and reports: start from one strong brief, choose the best base, keep the code or document maintainable, polish the UX or formatting, and prove it works.
Why it exists: Most AI build loops create a polished mystery box. Brief2Ship forces the useful discipline between a prompt and a shippable first pass: repo-first selection, maintainability gate, anti-slop finish, report/document formatting, and proof receipts.
The user gives one strong brief. The agent asks up to five follow-up questions only if they materially change the build.
less babysitting · clearer startStrict inside
The workflow checks for an existing base before greenfield, rejects brittle code, and finishes the UX instead of shipping generic AI slop.
better judgment · better first passReceipts included
Every build or report ends with changed files, sources used, commands/checks run, verification output, screenshots/logs, and known compromises.
trust through evidence
Copy the shape:Build me a [thing] for [user] that does [main job]. It should feel like [reference]. Constraints: [platform, polish level, auth/integrations, proof required].
Brief2Ship repo card loaded.PROOF > VIBES
Brief2Ship - Detailed Explainer
Brief2Ship: what the repo does and why it helps
Brief2Ship helps turn a rough AI build request into better first-pass AI builds with proof instead of vibes.
The repo packages a small operating standard for AI-assisted product work. It is not a giant framework and it does not force a stack. It gives an agent or operator a repeatable path from brief → base choice → maintainable build or report → polished UX/formatting → proof receipts.
What the repo does
It gives builders a reusable way to run AI builds and decision-ready reports: start from a one-shot prompt, ask no more than five useful follow-up questions, choose the best existing base or source set, then ship a verified artifact.
one-shot prompt · repo-first/source-first selection · verified outputWhy it helps
Most AI coding loops look productive but hide risk: too many clarification loops, random greenfield code, generic UI, weak tests, and no evidence. Brief2Ship makes the agent prove the work before calling it done.
less rework · fewer mystery boxes · more trustWhat is inside the repo
The public repo includes the Brief2Ship skill, workflow docs, four lane examples, build/report kickoff templates, receipt templates, and an install script for loading the standard into Hermes/OpenClaw-style agent workflows.
skill · docs · report templates · examples
The operating loop
1. Brief: capture the thing to build, user, main job, references, constraints, and proof requirements.
2. Base: run repo-first base selection so the agent does not default to unnecessary greenfield code.
3. Build: pass the maintainability gate: clear naming, visible logic, justified dependencies, and debuggable seams.
4. Finish: apply the anti-slop UI finish for apps, and reader-first structure and formatting for reports.
5. Prove: return proof receipts: files changed, sources used, commands/checks run, tests, screenshots/logs, and known compromises.
Use it when
You want an app prototype, dashboard, internal tool, landing page, product page, agent workflow, executive summary, QA report, audit, handoff, or research report to move quickly without losing judgment.
Reader and decision are clear, sources are listed, evidence is separated from assumptions/opinion, recommendations are concrete, formatting is skimmable, and the final artifact is rendered or checked.
A Victoria-first rebate intelligence API for VEU / VEEC, STC, and Solar Victoria payout ranges.
This project turns messy rebate calculators, certificate price feeds, decommissioning rules, approved-product checks, and state/federal scheme conditions into one line-item quote response that installers and marketplaces can test before a job is submitted.
Draft status: The public tester is live for review, but certificate counts are still marked sample_logic. The next build step is replacing placeholders with official VEU calculator and STC calculator rule packs, starting with heat pump hot water decommissioning.
Shape the production POST /v1/quotes response: eligibility, line-item scheme estimates, payout low/high, blockers, warnings, evidence checklist, and source versions.
API contract · deterministic responseRule packs
House the VEC/VEEC calculator resources, VEU activity requirements, STC calculator resources, approved-product logic, and effective-date versions in reviewable rules.
calculator parity · versioned rulesMarket payouts
Keep certificate prices and trader payout amounts separate from eligibility logic, with provider, timestamp, and confidence so old quotes remain auditable.
VEEC price · STC price · trader terms
First activity pack
1. Heat pump hot water: model replacement/decommissioning inputs, approved product status, activity date, postcode, and required evidence.
2. VEU / VEEC: match the official calculator output with golden tests before showing confidence above sample_logic.
3. STC: calculate the federal certificate line item separately so the API can show stacked value without hiding assumptions.
4. Solar Victoria: add grant/rebate/loan eligibility as a separate program line where relevant, not as certificate value.
Ethos: build AI agents the way you would build a serious operating system for your life or business: visible, measured, permissioned, reviewable, and useful every day. The win is not replacing people with a chatbot. The win is removing repetitive drag, keeping context alive, catching exceptions early, and giving humans more leverage.
Most stock agent installs are impressive demos but weak operating layers. They can answer, code, and use tools, but they often lack durable memory, shared visibility, scheduled follow-up, Telegram accountability, watchdogs, dashboards, and a review loop. Our current stack is designed to close that gap.
HermesPlanning and execution layer: coding, repo edits, scheduled jobs, local APIs, research, verification, memory retrieval, and Telegram updates.
Master ControlVisibility layer: projects, live services, scheduled tasks, all sessions, memory, Obsidian notes, and agent engagement from one cockpit.
Human Review LayerTrust layer: approval gates, evidence, audit trails, fail-closed workflows, exception surfacing, and handoff back to a person.
Current daily setup: Lenovo Legion control hub → Work MacBook Pro + four Work Mac Minis → 25 visible agents controllable from one PC. Click the diagram to open it full-size.
Concerns and pitfalls to respect
Silent failure: agents can look busy while missing the real business outcome. Track inputs, outputs, receipts, and verification.
Tool overreach: never let an agent delete, spend, message customers, or change systems without explicit permission and rollback paths.
Context rot: long chats drift. Use memory deliberately, compact sessions, and keep source-of-truth docs clean.
Model cost and rate limits: long tool loops burn tokens. Monitor usage and pick the cheapest model that can reason well enough for the job.
Trust gap: if a human cannot see what happened, why it happened, and what changed, the workflow is not production-ready.
Why this can become a cheat code
When agents are tracked and monitored properly, they become a compounding leverage system: they remember decisions, chase loose ends, prepare work, run checks, produce evidence, and keep pushing while you sleep or focus elsewhere. That is the real cheat code — not one magic prompt, but a monitored agent stack that keeps life and business workflows moving.
Build principles
Start with one painful repeatable workflow, not a vague “automate everything” goal.
Give the agent bounded tools, test data, and a clear success definition.
Make every workflow observable: logs, Telegram updates, dashboard state, and final receipts.
Keep humans on judgment, customer trust, finance, safety, legal, quality, and edge cases.
Scale only after the workflow proves it saves time without creating hidden risk.
AI Help - Start Here
AI Help: Everyday Starter Guides
This is the starting point for people who want to get more out of AI without drowning in jargon, hype, or unsafe shortcuts. Start with one useful workflow, learn the limits, then build confidence safely.
Start useful: pick one repeated task, test with harmless data, and keep humans approving anything risky.
NEW RESOURCE
Agentic Framework Session
A MichaelOS × Nous-zine presentation explaining Hermes, safe agent setup, shared memory, client rollout, monitoring, and Discord server comms for teams.
A practical map for moving from "I use ChatGPT sometimes" to safe, repeatable AI workflows with clear inputs, tools, approvals, evidence, and escalation rules.
For beginnersLearn what agents are, try five low-risk tutorials, and save your first reusable prompt.For business ownersFind repeated admin, missed follow-ups, and safe pilots before buying tools or access.For buildersDesign workflows with sources, tools, logs, approval gates, and rollback plans from day one.
Learn what agents do
→
Try copy/paste tutorials
→
Install one agent
→
Use safely
Plain English version: an AI agent is a helper that can use tools. It can read, write, search, run commands, and remember context — but it still needs clear instructions and human review.
AI Knowledgebase - Agentic Workflows
Agentic Workflow Knowledgebase
Best-in-class AI adoption starts with boring clarity: the job, the source of truth, the tool boundary, the approval gate, the evidence trail, and the next action.
OPERATING MAP
From prompt to operating layer
This knowledgebase helps users choose the right first workflow, understand agent parts, avoid unsafe shortcuts, and turn useful prompts into repeatable agentic systems.
Command bank: copy/paste agent instructions
Dropdown copy/paste commands: open the pattern you need, copy the block, then paste it into your agent before it starts work. These are the strongest operating modifications and rules from the live agent stack: memory first, WSL-first local work where it fits, end-to-end verification, handoff receipts, and safety gates.
High-autonomy operator upgradeMake the agent finish the job, not just suggest steps.
You are my high-autonomy AI operator.
Default behavior:
- Inspect the current state before acting.
- Make a short plan, then do the work end-to-end.
- Use tools when they improve accuracy.
- Verify the result with real checks, not guesses.
- Do not stop at a stub, outline, or "next steps" if you can safely complete it now.
- Do the work end-to-end, then report done, verified, pending, blocked.
Before risky actions, ask first. Risky means: public posting, sending messages, deleting files, spending money, changing customer records, rotating secrets, or touching production systems.
Install the memory layer habitStop the agent forgetting identity, preferences, decisions, and project state.
Before meaningful work, load memory in this order:
1. Startup identity: who you are, operating style, and safety rules.
2. User preferences: tone, approval rules, tools, and recurring constraints.
3. Project memory: current state, known pitfalls, decisions, and open blockers.
4. Shared-agent memory: recent handoffs, receipts, and changes from other agents.
5. Human notes: Obsidian/local notes that explain the why behind the work.
After meaningful work, write a durable receipt:
- what changed
- files/settings touched
- commands/checks run
- verified result
- blockers or risks
- next action
Use Agent-to-agent memory for machine handoffs and a Human memory layer for readable notes.
WSL-first local setupPreferred Windows path for serious local agent work.
For Windows development, prefer WSL Ubuntu unless the tool specifically requires native Windows.
Rules:
- Keep repos in the Linux home directory, not inside OneDrive or random Desktop folders.
- Install basics first: curl, git, python3, python3-venv, python3-pip, Node LTS if the workflow needs it.
- Run agent commands from the project folder inside WSL.
- Treat /mnt/c paths as Windows interop paths, useful for reading files but slower for heavy repo work.
- Verify with version checks before installing extra packages.
Starter commands:
wsl --install -d Ubuntu
sudo apt update
sudo apt install -y curl git python3 python3-venv python3-pip
node --version
python3 --version
Shared-agent handoff receiptMake multi-agent work visible instead of chaotic.
When multiple agents touch the same project, use this handoff format:
Project:
Goal:
Current status: done / in progress / blocked
Files changed:
Commands/checks run:
Decisions made:
Open risks:
What the next agent should do:
What the next agent should not touch:
Rules:
- Read recent handoffs before editing.
- Do not overwrite another agent's unstaged work.
- Verify the live/current state instead of trusting old notes.
- Keep public-facing or destructive actions behind human approval.
Safe workflow builderTurn one repeated task into a supervised agent workflow.
Build one supervised workflow for this repeated task:
Task:
Business goal:
Trigger:
Approved source of truth:
Allowed tools:
Forbidden actions:
Output format:
Human approval required before:
Evidence to save:
Escalate when:
Success metric:
Rollback plan:
Start with a dry run on harmless data. If it works three times manually, convert only the boring proven parts into a monitored workflow.
Customer journey exception radarFind missed follow-ups without letting AI make promises.
Review the customer journey and produce an exception report.
Look for:
- new enquiries without reply
- quotes waiting too long
- stale follow-ups
- overdue jobs or handovers
- invoices/payment reminders needing review
- review requests not sent
- upset or high-risk customer language
Return:
1. ranked issues
2. evidence/source for each issue
3. suggested next action
4. owner
5. draft message only if useful
6. items requiring human approval
Do not send messages, change records, promise pricing/timing, or publish anything.
Best modifications to add to any agent
Memory before workLoad identity, preferences, project state, shared-agent handoffs, and human notes before editing or deciding.Tool-backed accuracyCheck files, dates, versions, live pages, dashboards, or docs instead of answering from vibes.Receipts after workEvery meaningful run ends with changed files, commands, checks, verified state, blockers, and next action.Approval gatesDraft freely; ask before sending, deleting, publishing, spending, customer promises, or production changes.Agent-to-agent memoryUse Byterover-style/shared memory so agents see decisions, handoffs, and recent changes without asking the human again.Human memory layerUse Obsidian/local notes for the readable why: goals, decisions, SOPs, diagrams, and human-friendly project history.
Rules and guidelines that stop agents going sideways
Use the source of truth: if current facts matter, check the live system, docs, file, repo, calendar, or dashboard.
Prefer narrow scopes: one workflow, one safe folder, one owner, one approval gate, one success metric.
Keep secrets out: Never put secrets in memory, prompts, receipts, screenshots, or logs.
Fail closed: if data is missing, facts conflict, confidence is low, or the action affects trust/money/safety, stop and escalate.
Verify before claiming done: run the check, open the page, read the output, or produce the artifact.
Make memory useful: save durable preferences and procedures, not stale one-off task progress.
1. Agentic workflow maturity ladder
Level 0: ad hoc chatYou ask questions and copy answers manually. Useful for thinking, weak for repeatable work.Proof: none required.Level 1: reusable promptOne task has a saved prompt, expected input format, and clear output format.Proof: works three times manually.Level 2: supervised workflowAn agent can read one safe source, prepare the output, and wait for review.Proof: input, output, and approval captured.Level 3: monitored loopThe workflow runs on a trigger or schedule, reports status, catches exceptions, and escalates.Proof: logs, receipts, rollback path.Level 4: operating layerMultiple workflows share context, dashboards, memory, owners, and human review rules.Proof: measurable time saved and fewer misses.
2. Anatomy of a safe agentic workflow
TriggerWhat starts it: new email, uploaded file, calendar time, form submission, dashboard change, or human request.ContextThe approved source of truth: notes, CRM export, SOP, folder, website, transcript, inbox, or dashboard.ToolsWhat the agent may use: search, files, browser, spreadsheet, CRM, calendar, email draft, terminal, or API.BoundaryWhat needs approval: sending, deleting, publishing, spending, changing records, customer promises, and risky decisions.EvidenceWhat gets saved: input, output, source links, changes made, checks passed, owner, timestamp, and human approval.EscalationWhen it stops and asks: missing data, uncertain facts, low confidence, conflicting records, angry customer, or expensive action.
3. Workflow recipe library
Lead response assistantNew enquiry -> extract details -> check duplicates -> draft reply -> create follow-up task -> human approves send.Start metric: first response time.Quote prep assistantJob notes/photos -> missing-info checklist -> risk flags -> draft quote summary -> approval before customer send.Start metric: quote turnaround time.Inbox triageUnread emails -> urgency, owner, next action, stale items -> draft replies -> daily action list.Start metric: unresolved emails older than 48 hours.Weekly exception reportCRM/export/notes -> red flags -> stale leads -> decisions needed -> ranked actions with evidence.Start metric: issues found before customers chase.SOP maintainerRepeated questions -> draft SOP update -> link source docs -> approval -> publish clean answer.Start metric: repeat questions reduced.Customer journey coordinatorLead, booking, quote, job, invoice, review, warranty -> next touchpoint and owner.Start metric: missed follow-ups.
4. Safety gates before anything goes live
Risk area
Agent can do
Human must approve
Customers
Draft replies, summarise history, suggest next action.
Deleting, moving bulk files, changing live records, broad access.
Public channels
Draft posts, check tone, prepare assets.
Publishing, replying publicly, claims, guarantees, legal or safety advice.
5. Copy/paste workflow blueprint
Workflow name:
Business goal:
Trigger:
Input source:
Allowed tools:
Output format:
Approval required before:
- sending customer messages
- changing records
- spending money
- deleting files
- publishing publicly
Evidence to save:
- source used
- output created
- checks completed
- human approval
- final action taken
Escalate when:
- facts conflict
- data is missing
- customer is upset
- confidence is low
- action is risky
6. Glossary for getting started
AgentAn AI assistant that can plan steps and use tools, not just write text.ToolA capability the agent can use, such as files, browser, search, email draft, calendar, or terminal.ContextThe approved information the agent uses to avoid guessing.Human-in-the-loopA person reviews or approves before risky action happens.ReceiptEvidence that shows what happened, why, and what changed.RollbackThe plan for undoing or stopping a workflow if something goes wrong.
7. Readiness score
Green light: one owner, one clear trigger, one safe data source, one output format, one approval gate, one success metric.
Yellow light: unclear source of truth, too many systems, sensitive customer data, no rollback, or no person responsible.
Red light: "automate everything", broad account access, no approval gate, public/customer actions, money movement, or no way to prove what happened.
Best first move: choose one Level 1 reusable prompt, run it manually three times, then convert only the boring proven parts into a supervised workflow.
Agentic Framework Session: Hermes + Discord-ready team comms
New MichaelOS × Nous-zine resource for explaining how agentic systems work in plain English: Hermes profiles, safe tool boundaries, shared memory, client rollout, monitoring, and why a Discord server unlocks better multi-person visibility.
Use this when: someone needs to understand agentic workflows as a real operating layer, not a magic chatbot. The Discord section shows how shared server channels let multiple people openly engage the same agents with visible approvals and receipts.
IntroToAI.ppt - Website Preview
Intro to AI: slide preview
Preview the public AI Help starter deck inside the website. Use the arrows to move through the slides, or download the PDF for easy sharing.
Tip: keep this as a safe starter guide: learn the basics, test one boring repeat task, and keep human review on anything that affects real people.
Guide 1 - What is an AI agent?
What is an AI Agent?
Short answer: an AI agent is an AI assistant that can use tools to get work done, not just answer questions.
You ask a goal
→
Agent plans steps
→
Agent uses tools
→
You review result
Normal chatbot vs AI agent
Chatbot
Answers questions.
Mostly text in / text out.
You do the clicking, copying, saving, and checking.
AI Agent
Can break a goal into steps.
Can use tools like files, browser, terminal, search, memory, and calendars.
Can keep working until a task is complete, then show evidence.
What can an AI agent do?
DocumentsSummarise notes, rewrite rough drafts, create checklists, and prepare first-pass documents for review.
ResearchSearch sources, compare options, extract key trade-offs, and turn findings into a simple report.
AdminPrepare emails, follow-up lists, meeting notes, standard operating procedures, and handover summaries.
MemoryKeep track of preferences, project context, decisions, reusable workflows, and what changed last time.
ToolsRead files, create files, check websites, run safe commands, and bring back evidence instead of guesses.
BusinessSurface exceptions, reduce duplicate entry, prepare reporting, and flag work that needs human approval.
Real workflow examples
Email → CRM → Welcome → Follow-upRead a new enquiry email, extract name/contact/service/suburb, check for duplicates, enter the lead into a CRM, send an approved welcome email, schedule follow-ups until the customer replies, then hand the conversation to a human with a clean summary.Quote prep assistantRead job notes, photos, customer requirements, and pricing rules; prepare a draft quote pack; flag missing information; notify Telegram for approval; only send after human sign-off.Operations exception radarCheck dashboards and inboxes each morning, find stale leads, overdue jobs, missing payments, or review risks, then post a ranked action list with links and evidence.Knowledge-base maintainerWatch repeated staff questions, draft SOP updates, link source documents, ask for approval, and publish a cleaner internal answer so the next person does not ask again.Customer journey coordinatorTrack first touch, booking, quote, job completion, invoice, review request, and warranty follow-up so nothing falls between sales, admin, and field teams.Personal life adminSummarise bills, renewals, travel plans, reminders, emails, and documents into one Telegram briefing with tasks and due dates.
The power is the chain: read context → update systems → communicate → schedule next action → monitor for reply → escalate to a human when judgment or trust matters.
What it should not do without you
Spend money, delete files, send public messages, or change business systems without approval.
Make legal, medical, financial, safety, or employment decisions on its own.
Replace human judgment where customer trust, risk, quality, or approvals matter.
First proven prompt to try
I am new to AI agents. Explain what you can do in 5 bullet points, then ask me one simple question so we can try a safe first task.
Guide 5 - Your first safe AI workflow
Your First Safe AI Workflow
A beginner tutorial for turning one annoying repeat task into a reusable AI playbook.
Goal: do one useful workflow in about 30 minutes without giving the AI dangerous access. You will pick a low-risk task, give it examples, check the answer, then save the final prompt so you can reuse it.
Step 1 — choose a boring, safe task
Good first tasksSummarise meeting notes, rewrite an email draft, turn messy notes into a checklist, compare options, or make a simple SOP.Avoid on day oneCustomer databases, payments, deleting files, public posting, medical/legal/financial decisions, or anything that can hurt trust if wrong.Use fake or copied dataPaste a small sample into the chat. Remove passwords, private customer details, and anything you would not put in a training document.Define successWrite one sentence: “I want a clean checklist I can follow tomorrow” or “I want a polite email draft I can edit before sending.”
Step 2 — use this starter prompt
You are helping me build one safe repeatable workflow.
Task: [describe the boring task]
Input: [paste notes, transcript, email draft, or requirements]
Output format: [checklist / email draft / table / SOP]
Rules:
- Ask questions only if something critical is missing.
- Do not invent facts.
- Mark uncertain items as [check].
- Do not send, delete, buy, publish, or change systems.
- Give me a short final review checklist.
Step 3 — review like an operator, not a spectator
Accuracy passCheck names, dates, numbers, promises, and any claim the AI may have guessed.Tone passMake it sound like you. Remove corporate sludge, hype, over-promising, or fake confidence.Risk passAnything involving money, customers, safety, privacy, or reputation needs a human approval step before action.Evidence passAsk: “What source line supports each important point?” If it cannot point back to the input, mark it as [check].
Step 4 — turn the good version into a reusable playbook
Once the result is useful, save the prompt plus the expected output format. That is your first workflow, not just one lucky chat.
Workflow name: [Example: Weekly meeting notes to action list]
When to use it: [Every Friday after team meeting]
Inputs needed: [Transcript, decisions, open questions]
Output wanted: [Owner / task / due date / risk / next action]
Human approval required before: [sending to team, updating CRM, promising dates]
Final prompt: [paste the cleaned prompt here]
Step 5 — add the smallest automation later
Manual firstRun it by copy/paste 3 times. Fix the prompt each time. Manual repetition exposes the weird edge cases.Then semi-automaticLet an agent read one safe folder or draft one message, but keep approval before it changes anything.Approval gateThe magic words are: “draft only, wait for my approval.” Keep that rule until the workflow is boring and proven.Evidence ruleFor every completed run, keep the input, output, review notes, and what changed. No evidence, no trust.
First workflow ideas
Inbox triage: paste 10 emails → get urgency, owner, next action, and draft replies.
Quote prep: paste job notes → get missing info, risks, and a customer-friendly summary.
Meeting cleanup: paste transcript → get decisions, tasks, blockers, and follow-up message.
Research brief: paste links/notes → get pros, cons, unknowns, and recommendation.
Rule of thumb: if you would trust a careful junior assistant to draft it but still want to review before sending, it is a good first AI workflow.
Guide 6 - How to hire AI help safely
How to Hire AI Help Safely
A practical buyer guide for when you want results done for you, not another chatbot tab to babysit.
Short version: good AI help still needs a human operator, a clear brief, visible scope, approval rules, and proof. If someone promises “fully autonomous magic” before they understand the job, slow down.
When done-for-you AI makes sense
Good fitYou have one annoying repeat task, a small workflow, a website change, inbox/admin cleanup, research pack, CRM tidy-up, or a prototype that needs building.Still keep a humanCustomer messages, pricing, operations, files, and payments should stay reviewable by a real person even if AI does most of the draft work.Bad first buy“Automate my whole business” with no owner, no source data, no workflow map, and no approval rule. That is how vague AI projects eat time and money.Best first winPick one narrow outcome: better lead response, faster quote prep, a cleaned-up website section, or a weekly admin/reporting loop.
What a solid AI service should show you
Clear scopeWhat is being delivered, what is not included, what inputs are needed from you, and what “done” means.Real operatorThe work may use AI tools, but a named human should still own the output, communication, fixes, and review loop.Proof and examplesAsk for previous work, screenshots, sample outputs, or a visible process. “Trust me bro” is not a portfolio.Safe payment logicFixed packages can go to checkout fast. Messier custom jobs should confirm scope, fit, and price before money moves.
Questions to ask before you pay
Ask this
Why it matters
What exactly will I receive?
Stops vague deliverables and “strategy” fluff.
What do you need from me to start?
Shows whether the operator knows the real dependencies.
Which parts are AI-generated vs human-reviewed?
Helps you judge risk, quality, and how much checking you still need to do.
What happens if the first version misses?
Clarifies revision flow instead of surprise conflict later.
Will this touch customer data, payments, or live systems?
If yes, the workflow needs explicit approvals and safer rollout steps.
Red flags
No one can explain the workflow in plain English.
The seller jumps straight to “full automation” without asking about your current process.
They want broad account access before agreeing scope.
They cannot show sample outputs, checkpoints, or a revision plan.
They promise zero mistakes, zero review, or “set and forget” on risky tasks.
Simple buyer brief template
Task:
I need help with [one workflow or deliverable].
Outcome I want:
[what success looks like in plain English]
Inputs I can provide:
[notes, screenshots, links, files, examples]
What must not happen:
- no public posting
- no customer sends
- no deleting data
- no spending money
Approval rule:
Draft first. Wait for my review before anything goes live.
UseAIForMe-style rule of thumb: fixed packages can be priced fast, but custom AI work is healthier when the platform confirms scope, operator fit, and review gates before charging like it is a commodity.
Guide 7 - Chatbot or operator?
Chatbot or Operator?
Use a chatbot when you need ideas or drafts. Use an operator when you need an actual outcome finished.
Simple rule: if the task touches tools, files, formatting, handoffs, website edits, research cleanup, or review loops, you usually want a human operator using AI, not just a chatbot tab.
Fast decision table
If you need...
Best first move
Why
Ideas, wording, rough planning, or a first draft
Use a chatbot
Fast, cheap, and good for low-risk thinking work.
A landing page, web app, workflow, spreadsheet cleanup, or finished deliverable
Use an operator
Someone still has to check quality, connect tools, and own the output.
A messy task but you do not know who should do it
Use a matching marketplace
You need help scoping, fitting the operator, and keeping payment gated until the job is clear.
Anything touching customers, payments, or private systems
Use human-reviewed delivery
Trust, safety, and approval checkpoints matter more than speed.
What a done-for-you AI operator actually does
Translates the messy askTakes your vague goal and turns it into scope, deliverables, and a sensible first step.Uses the right toolsPrompts, code, websites, spreadsheets, docs, automation tools, or design tools instead of pretending one chat box does everything.Checks the outputFixes formatting, tests logic, catches obvious breakage, and shows proof before calling it done.Keeps risky work gatedScope, pricing, approvals, and access stay visible before anything live or expensive happens.
Good tasks for a marketplace like UseAIForMe
Website cleanupLanding pages, copy refreshes, mobile fixes, new sections, and lightweight web builds.Admin + inbox cleanupSpreadsheet tidy-ups, summaries, recurring reports, and repeatable office work.CRM or workflow setupLead tracking, follow-up loops, dashboards, SOPs, and operating docs.Agent or automation buildsScoped AI helpers, research loops, content systems, and practical internal tools.
Bad expectations to avoid
“AI will run my whole business with no human involved.”
“Custom work should be one-click checkout before scope is reviewed.”
“I can paste passwords or API keys into a public job card.”
“If the tool sounds smart, the finished output must be right.”
Best way to brief the work
Task:
I need this outcome finished:
Success looks like:
Useful links / examples:
Budget range:
Deadline:
Rules:
- no public posting
- no spending money
- no customer sends
- no secrets in chat
- draft / scope first
Why this matters: the gap between “AI can answer” and “AI can deliver” is where most people lose time. A marketplace flow works best when it protects scope, shows operator proof, and keeps money gated until both sides agree on the real job.
Guide 8 - Practical AI tutorials
Practical AI Tutorials That Actually Help
Five real beginner workflows with a useful input, a better prompt, a quality bar, and the next automation step.
How to use this page: do not just paste a magic prompt and hope. Pick one workflow, use the sample structure, run it on harmless data, then judge the output against the quality bar. If it passes three times, turn it into a repeatable agent task later.
Tutorial 1 — turn messy notes into an action plan
Use when: you have meeting notes, voice-dump notes, job notes, or a messy brain dump and need a usable plan.
Act as an operations assistant.
Turn the notes below into an action plan I can use today.
Output exactly this structure:
1. One-sentence summary
2. Decisions already made
3. Action table: task | owner | due date | dependency | risk
4. Missing information I must confirm
5. Two-minute message I can send to the team
Rules:
- Do not invent owners, dates, prices, or promises.
- If the notes do not say something, write [check].
- Put urgent/customer-impacting items first.
Notes:
[paste notes]
Quality bar: a busy person should know what to do next without reading the original notes.
Tutorial 2 — build a customer-safe email from rough context
Use when: you need a reply that is clear, honest, and not full of AI fluff.
Write a customer-safe email draft from this context.
Context:
[paste situation, customer question, facts, constraints]
Output:
- Subject line
- Email draft
- Internal notes: what I should verify before sending
Style:
- Plain English, Australian tone, no corporate waffle.
- Be helpful but do not overpromise.
- If we need to check something, say we will confirm it instead of pretending.
- Do not mention AI.
Quality bar: you should only need light editing, not a full rewrite. Check names, dates, prices, and promises before sending.
Tutorial 3 — make a decision brief, not a vague comparison
Use when: you are comparing tools, suppliers, software, quotes, workflows, or strategy options.
Create a decision brief from the options below.
Decision to make:
[what are we choosing?]
Options:
[paste options, notes, links, prices, concerns]
Output exactly:
1. Recommendation in one sentence
2. Comparison table: option | cost/effort | upside | downside | hidden risk | best fit
3. What I would choose if speed matters
4. What I would choose if quality/risk matters
5. Questions to answer before committing
Rules:
- Separate facts from assumptions.
- Mark anything not proven as [check].
- Do not choose the fanciest option by default.
Quality bar: the answer should help someone make a decision, not just describe the options.
Tutorial 4 — turn one repeat task into an SOP
Use when: a task keeps living in someone’s head and needs to become teachable.
Turn this repeat task into a simple SOP.
Task:
[paste what happens now]
Output:
- Purpose: why this task exists
- Trigger: when to do it
- Inputs needed
- Step-by-step process
- Quality check before calling it done
- Common mistakes
- Escalate to a human when...
- Simple checklist version
Rules:
- Write for a new person on their first week.
- Keep steps concrete.
- Do not add software/tools unless I named them.
Quality bar: someone else could follow it without asking you five basic questions.
Tutorial 5 — create a weekly exception report
Use when: you need a manager/operator view of what needs attention, not a vanity summary.
Create a weekly exception report from this raw update.
Raw update:
[paste notes, numbers, job list, CRM export, inbox notes]
Output:
1. Executive summary: 5 bullets max
2. Red flags: what needs action now
3. Stale items: leads/jobs/tasks waiting too long
4. Numbers that changed
5. Decisions needed from me
6. Next actions ranked by impact
7. Follow-up message drafts if useful
Rules:
- Surface bad news clearly.
- Rank by customer impact, revenue impact, and operational risk.
- Mark uncertain numbers as [check].
Quality bar: the report should make the next action obvious within 30 seconds.
Turn a good tutorial into an agent workflow
Run it manually 3 timesIf the prompt only works once, it is not a workflow yet. Fix the input format and output format until it is repeatable.Add a safe sourceLet an agent read one folder, one pasted note, or one exported CSV. Do not give it your whole business system first.Add an approval gateThe agent can draft, rank, summarise, and prepare. A human approves sending, spending, deleting, publishing, or customer-impacting changes.Keep evidenceSave input, output, what changed, and what was approved. Evidence is what turns AI from a toy into an operating layer.
Guide 10 - Build a memory layer
Build a memory layer for your agent
Don’t forget who you are. The agent becomes useful when it can load identity, project state, decisions, receipts, and human notes before it acts.
Why memory matters
Memory is not a nice-to-have for agents: it is the difference between a helper that restarts from zero every chat and an operating layer that keeps identity, decisions, preferences, project state, sources, and lessons in context.
Good memory improves accuracy because the agent can ground answers in what has already been decided, avoid repeating mistakes, preserve user preferences, and know when a current request conflicts with past context. Bad or missing memory creates confident but stale answers.
Why install Byterover and Obsidian?
Byterover: shared agent memoryUse Byterover, or a Byterover-style shared layer, when more than one agent or session touches the same work. It gives agents a compact place to read decisions, handoffs, blockers, and verified receipts before acting.Why it is worth itIt reduces repeated explanations, prevents two agents from solving the same problem differently, and lets a new session continue from the last trustworthy checkpoint instead of guessing from stale chat context.Obsidian: human-readable memoryInstall Obsidian so the human has a local vault for project pages, decisions, notes, links, and “why we did this” context. It is editable, searchable, private, and easy to audit.Why both together workByterover is the machine layer: compact, current, and operational. Obsidian is the human layer: readable, explainable, and long-lived. Together they make the agent stack easier to trust.
The simple architecture
1. Startup identityA short “who you are, who you help, how to behave” file. This stops the agent from acting like a random new chatbot every session.2. Current project stateSmall status files or logs that say what changed, what is blocked, what was verified, and what should happen next.3. Byterover shared layerRecent agent receipts, handoffs, decisions, and warnings in a compact format agents can load quickly before work.4. Obsidian local vaultReadable human notes: project home pages, decisions, diagrams, links, research, dashboards, and manual review notes.5. Receipts after workEvery meaningful run should leave a short durable receipt: done, files changed, checks run, blocked items, and next action.6. Retrieval before actionThe agent should read the right memory first, then act. Memory that is never loaded is just a dusty folder.
Copy/paste prompt 1 — give your agent memory rules
Use this when setting up a local agent. Replace the bracketed names and folder paths, then paste it into your agent’s system instructions, project instructions, or first message.
You are my long-running local AI operator, not a one-off chatbot.
Your job is to help me get real work done while preserving context between sessions. Act with high autonomy on safe local work, but stop and ask before public posts, customer messages, spending money, deleting data, changing production systems, or exposing secrets.
Before meaningful work, load memory in this order:
1. Identity file: who you are, who you help, communication style, safety rules.
2. User preferences: tone, timezone, tools, approval rules, recurring dislikes.
3. Current project state: active goals, blockers, last verified result, next action.
4. Shared agent memory: recent receipts from other agents, handoffs, decisions, and warnings.
5. Human notes: Obsidian/local notes that explain the why, not just the latest task.
Mimic this setup:
- Startup identity: a short durable file like SOUL.md or AGENT.md.
- User/profile memory: a compact file for stable preferences only.
- Project receipts: append-only status/change/test/blocker notes per project.
- Byterover-style agent-to-agent memory layer: compact shared context so agents can see each other’s work.
- Obsidian local human layer: readable notes and dashboards the human can inspect and edit.
- Source links: when possible, cite the file, note, URL, or command output used.
Operating rules:
- Do not rely on memory alone for current facts. Check live files, git state, docs, or the web when accuracy matters.
- If memory conflicts with the current user request, follow the current request and record the updated decision.
- Keep memory small. Save durable preferences, project conventions, decisions, and reusable lessons. Do not save stale task noise.
- Prefer evidence over vibes. Run checks, read files, verify outputs, then report what actually happened.
- Never paste secrets into memory, logs, public docs, or chat.
After meaningful work, write a short durable receipt with:
- Project:
- Done:
- Files changed:
- Commands/checks run:
- Verified result:
- Blocked/pending:
- Next suggested action:
When you answer me, be brief and clear. Separate DONE, VERIFIED, PENDING, and BLOCKED. If you are missing access or context, say exactly what is missing.
Copy/paste prompt 2 — ask the agent to set up the memory files
Set up a local memory layer for this workspace.
Create or update these files/folders if they do not exist:
- AGENT.md: who you are, what you help with, communication style, approval rules, and hard safety limits.
- memory/USER.md: durable user preferences only. Keep it short. Do not save temporary task progress.
- memory/PROJECT_STATE.md: active goals, known blockers, last verified result, and next action.
- memory/receipts/YYYY-MM-DD.md: append-only work receipts after meaningful tasks.
- obsidian/ or notes/: human-readable project notes, decisions, diagrams, and links.
Before each task, read AGENT.md, memory/USER.md, memory/PROJECT_STATE.md, and the latest receipts. After each meaningful task, append a receipt with done, files changed, commands run, verification, blockers, and next action.
If Byterover or a shared memory tool is available, connect it as the compact agent-to-agent memory layer. If not, mimic it with append-only markdown/jsonl receipts that every agent can read.
Copy/paste prompt 3 — ask the agent to prepare Obsidian notes
Create an Obsidian-friendly project vault for me.
Make these notes:
- 00 Home.md: links to the active projects, current priorities, and latest receipts.
- Projects/[project-name].md: goal, owner, source links, current status, decisions, open questions, and next action.
- Decisions.md: date, decision, reason, source/evidence, and what would make us revisit it.
- Agent Receipts.md: short summaries of verified agent work with links to files or commands.
- Prompt Library.md: reusable prompts that actually worked, with when to use them and failure warnings.
Use simple Markdown and wiki links. Keep it readable for a human, not just optimized for an AI. Do not store secrets. When you finish, tell me exactly where the vault is and what notes you created.
Quality check
The agent should know who it is, what it is allowed to do, and what it must never do without approval.
The next agent should be able to read the latest receipt and continue without asking the human to repeat the whole story.
The human should be able to open Obsidian/local notes and understand what the agents believe is true.
The memory layer should improve accuracy, not become a junk drawer of stale guesses.
Guide 3 - Prerequisites before install
Prerequisites Before You Install an AI Agent
The guide before the guide: get the boring local tools right before blaming Hermes, OpenClaw, or the model.
Plain English rule: prerequisites are not busywork. They decide whether the installer can download files, compile small dependencies, find Python, run Node tools, and write config safely. If the base machine is wrong, agent context and accuracy suffer because the agent wastes time guessing around broken tools instead of doing the actual job.
Dependency prerequisites by platform
Use this as the pre-flight check before the install guide. Finish the row for your computer, then move to Guide 4.
Computer
Install or verify first
Check commands
Beginner note
macOS
Xcode Command Line Tools, Homebrew, Git, Terminal restart.
Install Xcode tools and Homebrew before CLI installs. If brew is missing, use brew.sh, then reopen Terminal.
Windows native
Windows admin access, PowerShell, execution/network permission. Hermes Desktop/PowerShell installer does not require beginners to manually install Node or Python first unless hermes doctor says so.
powershell hermes --version hermes doctor python --version
Start native first. Do not mix native Windows and WSL halfway through one install. If later tools ask for Python, use the official Python 3 installer or Windows Store Python and rerun hermes doctor.
Windows WSL Ubuntu
WSL Ubuntu, sudo apt, Curl, Git, Python basics for Linux tooling: python3 python3-venv python3-pip. Node.js 24 LTS only if you choose OpenClaw or Node-based tools.
If node --version fails, that is fine for basic Hermes; install Node before OpenClaw or Node tools.
OpenClaw any OS
Node.js 24 LTS preferred; Node 22.19+ minimum for npm/manual fallback. Provider API key/login.
node --version npm --version
OpenClaw is Node-based, so Node is a real prerequisite there.
Do not skip the safe folder
Make one harmless workspaceUse ~/ai-agent-test, C:\AI Agent Test, or a small Desktop folder with one test note. Do not point a new agent at all Documents, customer files, money, or live systems.Reload the shellAfter installing Xcode tools, Homebrew, Python, Node, Hermes, or OpenClaw, close and reopen Terminal/PowerShell so version checks use the new PATH.Check before proceedingIf a required command is missing, fix that first. Randomly repeating installers usually creates a messier machine.Then install the agentWhen the prerequisite row passes, open Guide 4 and follow the selected Hermes/OpenClaw install path from top to bottom.
Next: open only after this prerequisite check is done.
Guide 4 - Install your first AI agent
Install Your First AI Agent
A simplified native-local install path: choose one agent, one computer, one private test.
Simple install rule: start with the normal local installer for your computer — not Docker. Install the app/CLI, complete the guided setup, get one local reply, then add Telegram. Do not connect real business systems on day one. If a step fails, stop there — do not stack random fixes.
Hermes: easiest first choiceBest when you want a friendly agent that can chat, edit files, run checks, use skills, remember context, and connect to Telegram later.OpenClaw: choose when you want a bigger local control planeBest when you want a broader cockpit for agents, gateway status, dashboard chat, channels, skills, workspaces, and local automation.Beginner auth ruleUse the guided OAuth/provider setup where offered. Avoid juggling API keys until the simple local chat path works.Safety ruleUse a harmless test folder first. No customer data, money, deleting, public posting, or live business tools until you understand approvals.
Follow this order: Install → reload shell → version check → setup/provider → local chat → doctor/status → optional Telegram. If one stage fails, fix that exact stage before adding the next feature.
1. Install the programUse Hermes Desktop on Mac/Windows if you want the easiest app path, or the official CLI installer if you are comfortable pasting one command.2. Connect a modelRun hermes setup or hermes model. The model/provider is the AI brain; Hermes is the operator shell around it.3. Prove local chat worksRun one safe local prompt before Telegram, web tools, memory, cron, or agents. A gateway will not fix a broken model setup.4. Add phone access lastOnly after local chat and hermes doctor pass, run hermes gateway setup for Telegram/Discord/Slack.
Where Hermes stores things
These locations make the install less mysterious. Do not edit secrets in a public doc or paste them into chat.
~/.hermes/config.yamlMain settings: model/provider choice, toolsets, gateway, memory, terminal, display, approvals.~/.hermes/.envPrivate API keys and tokens. Treat it like a password file. Do not screenshot or share it.~/.hermes/sessions / ~/.hermes/state.dbSession history and searchable past conversations.~/.hermes/skillsReusable procedures Hermes can load later so it does not relearn the same workflow every session.~/.hermes/logsGateway/runtime logs. Check here when Telegram or background services are silent.~/.hermes/hermes-agentThe source checkout when installed by the git installer path.
Provider setup choices
Beginner path: guided setup
hermes setup
hermes model
Use this when you are unsure. It walks you through provider/model selection and writes the config for you.
OAuth path when available
hermes auth add openai-codex
# or use the provider login offered by hermes model/setup
OAuth opens a browser login so you avoid copying secret API keys by hand.
API key path
# example private env var names
OPENROUTER_API_KEY=...
ANTHROPIC_API_KEY=...
OPENAI_API_KEY=...
Put keys only in the local Hermes env/config flow, never into a website, prompt, GitHub issue, or shared chat.
First safe Hermes workspace test
This proves Hermes can see a harmless folder, answer from evidence, and respect boundaries before you trust it with real files.
mkdir -p ~/ai-agent-test
cd ~/ai-agent-test
printf "Buy milk\nEmail Sam tomorrow\nDo not edit this file yet\n" > test-note.txt
hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files."
hermes doctor
hermes status
What success looks like
The installer or command completes without scary red errors.
You can run hermes --version or openclaw --version.
You complete the guided model/provider setup.
You get one local hello reply in the app, terminal, or dashboard.
Only then: your private Telegram bot replies to one safe test.
Status/doctor/gateway checks look healthy.
What you are about to install
1. Agent appHermes or OpenClaw is the local program on your computer. It coordinates tools, memory, messages, dashboard chat, and model calls.2. Model loginThe model is the AI brain. OAuth means browser login. API keys are secret passwords. Keep both private.3. Local dashboardThe dashboard is the cockpit. Open it locally, test chat, and check status before connecting phone channels.4. Telegram gatewayThe gateway is the bridge between your private Telegram bot and the local agent running on your computer. Add it after local chat works.
Step 0 — choose one path
Important: this is the only choice section. After this, follow the visible selected panel from top to bottom.
1. Choose the agent
2. Choose your computer
Showing now: Hermes Agent on Mac. Only this computer path is visible below.
Step 1 — before touching Terminal: get these ready
This checklist changes with Step 0. Pick Hermes/OpenClaw and Mac/Windows/Linux above, then install only the prerequisites shown here before running the installer.
Mac admin accessUse your own Mac account with permission to install developer tools and Homebrew. Keep Docker out of the beginner path.Xcode Command Line ToolsInstall Apple’s build tools first. Run xcode-select --install, finish the Apple prompt, then confirm git --version works.HomebrewInstall Homebrew before the one-line Hermes installer. It gives the Mac a predictable local package path if Hermes or its dependencies need it.Terminal readyOpen Terminal from Spotlight. After installing tools, close and reopen Terminal so your shell can see new commands.Model/provider loginHave Nous Portal or another supported model provider ready for hermes setup --portal / hermes setup.Safe test folderCreate AI Agent Test with one harmless test-note.txt. Do not point Hermes at Desktop/Documents yet.
Windows admin accessUse your own Windows account. Run PowerShell as administrator only if the installer asks.PowerShell readyOpen Start → PowerShell. The beginner route is native Windows first, not Docker and not WSL by default.Execution/network permissionCorporate antivirus may block install scripts. If PowerShell blocks the installer, stop and read the error instead of stacking random fixes.Model/provider loginHave Nous Portal or another supported provider ready for guided setup.Optional WSL fallback onlyIf native Windows gets messy, install Ubuntu in WSL and use the Linux checklist below. Do not mix both paths halfway through.Safe test folderCreate a harmless folder such as C:\AI Agent Test. Avoid business folders until local chat works.
Ubuntu/Debian shellUse a normal Linux machine or WSL Ubuntu with permission to run sudo apt.Core CLI toolsInstall curl and git first: sudo apt update && sudo apt install -y curl git.Shell reload readyAfter the installer, you will run exec $SHELL -l or open a fresh terminal so hermes is on PATH.Model/provider loginHave Nous Portal or another supported provider ready for hermes setup.WSL noteIf you are inside WSL, keep files in your Linux home folder while learning, not deep under /mnt/c.Safe test folderCreate ~/AI Agent Test with harmless notes only.
Mac admin accessUse your own Mac account and Terminal. Docker is not the beginner path.Xcode Command Line ToolsRun xcode-select --install if git --version triggers Apple’s developer tools prompt.Homebrew helpfulInstall Homebrew if you do not already have it. It makes Node and CLI dependency fixes much less painful.Node targetOpenClaw is Node-based. Aim for Node 24; Node 22.19+ is the minimum supported line if you use npm/manual fallback.Provider/API keyHave the provider login or API key you want OpenClaw to use. Keep API keys private.Safe workspaceCreate a small test workspace before onboarding asks where agents may work.
Windows admin accessUse native PowerShell first. Run as administrator only if Windows asks.PowerShell readyStart → PowerShell. Do not begin with Docker. WSL is a separate optional route, not the default.Node targetOpenClaw is Node-based. The official installer should guide setup; if using npm fallback, use Node 24 or at least Node 22.19+.Provider/API keyHave your model provider login or API key ready for onboarding. Never paste it into public chats or pages.Optional WSL fallback onlyIf Windows native setup fails, switch cleanly to WSL Ubuntu and use the Linux/OpenClaw checklist.Safe workspaceCreate C:\AI Agent Test or a similar harmless folder before connecting real files.
Ubuntu/Debian shellUse Linux or WSL Ubuntu with sudo apt access.Core CLI toolsInstall curl and git first: sudo apt update && sudo apt install -y curl git.Node targetOpenClaw is Node-based. Prefer Node 24; Node 22.19+ is the minimum supported line for manual/npm fallback.Provider/API keyHave the model provider login or API key ready, stored privately.WSL noteOn WSL, keep the beginner workspace in your Linux home folder while learning.Safe workspaceCreate ~/AI Agent Test and use that for first onboarding/tests.
Telegram on phoneOptional for first day. Install Telegram only if you want phone chat after the local test works.BotFather tokenOptional after local chat works. Use verified @BotFather, create a bot, and keep the token private.Telegram user IDOptional after local chat works. Use @userinfobot or @get_id_bot to allow only yourself.Permission ruleDay one: no customer data, money, deleting files, public messages, business systems, or full Desktop/Documents access.
Dependency prerequisites by platform
Use this as the boring pre-flight check. The guided installers handle a lot, but beginners still need to know which system tools matter before blaming the agent.
Computer
Install or verify first
Check commands
Beginner note
macOS
Xcode Command Line Tools, Homebrew, Git, Terminal restart.
Install Xcode tools and Homebrew before CLI installs. If brew is missing, use brew.sh, then reopen Terminal.
Windows native
Windows admin access, PowerShell, execution/network permission. Hermes Desktop/PowerShell installer does not require beginners to manually install Node or Python first unless hermes doctor says so.
powershell hermes --version hermes doctor python --version
Start native first. Do not mix native Windows and WSL halfway through one install. If later tools ask for Python, use the official Python 3 installer or Windows Store Python and rerun hermes doctor.
Windows WSL Ubuntu
WSL Ubuntu, sudo apt, Curl, Git, Python basics for Linux tooling: python3 python3-venv python3-pip. Node.js 24 LTS only if you choose OpenClaw or Node-based tools.
If node --version fails, that is fine for basic Hermes; install Node before OpenClaw or Node tools.
OpenClaw any OS
Node.js 24 LTS preferred; Node 22.19+ minimum for npm/manual fallback. Provider API key/login.
node --version npm --version
OpenClaw is Node-based, so Node is a real prerequisite there.
Plain English rule: Hermes beginners should verify Mac Xcode/Homebrew or Windows/WSL shell basics, then let the official Hermes installer and hermes doctor tell them what is missing. OpenClaw beginners should treat Node.js 24 LTS as required.
In plain English: Step 1 is now a dependency checklist for the selected agent and computer. If any required item above is missing, fix that first or the installer/setup is likely to fail.
Step 2 — selected install path
Follow only the selected panel below. Each panel is a complete install + initial setup path. The dashboard/Web UI appears at the end on purpose.
Hermes native-local flow
Run the Desktop/native installer or CLI installer → hermes setup or hermes setup --portal → hermes model if needed → one local chat → optional Telegram gateway → hermes doctor / hermes status.
OpenClaw native-local flow
Run the official Mac/Linux/Windows installer → complete openclaw onboard when prompted → check openclaw --version and gateway/status commands → open the local dashboard/control UI → optional Telegram.
Hermes Agent on Mac — complete beginner path
1. Easiest native option: use Hermes Desktop
Download and run the Hermes Desktop installer from the official Hermes Agent website. This is the recommended Mac path because it installs the desktop app and command-line tool together.
2. Command-line option: open Terminal
Press Command + Space, type Terminal, press Enter.
In plain English: Terminal is where you paste setup commands if you are not using the desktop installer.
3. Confirm Xcode tools + Homebrew first
xcode-select --install
# after the Apple prompt finishes:
git --version
brew --version
If brew is missing, install Homebrew from brew.sh, then open a fresh Terminal before running the Hermes installer.
Success: you see a Hermes version instead of command not found.
5. Run first setup
hermes setup
# optional provider/model picker any time:
hermes model
Use the guided login/provider flow. Choose a browser/OAuth option when offered; use API keys only if you already understand where they are stored.
6. Confirm the config landed
hermes config path
hermes config check
hermes auth list
In plain English: this confirms Hermes knows where its config lives and whether a provider login/key is available.
7. Run one local chat before Telegram
mkdir -p ~/ai-agent-test
cd ~/ai-agent-test
printf "One safe test note\n" > test-note.txt
hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files."
# If that command is not available, open interactive Hermes:
hermes
Do not continue until you get a local reply based on the harmless test file.
8. Health check before adding channels
hermes doctor
hermes status
hermes tools list
Fix obvious missing dependencies/provider errors now. Do not add Telegram while local chat is failing.
9. Optional: connect Telegram gateway
hermes gateway setup
hermes gateway run
Paste your BotFather token and numeric Telegram user ID only into the local setup prompt. Keep this Terminal open for the first test. Stop with Ctrl + C.
10. Background service only after foreground works
Use hermes desktop or the installed Desktop app after command-line setup, local chat, and gateway foreground tests are healthy.
Hermes Agent on Windows — native first, WSL only if you choose it
In plain English: use the native Windows installer first. WSL Ubuntu is an optional Linux-style path for technical users, not the default. Docker is not part of this beginner setup.
1A. Easiest native option: use Hermes Desktop
Download and run the Hermes Desktop installer from the official Hermes Agent website. After it finishes, open PowerShell only if you want to verify the command-line tool.
1B. Native PowerShell CLI install
Start → PowerShell. Run as administrator only if Windows asks for installer permission.
Use the guided browser login/provider setup. Keep the workspace small and safe.
3. Run one local chat before Telegram
mkdir $HOME\ai-agent-test
cd $HOME\ai-agent-test
'one safe Windows test note' | Out-File test-note.txt -Encoding utf8
hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files."
# If needed, use interactive mode:
hermes
4. Check health and tools
hermes doctor
hermes status
hermes tools list
hermes config path
Do this before Telegram. If PowerShell says hermes is not recognised, close and reopen PowerShell.
5. Optional: connect Telegram gateway
hermes gateway setup
hermes gateway run
Use foreground gateway run first so you can see logs and stop with Ctrl + C.
Choose the guided provider/login flow. Do not manually install Python or Node unless the official installer says to.
4. Run one local chat before Telegram
mkdir -p ~/ai-agent-test
cd ~/ai-agent-test
printf "One safe Linux test note\n" > test-note.txt
hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files."
# If needed, use interactive mode:
hermes
5. Check health and tools
hermes doctor
hermes status
hermes tools list
hermes config path
Fix missing dependencies/provider config before adding Telegram.
6. Connect Telegram gateway only after local chat works
hermes gateway setup
hermes gateway run
7. Desktop/dashboard last
hermes desktop
Use hermes desktop or the Desktop app only after local chat and health checks work.
8. Optional background service after foreground works
hermes gateway install
hermes gateway start
hermes gateway status
OpenClaw on Mac — native local path
In plain English: use the official Mac/Linux shell installer. It installs OpenClaw locally and can start onboarding. Do not start with Docker.
1. Open Terminal
Command + Space → Terminal → Enter.
2. Check Node if you already have it
node --version
OpenClaw recommends Node 24. Node 22.19+ is also supported. If this command fails, use the installer anyway; it can handle Node setup.
Choose one Windows route: use the native PowerShell installer first. WSL Ubuntu is an optional fallback for people who specifically want Linux tooling. Docker is not the beginner path.
1A. Easiest Windows option
Use the official native OpenClaw Windows installer when available. Use PowerShell when you want the CLI/gateway directly.
1B. PowerShell installer
Start → PowerShell → right-click → Run as administrator only if Windows asks.
In plain English: install directly inside Ubuntu/Debian/WSL. Keep Docker out of the base path unless you are deliberately building an isolated advanced environment.
Choose a display name, for example Mike Test Agent.
Choose a username ending in bot, for example mike_test_agent_bot.
Copy the token into a private password note. The token is a password.
Open your new bot and press Start or send /start.
Get your numeric ID from @userinfobot or @get_id_bot. Never send those helper bots your token.
When Hermes/OpenClaw asks for allowed users, paste only your numeric Telegram ID.
If you accidentally share your token: emergency rotation
Open BotFather.
Select your bot.
Revoke/regenerate the token.
Update Hermes/OpenClaw gateway config.
Restart the gateway.
Step 4 — first safe tests
Test 1: can it reply?
Say hello in one sentence.
Test 2: can it explain itself?
Explain what you can do safely. Do not use tools yet.
Test 3: can it respect a folder boundary?
Look only inside my AI Agent Test folder. Tell me what files you see. Do not edit anything.
Permission message to reuse
Before using tools, show me a short plan. Do not delete files, send messages, spend money, or touch business/customer/private data.
Step 5 — troubleshooting by symptom
If Hermes still fails after setup: do not reinstall three times. Run hermes doctor, check the exact error, confirm the model/provider is configured with hermes model, and only then retry the smallest failing command.
What you see
Probably means
Try this
command not found
Terminal cannot find the app yet.
Close/reopen Terminal, run exec $SHELL -l, then check version.
permission denied
The command lacks permission or wrong folder.
Stop. Do not randomly add sudo. Re-read that step.
Gateway off, token wrong, bot not started, or user ID not allowed.
Send /start, check token/user ID, then run gateway foreground again.
Dashboard blank or useless
Dashboard opened before setup/gateway/doctor was healthy.
Go back to doctor/status checks. Dashboard is last.
Windows path feels broken
PowerShell route hit Windows-specific issues.
Use the WSL Ubuntu route in the selected panel.
OpenClaw complains about Node
Manual runtime mismatch.
Use the official installer, or update to Node 24 / at least Node 22.19+ before npm fallback.
Step 6 — how to stop safely
Foreground gateway: press Ctrl + C in the Terminal running it.
If Telegram feels wrong: stop gateway, remove bot from groups, rotate token in BotFather.
If unsure: stop. Do not connect customer data, payment tools, or public posting.
Step 7 — maintenance and dashboard reminder
Monthly health checkRun update/doctor/status, send one safe prompt, and check provider usage/cost.
hermes update
hermes doctor
# or
openclaw update
openclaw doctor
Dashboard/Web UI ruleOpen it only after install, model login, Telegram gateway, and doctor/status are healthy. Keep it local while learning: 127.0.0.1, not public internet.
AI Opportunity Intake - Business First
AI & Automation Opportunity Intake
A calm first step for business owners: understand the business first, then decide whether AI, automation, a better process, or a simple integration is the right fix.
Not here to force AI.If the right answer is a checklist, staff process, simple automation, or connecting two systems properly, that is the recommendation. AI only belongs where it clearly saves time, protects revenue, improves visibility, or reduces repeated admin.
Understand the business
→
Find friction
→
Map systems
→
Pick safe pilot
What this intake helps uncover
Time leaksRepeated admin, chasing, copying, writing, checking, and follow-ups.Revenue leaksSlow lead response, missed quotes, forgotten follow-ups, and old customers nobody re-engages.Visibility gapsNumbers, risks, customer issues, or overdue work only discovered too late.Agentic enablementSafe internal assistants that can draft, check, summarise, monitor, and connect tools with human approval.
FIRST SAFE PILOT MENU
Start small enough to prove value before anyone trusts it with customers, money, or operations.
After the intake, the recommendation should usually land in one of these lanes — or a simpler non-AI fix if that is what the business actually needs.
1. Workflow map onlyDocument the current handoff, owners, tools, missing evidence, and where time leaks. Best when the problem is unclear.
Output: plain-English map + safest first recommendation.
2. One handoff automationConnect one repeated step such as lead capture, reminders, quote follow-up, reporting, or inbox triage.
Output: measured time saved + rollback path.
3. Supervised AI assistantLet AI draft, summarise, check, or monitor — but keep approval gates before anything customer-facing or financial happens.
Output: assistant instructions + review checklist.
Proof before trust:owner namedsample data onlyhuman approval gatesuccess metricrollback plan
Contact
Send me the AI problem or messy workflow.
I am most useful where a person, team, or business wants to use AI better but needs help choosing the right tool, finding the right workflow, reducing repeated admin, or adding safe review gates before AI touches customers, money, or operations.
which tools, inboxes, CRM, files, or handoffs are involved
Good reasons to reach out
you need a workflow mapped before automation
you want dashboards, review gates, or clearer handoffs
your AI idea needs practical operator judgment
Not the right fit
no unsupervised customer messages
no spam, scraped outreach, or fake authority
no black-box systems without evidence or rollback
Next step: send the goal or workflow in plain English. I can usually spot the safest first AI use case from the repeated work, handoffs, risks, and tools involved.