Knowledge to Issue

This documentation was generated with the assistance of AI. Please report any inaccuracies.

Convert one or more pending/not-completed agreements from the knowledge/ base into a GitHub issue — resolving which agreement, gathering why it matters, and handing that off to iru-create-github-issue to actually draft and file it.

Purpose

iru-knowledge-to-issue bridges knowledge/ (built by iru-knowledge-process-inbox) and the tracked-ticket side of the catalog. It asks the user which pending or not-completed agreement(s) to convert — accepting a pending task id, a knowledge/pending/pending-.md filename, a knowledge/agreements/agreement-.md filename/id (with an item number when it has more than one open item), or a plain natural-language description searched by content across both directories. Once an agreement is resolved, it reads the originating meeting’s full transcription and attachments (via its knowledge/meetings/meeting-<timestamp>/ reference) and runs iru-explore against the current codebase, synthesizes a purpose statement from both, confirms it with the user, then hands that purpose — plus the meeting transcription/attachments, either linked (if already committed and pushed) or attached — to iru-create-github-issue to draft and file the actual issue. It never marks the source agreement complete: filing an issue means the work is now tracked, not done, so it only appends the created issue’s URL back onto the pending file and a note on the agreement item, leaving iru-knowledge-complete as the deliberate, later step that closes it out for real.

Purpose group

Knowledge Base Management

Invocation

/iru-knowledge-to-issue
/iru-knowledge-to-issue <id-filename-or-description>

Inputs

Argument Required Description Default

<id-filename-or-description>

No

A pending task id/filename, an agreement id/filename (optionally with an item number), or a plain natural-language description of the agreement to convert.

If omitted, the skill asks the user which agreement(s) to convert.

Outputs

  • A new GitHub issue, drafted and filed by iru-create-github-issue, grounded in the agreement’s meeting context and the current codebase.

  • A - GitHub issue: <url> line appended to the matching knowledge/pending/pending-<task-id>.md file (if one exists) and a short trailing note on the matching numbered item in its knowledge/agreements/agreement-<timestamp>.md file — the checkbox itself stays unchecked.

  • A closing report per agreement processed: what it resolved to, which context sources were used, the created issue’s number/URL (or why filing was skipped/declined), and a reminder that iru-knowledge-complete is still the step that closes the agreement out once the linked work is done.

  • Nothing at all if knowledge/ doesn’t exist yet, the repository isn’t hosted on GitHub, or the user declines at the draft-confirmation step inside iru-create-github-issue.

Execution flow

flowchart TD A[Start /iru-knowledge-to-issue] --> B{"knowledge/ exists\n+ GitHub-hosted?"} B -- no --> C["Tell the user what's missing, stop"] B -- yes --> D{"Identifier given\nas argument?"} D -- no --> E["Ask which agreement(s) to convert"] D -- yes --> F E --> F["Resolve each identifier:\npending id/filename,\nagreement id/filename + item,\nor content search"] F --> G{"Already completed,\nor already has an issue?"} G -- yes --> H["Confirm via AskUserQuestion\nbefore continuing"] G -- no --> I H --> I["Read the meeting's full\ntranscription + attachments"] I --> J["iru-explore\n(ground in the current codebase)"] J --> K["Synthesize + confirm\nthe purpose statement"] K --> L["Decide per file:\nlink (tracked + pushed)\nvs. actual attachment"] L --> M["iru-create-github-issue\n(purpose + files/links as context)"] M --> N{Issue created?} N -- yes --> O["Append issue URL to the\npending file + agreement item"] N -- no --> P[Report skipped, no changes] O --> Q["Report per agreement processed"] P --> Q Q --> R{More identifiers?} R -- yes --> F R -- no --> S[Done]

Dependencies

Invokes

  • Explore — grounds the synthesized purpose in the current codebase (no ticket argument, since none exists yet), reused as-is by `iru-create-github-issue’s own exploration step.

  • Create GitHub Issue — drafts and files the actual issue from the synthesized purpose, the meeting transcription/attachments, and the codebase context above.

Invoked by

None — it’s a top-level entry point, run directly by a person whenever an agreement recorded in knowledge/pending/knowledge/agreements needs to become tracked work.

Related agents

None directly — the skills it invokes (iru-explore) may spawn their own agents, but this skill spawns none itself.

Source

SKILL.md on GitHub — the file this page was generated from.