---
name: mk:jira-fields
description: "JIRA custom field discovery + configuration via the jira-as wrapper. Triggers: 'field ID for X', 'list custom fields', 'check fields for project PROJ', 'configure agile fields for board'. Read ops are open; create/configure-agile require admin. NOT for setting per-issue field values (mk:jira-issue update)."
phase: on-demand
source: local
keywords: [jira, jira-fields, custom-fields, field-discovery, agile-field-config]
when_to_use: "Use to discover field IDs / names / scope, check per-project field availability, or configure agile field mappings. NOT for setting individual field values on a ticket."
user-invocable: true
context: fork
agent: jira-fields
---

# mk:jira-fields

Forks to the `jira-fields` agent. Most reads are open; `fields create` and `fields configure-agile` require **Admin** role.

## Triggers

- "what's the field ID for Story Points in PROJ?"
- "list all custom fields"
- "check which fields are available on project PROJ"
- "configure agile field mappings on board 42"

## Examples

- Discovery: "find the field ID for the 'Severity' custom field"
- Project check: "what fields can I set on PROJ-Bug?"
- Admin: "create a Number custom field named 'Estimated Cost'"

## Limitations

- `fields create` and `fields configure-agile` require Jira Admin. Insufficient permission → exit 3.

## See also

- Agent: `../../agents/jira-fields.md`
- Shared: `../jira/references/{install-and-auth,cli-idioms,safety-framework}.md`
- Domain refs:
  - `references/field-discovery.md` — discovery methodology
  - `references/agile-field-ids.md` — typical agile field IDs (Sprint, Story Points, Epic Link)
  - `references/field-types-reference.md` — type-selection guide (text/select/multiselect/user/etc.)
- Peer leaves: `mk:jira-issue` (sets field values per issue), `mk:jira-agile` (consumes agile field IDs), `mk:jira-admin` (`admin notification-scheme` etc. — broader admin surface)

## Gotchas

- (none yet)
