Connor Griffin ConnorGriffin

Narration contract for agent sessions

Drop this into CLAUDE.md / AGENTS.md, or into a skill that wraps a long-running workflow. It governs how much the agent says while it works — not what it builds.

The failure mode it fixes: an agent that silently runs twenty tools and then emits a wall of summary. The reader can't tell what it checked, can't interrupt a wrong turn, and has to take the conclusion on faith.

Every rule below is written so the agent can check itself against it, rather than

Narration contract for agent sessions

Drop this into CLAUDE.md / AGENTS.md, or into a skill that wraps a long-running workflow. It governs how much the agent says while it works — not what it builds.

The failure mode it fixes: an agent that silently runs twenty tools and then emits a wall of summary. The reader can't tell what it checked, can't interrupt a wrong turn, and has to take the conclusion on faith.

CIQ Autotune PR 358 screenshot evidence

Seeded test data only; no personal health information.

	blueprint:
	name: "ConnorGriffin's Light Switch Double Taps"
	description: >
	Supports GE/Jasco Basic CC (32) and UltraPro ZW3010 Central Scene (91).
	Double-tap UP toggles Max ↔ Auto.
	Double-tap DOWN toggles Min ↔ Auto.
	domain: automation

	input:
	device:

	from datetime import datetime, timedelta
	import matplotlib.pyplot as plt

	def brightness_at_time(t, sunrise, sunset,
	pre_sunrise=120, morning_ramp=90,
	pre_sunset=60, evening_ramp=240,
	min_brightness=20, max_brightness=100):
	# Adjusted ramp times
	ramp_up_start = sunrise - timedelta(minutes=pre_sunrise)
	ramp_up_end = ramp_up_start + timedelta(minutes=morning_ramp)

	blueprint:
	name: "ConnorGriffin's Light Modes"
	description: "Controls light brightness at Off->On based on a configurable curve, as well as min/max bright modes based. Requires a dropdown (input-select) helper with modes: Auto, Min, Max."
	domain: automation
	input:
	light:
	name: Light
	description: The light to control
	selector:
	entity:

	function updateYnabHomeZestimate() {
	var accessToken = 'YNAB token goes here' // Your YNAB Personal Access Token
	var zwsid = 'zwsid goes here' // Your Zillow ZWSID
	var budgetName = 'budget name goes here' // The name of your budget
	var accountName = 'home value account name goes here' // The name of your home value tracking account
	var address = '1657 Notrealaddress Drive, Redding, CA 96001' // Home address

	// YNAB API settings
	var url = 'https://api.youneedabudget.com/v1'
	var headers = {

	// YNAB Weekly Spending Report sending script
	function sendYnabReport() {
	// Set our options
	var accessToken = 'token goes here' // Your YNAB Personal Access Token
	var budgetName = "Connor's Budget" // Budget name to use, in case you have multiple budgets
	var categories = ['Sports & Wellness', 'Food & Drink', 'Housing'] // Your desired category groups to monitor, in Javascript array syntax
	var recipient = 'test@example.com, test2@example.com' // Email recipients, comma separated

	// API stuff
	var url = 'https://api.youneedabudget.com/v1'