blockscout/frontend

add-env-var

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

finalize-task

Land a finished product task — prune the working files (keep spec.md), then finalize the draft PR into ready-for-review.

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-changes

Review a change on three axes — spec compliance, repo standards, correctness — 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).

resolve-config-request

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

slack-watch

Watch Slack threads (DMs and channels) for new replies over a Socket Mode WebSocket, printing one line per genuinely-new reply. Use to be notified inside a live local Claude Code or Cursor session (not a cloud agent).

grill-the-task

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

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.

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.

implement-ticket

Execute one ticket of a product-task spec.

to-tickets

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

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.

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.

prepare-release

Prepare the next release of the application (tag, docs, release notes), then publish the pre-release and request a staging roll-up

check-github-cli

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

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.

deploy-demo

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

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.

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 —…