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

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.