autonomous-skill

The autonomous-skill is a robust framework designed to manage complex, multi-session engineering tasks within the Codex CLI ecosystem. It facilitates long-running projects by implementing a dual-agent pattern consisting of an Initializer and an Executor. The Initializer analyzes project requirements to generate a structured task_list.md, while the Executor performs iterative work, maintaining persistent state via .autonomous/ tracking directories. This skill is ideal for software engineers, developers, and DevOps practitioners dealing with multi-day refactors, large-scale feature implementation, or ongoing system maintenance that exceeds the scope of a single conversational session.

• Dual-agent architecture separates high-level task planning from iterative implementation phases.

• Persistent state management via .autonomous/ directories ensures session-to-session continuity, preventing context loss during long-running tasks.

• Automatic task checklist generation enables systematic progress tracking and granular completion reporting.

• Non-interactive session support allows Codex to process tasks autonomously, with built-in hooks for session resumption using session IDs.

• Configurable runtime parameters through run-session.sh, including flags for task naming, parallel execution management, and network-isolated sandbox environments.

• Use this skill when a task is too large for a single Codex turn, such as major refactoring, building multi-endpoint REST APIs, or system migrations.

• Maintain task integrity by periodically verifying work against task_list.md and updating progress.md after each successful session.

• Ensure the environment is set up for long-term tracking by initializing tasks with clear, actionable descriptions to aid the Initializer agent in decomposition.

• Leverage the --continue and --resume-last flags to reconnect with interrupted workflows or build upon established progress in existing project root directories.

• Be aware that this skill requires shell access and creates persistent artifacts; clear these periodically to prevent workspace clutter if many temporary tasks are generated.