.claude

.agents is a markdown-based configuration system for AI coding assistants like Claude Code that automates common development tasks. It includes 11 workflow commands for GitHub integration (creating issues, pull requests, releases), 4 domain-specific skills for code review and feature planning, and 5 coding convention rules to maintain team standards. The system integrates directly with your AI tool through symlinks or file copying, enabling tasks like picking up issues with full context, auto-formatting code, generating commit messages, and creating release PRs. Teams use it to reduce manual context switching, enforce consistent coding practices, and accelerate development velocity across AI-assisted workflows.

[{"step":"Define the task to automate","action":"Write a clear, specific description of the task you want to automate (e.g., 'Generate a weekly sales report from Shopify and Google Analytics'). Include any data sources, tools, or outputs required.","tip":"Use bullet points to list requirements. For example: 'Data sources: Shopify API, Google Analytics; Output: Markdown report saved to /reports/; Tools: claude run, Python scripts'."},{"step":"Set up the workflow","action":"Create or modify a `.claude` workflow file (e.g., `weekly_report.yml`) in your project directory. Define the steps, tools, and dependencies. Example:\n```yaml\nname: weekly_performance_report\nsteps:\n - name: fetch_data\n command: python scripts/fetch_analytics.py\n - name: generate_report\n command: python scripts/generate_report.py\n - name: notify_team\n command: python scripts/send_slack_notification.py\n```","tip":"Test each step individually before chaining them together. Use `claude run --dry-run` to preview the workflow without executing it."},{"step":"Execute the workflow","action":"Run the workflow using the command `claude run [WORKFLOW_NAME]`. Monitor the output for errors or warnings. For example: `claude run weekly_performance_report`.","tip":"Use the `--verbose` flag to get detailed logs if the workflow fails. Example: `claude run weekly_performance_report --verbose`."},{"step":"Review and iterate","action":"Check the outputs and logs. If errors occur, debug the workflow by running individual steps manually. Update the workflow file to fix issues and re-run.","tip":"Save successful workflows to a shared directory (e.g., `/workflows/`) so your team can reuse them. Document any dependencies or prerequisites in a README file."},{"step":"Schedule recurring runs (optional)","action":"Use a cron job or CI/CD pipeline to schedule the workflow to run automatically. For example, add this to your `crontab`:\n```\n0 9 * * 1 /usr/local/bin/claude run weekly_performance_report\n```\nThis runs the report every Monday at 9 AM.","tip":"Use `claude run --help` to explore additional options like scheduling, parallel execution, or conditional steps."}]