Forge App Builder

When building a Forge app, the agent MUST complete this workflow in order. Do not skip steps. Do not substitute manual instructions for running the scripts below.

Critical Rules

1. Always use forge create to scaffold apps — it registers the app and generates a valid app ID
2. Never manually scaffold — apps without valid app IDs cannot be deployed
3. If forge create fails, STOP — inform the user and provide the manual command
4. Never ask for API tokens in chat — direct users to run forge login in their terminal and enter credentials there
5. Always ask the user to choose when multiple options exist (developer spaces, sites) — never pick on their behalf
6. Always ask the user for their Atlassian site URL during installation — never try to discover it from other apps, environment variables, or any other source
7. Always run the deploy script for deploy and install — do not give the user only manual forge deploy / forge install commands as the primary outcome; run scripts.deploy_forge_app.py yourself
8. Set ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-app-builder on forge commands run for this skill — prefix forge invocations with this env var: ones you run in the shell (e.g. forge developer-spaces list, forge lint) and the interactive forge create command you hand the user as a fallback. The bundled scripts set it automatically; other commands shown in this skill omit it for brevity — add it when you run them. The only exclusions are forge login and forge tunnel (user-run auth / live-dev commands).

MCP Server Prerequisites

This skill works best with the following MCP servers. The scripts and CLI workflow function without them, but the agent will lack access to up-to-date Forge documentation for template selection, module configuration, and code patterns.