claude-code-headless-operations

What problem does it solve?

This skill provides a unified playbook to operate Claude Code inside non-interactive shells, CI pipelines, and dynamic git workspaces, addressing timeouts, workspace trust prompts, and deadlock issues that can stall automated workflows.

Core Features & Use Cases

• Supports extending the first-event timeout in Claude Code sessions invoked by orchestrators.
• Suppresses non-interactive warnings and ensures workflows can proceed in headless environments.
• Encourages running Claude Code from outside its own session and implementing a trust-based golden path for workspaces.
• Defines a rigorous clean-environment protocol to recover from failed runs and maintain reproducible results.
• Provides a structured playbook for Archon-like tools to orchestrate Claude Code safely in CI.

Quick Start

Run archon workflow with headless Claude Code by setting a longer timeout and trusting the workspace, then execute the workflow in a non-interactive shell.