| name | meeting-tasks |
| description | Turn meeting notes into reviewed Jira task proposals with atl. USE WHEN capturing meeting or retro action items as assigned issues. DO NOT USE WHEN the source is a specification, only a prose summary is wanted, or the task is an ordinary Jira operation. |
Meeting notes → Jira tasks with atl
Parse the notes → present the extracted items → get approval → create.
Never create tickets before the user confirms the list. Command details live
in the jira and confluence skills.
Preflight: atl must be installed and configured. If command -v atl fails
or a command exits 7 ("not configured"), run {{atl.setup_cmd}} and stop.
Workflow
1. Get the notes
Pasted text as-is, or use a guarded Confluence read:
export ATL_READ_ONLY=1
atl conf search --cql 'title ~ "<meeting title>"' --limit 5
atl conf page view <id> -o text
2. Extract action items
Signals: explicit markers ("AI:", "TODO", "Action:", checkboxes, "@name"),
assignment verbs ("X will…", "X to…", "ask X to…"), and decisions that imply
work ("agreed to migrate…"). Capture per item: the action as a verb phrase,
the assignee as written, a due date if stated, and one sentence of surrounding
context.
Skip pure decisions with no follow-up work and vague intentions ("we should
think about…") — but list what you skipped, so the user can promote an item
back.
3. Resolve assignees (Server/DC uses usernames)
export ATL_READ_ONLY=1
atl jira user search 'Alex Doe'
Ambiguous or missing match → leave the task unassigned and flag it. Never
guess between two people.
4. Present for approval
A table: # / summary / assignee (or ⚠ unresolved) / due date / source line.
Ask for the target project key if unknown. Wait for confirmation or edits.
5. Create tasks — sequentially
atl jira issue create --project KEY --type Task --summary '<verb-first action>' --from-md item.md \
--field 'assignee={"name":"<username>"}' --field duedate=<YYYY-MM-DD>
Description: Context (meeting name + date + the source lines) / What to do /
link to the notes page if there is one. A mid-run failure → stop, report
the keys created so far, ask how to proceed (atl never retries POSTs — do
not blind-retry either).
6. Summarize and backlink
List created keys grouped by assignee. Offer to leave a "created tasks"
comment on the source Confluence page — note the comment body is CSF, not
markdown:
printf '<p>Follow-ups: KEY-1, KEY-2, KEY-3</p>' | atl conf comment add --id <pageId> --from-file -
Only with explicit approval — it writes to a shared page.
Pitfalls
| Symptom | Cause / fix |
|---|
| assignee rejected | must be the DC username from user search, not a display name or email |
duedate rejected | the field may be off-screen for that project — drop it and note the date in the description |
exit 8 on --from-md | unconvertible markdown block — the error names it; simplify |
