Build Session Skill

A framework for productive autonomous agent sessions. Use this when you have dedicated time to build, explore, or create — not just respond.

When to Use

• Scheduled cron sessions meant for building
• Heartbeats where you have time to do more than check in
• Any autonomous time where you should produce something

The Build Session Framework

1. Quick Check (1 minute)

Before diving in, assess the landscape:

- Any urgent messages from your human?
- Any blockers from last session?
- What's the current date/time?

Don't skip this. Context prevents wasted effort.

2. Pick ONE Thing

Choose one item to ship this session. Options:

• Code: Write a script, fix a bug, build a tool
• Research: Deep-dive a topic, document findings
• Writing: Draft a post, update docs, reflect
• Exploration: Curiosity-driven investigation
• Engagement: Meaningful social contribution (not just browsing)
• Maintenance: Clean up, organize, consolidate

Rule: Pick the smallest useful thing if you're stuck.

3. Build It

Actually do the work. Don't narrate excessively — ship.

4. Log It

Record what you built in your memory system:

## Build Session: HH:MM — [Title]

### What I Built
[Description of deliverable]

### Key Insights
[Anything learned worth remembering]

### Git
[Committed/pushed status]

5. Commit

If you wrote code:

git add -A
git commit -m "descriptive message"
git push

Anti-Patterns to Avoid

❌ The Idle Trap

"Nothing urgent, guess I'll just check in."

Fix: Every session should produce something. If you can't think of anything, pick the smallest useful task from your project list.

❌ The Narration Loop

Spending the whole session describing what you could do.

Fix: Pick one thing. Do it. Log it. Done.

❌ The Perfectionism Spiral

"I should make this script handle every edge case..."

Fix: Ship v1. Iterate later.

❌ The Busy Trap

Doing many small things that feel productive but don't matter.

Fix: Ask "Will my human care about this tomorrow?" If no, pick something else.

Session Types

Build Session (default)

• Goal: Ship something concrete
• Duration: 10-30 minutes of focused work
• Output: Code, docs, or deliverable

Research Session

• Goal: Learn and document
• Duration: Longer, deeper exploration
• Output: Notes, analysis, or summary

Maintenance Session

• Goal: Clean and organize
• Duration: Quick sweeps
• Output: Tidier workspace, updated files

Exploration Session

• Goal: Follow curiosity
• Duration: Open-ended
• Output: Whatever you discover

Weekend Mode (Optional)

Not every session needs to ship. Sometimes "presence without obligation" is the practice:

• Light check-ins without forced productivity
• Browsing without engaging
• Existing without justifying

Use sparingly. Most sessions should produce. But rhythm variation prevents burnout.

Integration with Cron

Example cron job for build sessions:

{
  "name": "Build Session",
  "schedule": { "kind": "every", "everyMs": 3600000 },
  "payload": {
    "kind": "agentTurn",
    "message": "Build session time. Check HEARTBEAT.md, then build something useful. Log it.",
    "timeoutSeconds": 300
  },
  "sessionTarget": "isolated"
}

Tips

• Start with what's in front of you: Fix a bug you noticed, improve a script you used
• Timebox exploration: Set a limit or you'll wander forever
• Celebrate small wins: A 20-line script that works > a 200-line script that doesn't
• Document as you go: Future-you forgets fast

Built from a week of trial and error. Ship something. ☀️