kiritoxkiriko/my-agent-workflow

What does my-agent-workflow do?

Cross-platform personal AI Coding Agent workflow: one AGENTS.md rule + a set of Codex Skills to unify your Codex CLI / Claude Code / OpenCode behavior.

Overview

This repository provides a unified personal workflow for AI coding agents. It contains:

• A single AGENTS.md file that defines global rules, preferences, and constraints for your agent.
• Multiple Codex Skills that encapsulate reusable instructions and tool configurations.

Supported Platforms

• Codex CLI – Uses AGENTS.md as the primary rule file; Skills are loaded via Codex's skill system.
• Claude Code – Reads AGENTS.md as a project-level instruction file; Skills can be triggered via claude.md integration.
• OpenCode – Compatible with the AGENTS.md specification; Skills work through OpenCode's plugin mechanism.

Getting Started

1. Clone this repository or copy the contents into your project root.
2. Ensure your AI coding agent (Codex CLI, Claude Code, or OpenCode) is configured to load the AGENTS.md file.
3. (Optional) Import the Codex Skills into your agent's skill directory.
4. Start a new session – the agent will automatically follow the rules and use the available skills.

Structure

• AGENTS.md – Main rule file with personal preferences, code style, and behavioral instructions.
• skills/ – Directory containing individual Codex Skill markdown files (e.g., code-review.md, scaffold.md, debug.md).

Usage Notes

• Customize AGENTS.md to match your coding style, project conventions, and tool preferences.
• Skills are designed to be composable – load only the ones you need for a given task.
• When using with Claude Code, you may need to reference AGENTS.md explicitly via a CLAUDE.md symlink or copy.

Examples

• AGENTS.md includes rules for commit message format, test coverage expectations, and preferred libraries.
• Codex Skills include prompts for generating unit tests, refactoring code, and writing documentation.