name	gh-issue
description	Create a GitHub issue/ticket for the Book Corners iOS repo. Use whenever the user wants to file a bug, create a ticket, open an issue, report a problem, or request a feature/enhancement/documentation change for andreagrandi/book-corners-ios.

Create a GitHub issue for book-corners-ios

Use this workflow to file issues on andreagrandi/book-corners-ios and add them to the Book Corners project board: https://github.com/users/andreagrandi/projects/2.

Draft first. Issue creation is outward-facing: show the title, body, labels, priority, and area, let the user edit, and only run gh issue create after the user approves. If the description is too thin for a clear Problem and at least one Acceptance Criterion, ask 1-2 concise questions first. If priority or area is not stated, ask before creating the issue.

Classify

Apply exactly two labels:

Repo label: always book-corners-ios.
Type label: exactly one of bug, enhancement, or documentation.

Do not invent labels. Area belongs in the project Area field, not labels. Other repo labels such as duplicate, question, help wanted, or wontfix are not used for new work-item creation unless the user explicitly requests them.

Verified label IDs are reference-only; pass label names to gh issue create.

Label	REST ID	Node ID
`book-corners-ios`	`10998970480`	`LA_kwDORjhHW88AAAACj5b4cA`
`bug`	`10393840640`	`LA_kwDORjhHW88AAAACa4VsAA`
`documentation`	`10393840661`	`LA_kwDORjhHW88AAAACa4VsFQ`
`enhancement`	`10393840711`	`LA_kwDORjhHW88AAAACa4VsRw`

Priority defaults are not allowed in this repo workflow. Ask the user if they did not state priority.

High: app crashes, data loss, security/privacy issue, auth is broken, core library discovery/submission/reporting is blocked, push delivery is broken, or master CI is red.
Medium: important user-facing bug or feature with a workaround, single-flow degradation, or release-blocking polish that does not stop core use.
Low: cosmetic polish, docs, refactor/tech debt, minor developer experience, or nice-to-have enhancement.

Area is a required project field. Ask the user if it is not stated or inferable.

API: API client, request/response models, auth/session integration, backend contract changes needed by the app.
Admin: native admin moderation screens and staff workflows.
Search: search, filters, sorting, and list discovery.
Map: MapKit, annotations, clustering, callouts, map navigation.
Notifications: APNs registration, notification settings, deep links.
Operations: CI, build settings, release config, project tooling.
Testing: unit/UI tests, fixtures, mocks, test infrastructure.
UX: user-facing copy, visual layout, accessibility, flows, forms, empty/error states.

Body Template

Use this template unless the user provides a better structure:

## Problem
<What's wrong or missing, and where in the iOS app>

## Proposed change
<What should happen instead>

## Acceptance Criteria
- [ ] <Done condition 1>
- [ ] <Done condition 2>

Title: short, imperative or problem-focused, with no component prefix.

File It After Approval

Optional duplicate check:

gh issue list --repo andreagrandi/book-corners-ios --search "<keywords>" --state open

Create the issue:

URL=$(gh issue create --repo andreagrandi/book-corners-ios \
  --title "<title>" \
  --body "<body>" \
  --label "book-corners-ios" \
  --label "<bug|enhancement|documentation>")

Add it to the Book Corners project and capture the item ID:

ITEM_ID=$(gh project item-add 2 --owner andreagrandi \
  --url "$URL" --format json --jq .id)

Project ID: PVT_kwHOAAm1584BYNOT

Set Project to book-corners-ios:

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUrB4 \
  --single-select-option-id 5955c8f9

Set Priority:

High: b925d2e0
Medium: 23f4e2d2
Low: 89b1cb1e

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUrCA \
  --single-select-option-id <priority-option-id>

Set Area:

API: c4e6b87d
Admin: ba5fc051
Search: 82f936e5
Map: 97b54a1b
Notifications: 4ec3ad2e
Operations: 144b587b
Testing: 3aa57aae
UX: 9574e84e

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUrB8 \
  --single-select-option-id <area-option-id>

Set Status to Todo:

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUq48 \
  --single-select-option-id f75ad846

Report the issue URL and the selected type, priority, area, and project field.

Link Dependencies

Only do this when the user explicitly says the issue is blocked by or blocking another issue. gh has no native issue-dependency command, so use the REST API. The body uses the other issue's database id, not its #number.

# This issue <N> is blocked by <BLOCKER>.
BLOCKER_ID=$(gh api repos/andreagrandi/book-corners-ios/issues/<BLOCKER> --jq .id)
gh api --method POST -H "X-GitHub-Api-Version: 2026-03-10" \
  repos/andreagrandi/book-corners-ios/issues/<N>/dependencies/blocked_by \
  -F issue_id="$BLOCKER_ID"

List or remove blocked-by relationships:

gh api repos/andreagrandi/book-corners-ios/issues/<N>/dependencies/blocked_by \
  -H "X-GitHub-Api-Version: 2026-03-10" --jq '.[] | "#\(.number) \(.title)"'

gh api --method DELETE -H "X-GitHub-Api-Version: 2026-03-10" \
  repos/andreagrandi/book-corners-ios/issues/<N>/dependencies/blocked_by/<BLOCKER_ID>

Notes

Project fields were verified with gh project field-list 2 --owner andreagrandi.
If project commands fail because of missing scopes, run gh auth refresh -s project.
Never create the GitHub issue without adding it to the Book Corners project and setting Project, Priority, Area, and Status.

