General #
Q: Why are the generated dates sometimes on weekends? A: The AI is instructed to only use weekdays (Monday-Friday) for all start and end dates. However, on rare occasions, it might make a mistake. The application includes a programmatic check that attempts to automatically shift any generated weekend dates to the next available weekday to ensure compliance.
Q: Can I edit the priority, estimate, or dates of an item? A: Currently, the UI only supports editing the text-based fields (title, description, acceptance criteria). The other fields are determined during the initial project generation. To change these, you would need to adjust your initial prompt and regenerate the project.
Diagrams #
Q: My diagram failed to render and shows an error image. What should I do? A: This usually means the AI generated invalid PlantUML syntax.
- Expand the “View/Edit PlantUML Code” section in the Diagram Workbench.
- Look for syntax errors. Common issues include missing semicolons, unbalanced brackets, or incorrect keywords.
- Try to fix the error in the code editor. The preview will update live as you make changes.
- If you can’t fix it, try generating the diagram again. Sometimes the AI produces a better result on the second try.
Jira Integration #
Q: I’m getting a 401 Unauthorized or “No accessible Jira sites found” error when I test my token. A: This is almost always an issue with the API token.
- Incorrect Token: Ensure you have copied the entire token correctly.
- Expired Token: API tokens can be revoked. You may need to generate a new one in your Atlassian account settings.
- Permissions: The user account associated with the token must have permissions to view and edit the project you are trying to access.
- VPN/Firewall: Ensure your network connection isn’t blocking access to the Atlassian API.
Q: The Jira Sync/Import is very slow or seems to be stuck. A: For projects with many issues, the process can take several minutes. The app has to make many individual API requests to Jira, which is rate-limited. Please be patient. The log window in the modal provides real-time feedback on the current operation.
Q: Why did the Jira import create an “Other Stories (Not in an Epic)” epic? A: The app reconstructs the hierarchy based on the links between your Jira issues. If you have Stories in your Jira project that are not linked to an Epic (either via the “Epic Link” field in classic projects or as a direct child in team-managed projects), they will be grouped into this placeholder epic for organization.