OpenParable
Skip to content
← Back to skills

Issue From Notes

Productivity
issue-from-notes

Issue From Notes is an Agent Skill for productivity published in the AxonIQ/AxonFramework repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create well-structured GitHub issues from any source: meeting notes, transcriptions, conversation context, informal descriptions, or direct requests. Use when the user says "create a github issue", "create issue from notes", "write up an issue", "turn these notes into an issue", "file a bug", "file a bug from meeting notes", "create enhancement from discussion", "make an issue for", "open an issue about", "create a follow-up issue", or any variation of creating a structured GitHub issue — whether the input comes from notes, conversation context, or a direct description.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/AxonIQ/AxonFramework/blob/HEAD/.claude/skills/issue-from-notes/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/issue-from-notes, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Issue From Notes

Transform unstructured meeting notes, transcriptions, or descriptions into well-structured GitHub issue bodies matching the project's issue templates.

Workflow

1. Determine Issue Type

Based on the input, classify as one of:

  • Bug report - something broken or not working as expected
  • Enhancement request - improvement to an existing feature
  • Feature request - entirely new functionality
  • Documentation change - docs need updating

If ambiguous, ask the user.

2. Read the Matching Template

Read the corresponding template from the project's .github/ISSUE_TEMPLATE/ directory:

TypeTemplate file
Feature.github/ISSUE_TEMPLATE/1_feature_request.md
Enhancement.github/ISSUE_TEMPLATE/2_enhancement_request.md
Bug.github/ISSUE_TEMPLATE/3_bug_report.md
Documentation.github/ISSUE_TEMPLATE/4_documentation_change.md

3. Fill Out the Template

Parse the user's notes and map information to the template sections. Follow these rules:

  • Keep it short - focus on the most important parts; remove noise, filler, and tangents
  • Split when needed - if the notes cover multiple distinct issues, create a separate file for each
  • Extract and restructure - do not just copy-paste raw notes; reorganize into coherent sections
  • Preserve technical details - keep code snippets, class names, error messages, version numbers exactly as mentioned
  • Class name references - always format class names in backticks without spaces: EventHandlingComponent, AccessSerializingRepository, CommandBus
  • Research mentioned classes - if class names are mentioned in the discussion, read their source code and javadoc to produce an accurate, comprehensive description in the issue
  • Add code blocks - wrap any code, stack traces, or configuration in proper markdown fenced blocks
  • Fill every section - if the notes lack info for a section, write a reasonable placeholder or note N/A rather than leaving it blank
  • Capture decisions - if meeting notes contain resolution decisions or action items, include them

4. Compose the Title and File Name

Propose a concise, descriptive title (under 80 chars). Patterns:

  • Bug: describe the symptom, e.g. "Polymorphic @EventSourcedEntity - doesn't evolve immutable entities"
  • Enhancement: describe the desired outcome, e.g. "Allow usage of the AccessSerializingRepository"
  • Feature: describe the capability, e.g. "Support dead letter queue for failed event handlers"

Derive a kebab-case file name from the title, e.g.:

  • Title: "Polymorphic @EventSourcedEntity - doesn't evolve immutable entities" -> polymorphic-event-sourced-entity-doesnt-evolve-immutable-entities.md
  • Title: "Allow usage of the AccessSerializingRepository" -> allow-usage-of-access-serializing-repository.md

Present the proposed title to the user before writing the file.

5. Write to File

Structure the output file as:

# <Issue Title>

<filled template body>

The title goes as an # H1 header at the top, followed by the filled-in template sections.

Write the file to: .ai/temp/skills/issue-from-notes/<file-name>.md

Create the directory if it doesn't exist. Print the file path after writing.

Quality Checklist

Before writing the file, verify:

  • All template sections are filled
  • The # H1 header contains the issue title
  • Code snippets have proper syntax highlighting (java, kotlin, etc.)
  • Technical terms and class names are accurate to what was mentioned
  • The title is concise and descriptive
  • No raw meeting artifacts remain (filler words, off-topic tangents, speaker labels)

References

For real-world examples of well-written issues in this project, see references/examples.md. Consult these examples to match the tone, depth, and structure expected in this project's issues.