בס״ד

Hook Street AI Automation + Skills Playbook

docs/HOW_TO/hookstreet-ai-automation-playbook.md · last changed (pre-VM history) · rendered from GitHub master

Hook Street AI Automation + Skills Playbook

Purpose: decide what Claude Code, Codex, Claude.ai skills, plugins, Apps Script, Gmail, Sheets, GitHub, and outputs/ should each do for Sam.

The Split

Use this rule:

Layer What it is for Examples
Skills Teach the AI how Sam's world works STR ops, obligations audit, Eden, MIS, session operator
Codex cron automations Wake up without Sam opening a session and inspect workspace state morning scan, evening git/deploy check, weekly stale-loop audit
Apps Script triggers Touch Google Workspace live on a schedule voice intake, Gmail draft scanner, BOS emails, morning brief
iOS Shortcuts Fast capture from phone ACTION Shellpoint check portal tomorrow
outputs/ portal Human-readable memory bridge briefings, handoffs, command centers
GitHub Durable code/history/issues commits, PRs, issue comments, deploy trigger

Do not make Claude/Codex "remember everything." Make it read the right small files and follow the same operating loop.

Skills Sam Should Use

Already in hookstreet-skills/:

Skill Use when
braindump-router Sam dictates messy multi-topic voice dumps from car/phone
str-ops-davenport 9312/9332 Davenport, Airbnb, HOA, cleaners, smart locks, Shellpoint/Selene
obligations-audit Autopay, card routing, installments, mortgage due dates, utilization
mis-daily-report Trading report, MIS email, P&L, Schwab/Fidelity, FSE
eden-gardens-status Eden Gardens, Steinhardts, Invoice #20028, VIP Commercial
hookstreet-session-operator Session open/close, broad triage, handoff, commit/push, ops portal, automation planning

Recommended next skills to add later:

Skill Why
mildred-ops-briefing Draft and QA Mildred-safe updates without leaking personal finance/legal/MIS
ops-portal-publisher Rebuild outputs/index.html, commit, push, verify deploy
start-here-action-spine Turn raw captures into proof-required action cards
gmail-draft-triage Deduplicate and summarize Sam's draft queue

Plugins / Connectors Sam Should Prefer

Work Use
GitHub issues/PRs/commits GitHub plugin + local git
Gmail drafts/inbox Gmail plugin
Google Sheets / Drive files Google Drive plugin
Local .xlsx work Spreadsheets plugin
Calendar briefs / scheduling Google Calendar plugin
Browser/PWA/portal visual checks Browser plugin
Deploy/site config Netlify plugin only when the site actually uses Netlify

Important: plugins are not the memory. Docs + skills are the memory. Plugins are the hands.

Codex Automations To Use

These should be workspace-only, read-heavy, and safe. They should not send emails, edit sheets, place trades, or push code unless Sam explicitly approves that specific automation later.

Active Codex automations created 2026-05-19:

Automation ID Schedule Purpose
hook-street-morning-workspace-scan Weekdays 7:35 AM ET Morning operational scan and first Claude Code prompt
hook-street-evening-git-deploy-check Weekdays 5:05 PM ET Git/deploy/index status check
hook-street-sunday-loop-audit Sundays 9:30 AM ET Weekly stale-loop closure audit

1. Weekday Morning Workspace Scan

Time: weekdays around 7:35 AM ET.

Purpose:

Output:

2. Evening Git + Deploy Check

Time: weekdays around 5:05 PM ET.

Purpose:

Output:

3. Sunday Loop Audit

Time: Sunday around 9:30 AM ET.

Purpose:

Output:

Google Workspace Automations To Use

These belong in Apps Script because they touch Gmail/Sheets live.

Automation Existing source Status / next action
Voice intake hookstreet-voice-intake/ Deploy v0.1 only after API key + triggers + dry run
Draft scanner docs/scripts-pending/dailyDraftScanner.js Good candidate for daily scan, but deploy only after Gmail label/recipient behavior is reviewed
Proactive morning brief docs/daily-cadence-system/PROACTIVE_MORNING_BRIEF_SPEC.md Build manually first, then Apps Script trigger
Start Here action intake START_HERE_EXECUTION_LAYER_CLAUDE_CODE_MASTER.md Rotate exposed token before any webhook production use
BOS reports HookStreet-Business-OS/sheets Keep trigger changes proof-gated by docs/TRIGGER_REGISTRY.md

What Not To Automate

Never fully automate these without a human approval gate:

The right pattern is: automation drafts or flags; Sam approves; then a controlled write happens.

How A Normal Day Should Work

  1. Codex morning scan runs without Sam opening a session.
  2. Sam reads the short result on phone/iPad.
  3. If action is needed, Sam opens Claude Code and says: "Use the morning scan and run the first recommended session."
  4. Claude Code uses hookstreet-session-operator.
  5. Work produces one of:
    - live sheet readback/write
    - code change + tests
    - outputs/ handoff
    - GitHub issue/PR comment
  6. Session closes with commit/push status and next prompt.

Install / Update Flow For Skills

In hookstreet-skills/:

./build.sh
git add .
git commit -m "skills: update Hook Street AI operator skills"
git push

Then upload the relevant .skill files from hookstreet-skills/dist/ to Claude.ai.

For Claude Code, copy/symlink the skill folders into the local Claude Code skills directory or keep using this repo as the source of truth and paste the needed SKILL.md during setup.

Default Prompt For Claude Code

Use the Hook Street session-operator skill.

Read CLAUDE.md, docs/CURRENT_STATE.md, docs/CONTEXT.md top status, docs/SCOPE_BACKLOG.md, and the newest relevant outputs handoff.

Do not create a broad plan. Tell me:
1. what is already done,
2. what is stale or risky,
3. the next 1-3 actions,
4. what you can execute now without asking.
Then execute the safest high-leverage item and leave a clean handoff.

Default Prompt For Codex Automation

Inspect the Hook Street workspace. Do not modify files, send emails, edit sheets, or push code.

Read the root status docs and newest outputs. Check git status in the root repo and key nested repos. Return a concise operational scan: urgent blockers, stale handoffs, unpushed changes, deploy/index status, and the best next prompt for Claude Code.

Immediate Recommendation

Start with four things only:

  1. Install/upload hookstreet-session-operator.
  2. Turn on Codex morning scan + evening git/deploy check.
  3. Keep Apps Script automations proof-gated: voice intake, morning brief, draft scanner.
  4. Build Start Here v0.1 manually before making it a webhook.

The point is not more automation. The point is fewer dropped loops.

Source trail · docs/HOW_TO/hookstreet-ai-automation-playbook.md @ master · rendered 2026-07-02 7:23 PM EDT by scripts/build-docs.py · the .md in the repo is the truth; this page is the phone-readable view