Skip to content

itdove/devaiflow#348: Improve daf-jira and daf-jira-mcp skills based on MCP integration learnings#349

Merged
itdove merged 1 commit intomainfrom
348
Mar 31, 2026
Merged

itdove/devaiflow#348: Improve daf-jira and daf-jira-mcp skills based on MCP integration learnings#349
itdove merged 1 commit intomainfrom
348

Conversation

@itdove
Copy link
Copy Markdown
Owner

@itdove itdove commented Mar 31, 2026

Related GitHub Issue: #348

Description

This PR improves the documentation for JIRA integration skills by clarifying field format requirements for JIRA MCP tools. Based on learnings from MCP integration work, the documentation updates provide clearer guidance on proper field formatting when using the daf-jira and daf-jira-mcp skills.

The changes update SKILL.md files in both the daf-jira and daf-jira-mcp skill directories to help users avoid common formatting issues when interacting with JIRA through the MCP server.

Assisted-by: Claude

Testing

Steps to test

  1. Pull down the PR
  2. Review the updated documentation in devflow/cli_skills/daf-jira-mcp/SKILL.md
  3. Review the updated documentation in devflow/cli_skills/daf-jira/SKILL.md
  4. Verify that field format requirements are clearly documented and understandable
  5. Optionally, test the documented field formats with actual JIRA MCP operations to confirm accuracy

Scenarios tested

  • Reviewed documentation changes for clarity and technical accuracy
  • Verified formatting improvements align with MCP integration requirements

Deployment considerations

  • This code change is ready for deployment on its own

- Add section on ADF vs Wiki markup format requirements for MCP tools
- Document that daf commands handle format conversion automatically
- Include ADF JSON format example and known MCP limitations
- Update recommendations to prefer daf commands for rich text fields

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@itdove itdove marked this pull request as ready for review March 31, 2026 17:01
@itdove itdove merged commit 91adbd1 into main Mar 31, 2026
7 checks passed
@itdove itdove deleted the 348 branch March 31, 2026 17:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant