Remove all references to deprecated DAF_AGENTS.md

[itdove]

Background

DAF_AGENTS.md was removed in favor of the daf-workflow skill (see CHANGELOG.md #263), but many references to it remain in the codebase. These outdated references are confusing to users and need to be cleaned up.

Files with References

Based on grep search for "DAF_AGENTS", the following files contain references:

Documentation Files

1. CLAUDE.md (line 5)

   • References DAF_AGENTS.md for daf tool usage instructions
   • Should reference daf-workflow skill instead

2. README.md (line 553)

   • Step 5 mentions copying DAF_AGENTS.md
   • Should be removed or updated

3. AGENTS.md (multiple locations)

   • Line 7: References DAF_AGENTS.md for JIRA operations
   • Lines 214-229: Entire section about DAF_AGENTS.md
   • Lines 1529-1537: Completed enhancements mentioning DAF_AGENTS.md features
   • Should reference daf-workflow skill instead

4. docs/getting-started/installation.md (lines 730-949)

   • Entire section "Setting Up DAF_AGENTS.md (Required)"
   • Multiple subsections about placement, discovery, upgrades, customization
   • Should be completely removed or rewritten for daf-workflow skill

5. docs/reference/configuration.md (line 1324)

   • Lists DAF_AGENTS.md as a context file
   • Should be removed

6. devflow/cli_skills/daf-jira-fields/SKILL.md (line 277)

   • "See Also" section references DAF_AGENTS.md
   • Should reference daf-workflow skill instead

Code Files

7. devflow/utils/daf_agents_validation.py (entire file)
   • Dedicated module for validating/upgrading DAF_AGENTS.md
   • Contains migration logic to offer deletion of old files
   • Should be reviewed: keep migration logic or remove entirely?

Changelog (Keep as-is)

8. CHANGELOG.md (lines 50-60)
   • Documents the breaking change that removed DAF_AGENTS.md
   • These entries should remain as historical record

Acceptance Criteria

• CLAUDE.md updated to reference daf-workflow skill instead of DAF_AGENTS.md
• README.md step 5 removed or updated
• AGENTS.md references to DAF_AGENTS.md replaced with daf-workflow skill
• docs/getting-started/installation.md section removed or rewritten
• docs/reference/configuration.md reference removed
• devflow/cli_skills/daf-jira-fields/SKILL.md updated to reference daf-workflow skill
• devflow/utils/daf_agents_validation.py reviewed and either kept (for migration) or removed
• All grep searches for "DAF_AGENTS" return only CHANGELOG.md entries
• Documentation is consistent about using daf-workflow skill for workflow guidance

Migration Strategy

Decision needed: Should we keep devflow/utils/daf_agents_validation.py for backward compatibility?

Option 1 - Keep migration logic:

• Helps users who still have old DAF_AGENTS.md files
• Offers to delete them when sessions are opened
• Provides smooth transition

Option 2 - Remove completely:

• Clean break, no legacy code
• Users manually delete old DAF_AGENTS.md files
• Simpler codebase

Implementation Notes

Replace all references with guidance to use:

• daf-workflow skill for workflow guidance
• AGENTS.md for project-specific instructions
• CLAUDE.md for project guidelines
• ORGANIZATION.md for JIRA templates (organization-specific)

Testing

• Search codebase for all variations: DAF_AGENTS, daf_agents, daf-agents
• Verify documentation builds successfully
• Check that session initialization prompts don't reference DAF_AGENTS.md
• Ensure skills don't reference DAF_AGENTS.md in "See Also" sections

[itdove]

✅ Session Complete

Project: devaiflow
Goal: Create GitHub/GitLab bug: I will give you the instructions during the session
Time Spent:
0h 9m total

• dvernier: 0h 9m
• unknown: 0h 0m
  Branch: main

No significant activity detected in this session.

Generated by DevAIFlow

[itdove]

Pull request created: #353

[itdove]

✅ Session Complete

Project: devaiflow
Goal: #350: Remove all references to deprecated DAF_AGENTS.md
Time Spent:
0h 12m total

• dvernier: 0h 12m
• unknown: 0h 0m
  Branch: 350

Summary

I've successfully removed all references to the deprecated DAF_AGENTS.md file from the DevAIFlow codebase. Here's what was done:

Files Updated

1. CLAUDE.md - Updated to reference daf-workflow skill instead of DAF_AGENTS.md
2. README.md - Removed step 5 about copying DAF_AGENTS.md
3. AGENTS.md - Replaced all DAF_AGENTS.md references with daf-workflow skill, updated historical notes
4. docs/getting-started/installation.md - Removed entire "Setting Up DAF_AGENTS.md (Required)" section (lines 730-954)
5. docs/reference/configuration.md - Removed DAF_AGENTS.md from default context files list
6. devflow/cli_skills/daf-jira-fields/SKILL.md - Updated "See Also" section to reference daf-workflow skill and ORGANIZATION.md
7. devflow/utils/daf_agents_validation.py - Updated module docstring to clarify it's for migration purposes only
8. docs/context-templates/README.md - Removed DAF_AGENTS.md references (2 locations)
9. docs/context-templates/JIRA.md - Updated to reference daf-workflow skill and ORGANIZATION.md
10. devflow/cli/commands/new_command.py - Removed DAF_AGENTS.md from docstring example
11. docs/developer/publishing-to-pypi.md - Updated package verification examples to reference skills instead of DAF_AGENTS.md

Migration Strategy Decision

KEPT devflow/utils/daf_agents_validation.py for backward compatibility:

• Helps users transition from DAF_AGENTS.md to daf-workflow skill
• Offers to delete old DAF_AGENTS.md files when found
• Already handles the case where bundled file doesn't exist (migration-ready)
• Provides smooth transition path for existing users

Test Results

✅ All 3629 tests pass (65 skipped)

• Migration tests continue to work correctly
• Tests already marked as skipped for deprecated functionality remain skipped
• No breaking changes to existing functionality

Files Left Unchanged (As Intended)

• CHANGELOG.md - Historical record of the deprecation (kept for documentation)
• Test files - Many already marked with @pytest.mark.skip for deprecated tests
• Migration logic - daf_agents_validation.py retained for smooth user transition

All documentation now consistently points users to the daf-workflow skill for workflow guidance, with references to ORGANIZATION.md for JIRA templates and organization standards.

Generated by DevAIFlow