name	gh-issue
description	Create a GitHub issue/ticket for the Book Corners iOS repo. Use whenever the user wants to file a bug, create a ticket, open an issue, report a problem, or request a feature/enhancement/documentation change for andreagrandi/book-corners-ios.

Create a GitHub issue for book-corners-ios

Use this workflow to file issues on andreagrandi/book-corners-ios and add them to the Book Corners project board: https://github.com/users/andreagrandi/projects/2.

Classify

Apply exactly two labels:

Repo label: always book-corners-ios.
Type label: exactly one of bug, enhancement, or documentation.

Verified label IDs are reference-only; pass label names to gh issue create.

Label	REST ID	Node ID
`book-corners-ios`	`10998970480`	`LA_kwDORjhHW88AAAACj5b4cA`
`bug`	`10393840640`	`LA_kwDORjhHW88AAAACa4VsAA`
`documentation`	`10393840661`	`LA_kwDORjhHW88AAAACa4VsFQ`
`enhancement`	`10393840711`	`LA_kwDORjhHW88AAAACa4VsRw`

Priority defaults are not allowed in this repo workflow. Ask the user if they did not state priority.

High: app crashes, data loss, security/privacy issue, auth is broken, core library discovery/submission/reporting is blocked, push delivery is broken, or master CI is red.
Medium: important user-facing bug or feature with a workaround, single-flow degradation, or release-blocking polish that does not stop core use.
Low: cosmetic polish, docs, refactor/tech debt, minor developer experience, or nice-to-have enhancement.

Area is a required project field. Ask the user if it is not stated or inferable.

API: API client, request/response models, auth/session integration, backend contract changes needed by the app.
Admin: native admin moderation screens and staff workflows.
Search: search, filters, sorting, and list discovery.
Map: MapKit, annotations, clustering, callouts, map navigation.
Notifications: APNs registration, notification settings, deep links.
Operations: CI, build settings, release config, project tooling.
Testing: unit/UI tests, fixtures, mocks, test infrastructure.
UX: user-facing copy, visual layout, accessibility, flows, forms, empty/error states.

Body Template

Use this template unless the user provides a better structure:

## Problem
<What's wrong or missing, and where in the iOS app>

## Proposed change
<What should happen instead>

## Acceptance Criteria
- [ ] <Done condition 1>
- [ ] <Done condition 2>

Title: short, imperative or problem-focused, with no component prefix.

File It After Approval

Optional duplicate check:

gh issue list --repo andreagrandi/book-corners-ios --search "<keywords>" --state open

Create the issue:

URL=$(gh issue create --repo andreagrandi/book-corners-ios \
  --title "<title>" \
  --body "<body>" \
  --label "book-corners-ios" \
  --label "<bug|enhancement|documentation>")

Add it to the Book Corners project and capture the item ID:

ITEM_ID=$(gh project item-add 2 --owner andreagrandi \
  --url "$URL" --format json --jq .id)

Project ID: PVT_kwHOAAm1584BYNOT

Set Project to book-corners-ios:

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUrB4 \
  --single-select-option-id 5955c8f9

Set Priority:

High: b925d2e0
Medium: 23f4e2d2
Low: 89b1cb1e

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUrCA \
  --single-select-option-id <priority-option-id>

Set Area:

API: c4e6b87d
Admin: ba5fc051
Search: 82f936e5
Map: 97b54a1b
Notifications: 4ec3ad2e
Operations: 144b587b
Testing: 3aa57aae
UX: 9574e84e

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUrB8 \
  --single-select-option-id <area-option-id>

Set Status to Todo:

gh project item-edit --id "$ITEM_ID" --project-id PVT_kwHOAAm1584BYNOT \
  --field-id PVTSSF_lAHOAAm1584BYNOTzhTUq48 \
  --single-select-option-id f75ad846

Report the issue URL and the selected type, priority, area, and project field.

Link Dependencies

# This issue <N> is blocked by <BLOCKER>.
BLOCKER_ID=$(gh api repos/andreagrandi/book-corners-ios/issues/<BLOCKER> --jq .id)
gh api --method POST -H "X-GitHub-Api-Version: 2026-03-10" \
  repos/andreagrandi/book-corners-ios/issues/<N>/dependencies/blocked_by \
  -F issue_id="$BLOCKER_ID"

List or remove blocked-by relationships:

gh api repos/andreagrandi/book-corners-ios/issues/<N>/dependencies/blocked_by \
  -H "X-GitHub-Api-Version: 2026-03-10" --jq '.[] | "#\(.number) \(.title)"'

gh api --method DELETE -H "X-GitHub-Api-Version: 2026-03-10" \
  repos/andreagrandi/book-corners-ios/issues/<N>/dependencies/blocked_by/<BLOCKER_ID>

Notes

Project fields were verified with gh project field-list 2 --owner andreagrandi.
If project commands fail because of missing scopes, run gh auth refresh -s project.
Never create the GitHub issue without adding it to the Book Corners project and setting Project, Priority, Area, and Status.

gh-issue

Create a GitHub issue for book-corners-ios

Classify

Body Template

File It After Approval

Link Dependencies

Notes

Create a GitHub issue for book-corners-ios

Classify

Body Template

File It After Approval

Link Dependencies

Notes