devaiflow AGENTS.md

Agent Instructions for DevAIFlow

General Instructions

IMPORTANT: The following general instructions apply to the DevAIFlow project and MUST be followed when contributing to this codebase.

For JIRA operations: This project uses the daf tool for issue tracker integration. Always use daf jira commands (documented in the daf-workflow skill), NOT direct API calls.

Skills Documentation: The skills (CLI command documentation) are located in the devflow/cli_skills/ directory in the repository.

For comprehensive skills management documentation (discovery order, precedence rules, best practices), see docs/guides/skills-management.md.

⚠️ CRITICAL - Common Mistake to Avoid:

• ✅ CORRECT: Update files in devflow/cli_skills/daf-*/SKILL.md (repository files that get committed)
• ❌ WRONG: Do NOT update files in ~/.claude/skills/daf-*/SKILL.md (user's local cache, will be overwritten)

When updating command functionality or documentation, remember to update the corresponding SKILL.md file in the appropriate skill directory within the repository (devflow/cli_skills/).

---

Git Workflow

IMPORTANT: Never commit directly to the main branch. Always create a feature branch before making any commits.

Creating Branches and Pull Requests

1. Update main branch before creating a new branch:

   git checkout main
   git pull origin main
   

   IMPORTANT: Always ensure your main branch is up-to-date before creating a new feature branch.

2. Create a branch from the updated main branch:

   git checkout -b <ISSUE-KEY>-<short-description>
   

   Example: git checkout -b proj-12345-fix-validation

3. Make your changes and commit them to the branch

4. Push the branch to remote:

   git push -u origin <branch-name>
   

5. Create a draft PR using auto-discovered PR templates (organization .github repo first, then repository .github/ directory, then user-configured URL, then default template) using gh CLI