Introduction
Welcome to AI Workflows! This site is a curated resource for developers setting up local AI development workflows, sharing learnings, and documenting best practices.
Here you will find step-by-step guides, shell configurations, and tool recommendations to make your AI-assisted coding experience fast, seamless, and powerful.
Key Sections
- Getting Started: Setup your macOS or Linux machine with Homebrew, Python,
uv, andheadroom-ai. - AI Curriculum: Master the principles of agent steering and context engineering.
- AI Workflows & Shape & Ship: The core methodology of collaborating with coding agents.
- Using AI Skills: Understanding how agents consume context-specific instruction files.
- Creating AI Skills: A guide to authoring your own custom
SKILL.mddocuments. - Secure Remote Agents: Setting up Tailscale, Hermes WebUI, and Claude Code for safe remote access.
- Using the Claude API: Leveraging the Messages API, Prompt Caching, XML tags, and Tool Use in custom workflows.
- Workflows & Guides: Detailed walkthroughs of custom agent configurations and integrations. (Coming soon!)
Target Platforms
For now, our setup guides and workflows focus on:
- macOS
- Linux
We plan to expand support to Windows in the near future.