Skip to content

itdove/devaiflow#344: Analysis session prompt includes command template that bypasses skill file learning#345

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

itdove/devaiflow#344: Analysis session prompt includes command template that bypasses skill file learning#345
itdove merged 1 commit intomainfrom
344

Conversation

@itdove
Copy link
Copy Markdown
Owner

@itdove itdove commented Mar 31, 2026

This PR does not need a corresponding Jira item.

Description

This PR fixes an issue where command templates in analysis session prompts were bypassing skill file learning. The command templates have been removed from the analysis session prompts in both git_new_command.py and jira_new_command.py to ensure proper skill file learning occurs.

The changes ensure that when users initiate analysis sessions through the devflow CLI, the system properly leverages skill file learning instead of relying on hardcoded command templates in the prompts.

Assisted-by: Claude

Testing

Steps to test

  1. Pull down the PR
  2. Run the test suite to verify the changes: pytest tests/test_jira_new_command.py
  3. Execute devflow jira new command to create a new JIRA-based session
  4. Verify that the analysis session prompt does not include hardcoded command templates
  5. Execute devflow git new command to create a new git-based session
  6. Verify that the analysis session prompt does not include hardcoded command templates
  7. Confirm that skill file learning functions correctly without the command templates

Scenarios tested

  • Created new JIRA-based analysis sessions and verified prompts exclude command templates
  • Created new git-based analysis sessions and verified prompts exclude command templates
  • Ran updated test suite to ensure no regressions

Deployment considerations

  • This code change is ready for deployment on its own
  • This code change requires the following considerations before being deployed:

Remove command templates from daf jira new and daf git new prompts
that were bypassing skill file learning. Templates created cognitive
shortcuts that discouraged AI agents from reading comprehensive skill
documentation, leading to improper command usage.

Changes:
- Replaced explicit command templates with instructions to read skill files
- Updated both single-project and multi-project prompt builders
- Modified test to verify new instruction format
- Verified skill files contain sufficient examples (they do)

Benefits:
- AI agents learn tools properly from authoritative skill documentation
- Skill files remain single source of truth
- No risk of templates becoming outdated
- Better understanding of command nuances and options

Fixes #344

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@itdove itdove marked this pull request as ready for review March 31, 2026 16:01
@itdove itdove merged commit d94c8e3 into main Mar 31, 2026
7 checks passed
@itdove itdove deleted the 344 branch March 31, 2026 16:01
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