blockscout/frontend

create-pr

Create or finalize a pull request — three modes: placeholder draft PR at spec time, finalize a draft into ready-for-review, or a regular PR right away for work done outside the task workflow.

deploy-demo

Create a GitHub deployment for the current branch using the deploy-review workflow

finalize-task

Land a finished product task — prune the working files (keep spec.md), flip the draft PR to ready, run the review loop, deploy the spec's demos, report.

grill-the-task

Grill a product task (GitHub issue) into implementable work.

resolve-review

Close out review findings — adjudicate each one, fix what deserves fixing, then reply on the PR threads or in the task's review file.

review-loop

Run the review loop on an open PR — a headless reviewer round, an autonomous resolver, a CI wait and fix, repeated until the review is cleared and CI is green; pauses only on a `needs-human` finding.

to-spec

Turn the current conversation into a product-task spec and publish it as a draft PR: no interview, just synthesis of what you've already discussed.

add-env-var

Step-by-step checklist for adding a new NEXT_PUBLIC_* environment variable. Use when introducing any new runtime env var.

deprecate-env-var

Checklist for deprecating a NEXT_PUBLIC_* environment variable — immediate removal, or a grace period before a later removal. Use when removing, renaming, or replacing a runtime env var.

debrief-meeting

Debrief the latest front-end weekly: route each decision to its issue, file the new ones, post the summary.

implement-ticket

Execute one ticket of a product-task spec.

process-task-inbox

Fold the pending sections of the task's inbox.md into its questions, spec and tickets.

to-tickets

Break a product-task spec into a set of tracer-bullet tickets, each declaring its blocking edges.

diagnose-bug

Diagnose a reported misbehaviour end-to-end.

review-changes

Review a change axis by axis — spec compliance, repo standards, correctness, and a Jev screen — then publish the findings as inline PR comments or into a review file in the task folder.

add-new-page

Scaffold a new page (index / detail / general) and optionally wire it to API data. Use when adding any new route to the app, or when wiring API data into an already-scaffolded page (one with `TODO (api-data):` markers).

design-readout

Read one Figma node into a design readout — per node the repo component, its props and the theme tokens, with every ambiguous, unrecognized and layout item listed for the developer to settle. Recognition only, never implementation.

create-issue

Create a GitHub issue from the available context. Use when the user asks to file an issue from a source they name (Slack thread, notes, document) or from this conversation.

triage-monitoring-event

Triage one error-monitoring event end-to-end — mute it as noise, or open a PR with the fix.

resolve-config-request

Turn a Slack request into the exact env vars to set on a live instance, and hand them to DevOps.

slack-subscribe

Subscribe this session to replies in a Slack thread, then stop; replies are forwarded later as cross-session messages. Use after posting a question or a demo link to Slack when the run must resume on the colleague's answer, and to unsubscribe at teardown.…

slack-watch

Deprecated — use slack-subscribe. Watch Slack threads for new replies over a Socket Mode WebSocket; only while no Honk session is connected to Slack.

release

Run one phase of a release — prepare, alpha or publish — through the release CLI, stopping at the operator's checkpoints

add-api-resource

Declare new API resource(s) in an existing API service. Use whenever the app needs to call an endpoint that has no `service:name` resource yet.

slack-file

Download Slack attachments by file ID, or upload local files into a Slack thread. Use when a Slack message lists Files: whose contents matter, or when posting a file to Slack; the MCP connector reports metadata only. Guides Keychain token setup if missing.

grilling

Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.

check-github-cli

Ensure GitHub CLI (gh) is installed and authenticated before running gh commands; guide the user to configure it if not

publish-beta-types

Publish a beta version of a `@blockscout/*-types` npm package and pin it here. Use when a needed response type isn't in any published package version yet.

resolve-api-url

Resolve the real request URL of an API resource on a live Blockscout instance (`service:name` + instance → full URL). Use whenever a request must be made to, or a sample response fetched from, a deployed instance's API.

update-glossary

Add a new term, update an existing definition, or remove an outdated entry in `.agents/GLOSSARY.md`. Use whenever the user wants to write something into the project glossary, or asks "should this be in the glossary?". Enforces the file's principle —…