Convert setup-agentic-workflows.prompt.md to custom agent

- Created new setup-agentic-workflows.md agent template
- Updated commands.go to embed the new agent template
- Renamed function from ensureGettingStartedPrompt to ensureSetupAgenticWorkflowsAgent
- Updated add_command.go to use ensureAgentFromTemplate instead of ensurePromptFromTemplate
- Updated init.go to create agent instead of prompt
- Renamed and updated test file from getting_started_prompt_test.go to setup_agentic_workflows_agent_test.go
- Updated init_command.go documentation to mention the new agent
- All tests pass successfully

Co-authored-by: pelikhan <[email protected]>

Author: Copilot

pkg/cli/add_command.go

@@ -709,9 +709,9 @@ func ensureSharedAgenticWorkflowPrompt(verbose bool, skipInstructions bool) erro
 	return ensurePromptFromTemplate("create-shared-agentic-workflow.prompt.md", sharedAgenticWorkflowPromptTemplate, verbose, skipInstructions)
 }
 
-// ensureGettingStartedPrompt ensures that .github/prompts/setup-agentic-workflows.prompt.md contains the getting started guide
-func ensureGettingStartedPrompt(verbose bool, skipInstructions bool) error {
-	return ensurePromptFromTemplate("setup-agentic-workflows.prompt.md", gettingStartedPromptTemplate, verbose, skipInstructions)
+// ensureSetupAgenticWorkflowsAgent ensures that .github/agents/setup-agentic-workflows.md contains the setup guide agent
+func ensureSetupAgenticWorkflowsAgent(verbose bool, skipInstructions bool) error {
+	return ensureAgentFromTemplate("setup-agentic-workflows.md", setupAgenticWorkflowsAgentTemplate, verbose, skipInstructions)
 }
 
 // checkCleanWorkingDirectory checks if there are uncommitted changes

pkg/cli/commands.go

@@ -28,8 +28,8 @@ var agenticWorkflowAgentTemplate string
 //go:embed templates/create-shared-agentic-workflow.prompt.md
 var sharedAgenticWorkflowPromptTemplate string
 
-//go:embed templates/setup-agentic-workflows.prompt.md
-var gettingStartedPromptTemplate string
+//go:embed templates/setup-agentic-workflows.md
+var setupAgenticWorkflowsAgentTemplate string
 
 // SetVersionInfo sets the version information for the CLI
 func SetVersionInfo(v string) {

pkg/cli/init.go

@@ -69,14 +69,14 @@ func InitRepository(verbose bool, mcp bool) error {
 		fmt.Fprintln(os.Stderr, console.FormatSuccessMessage("Created /create-shared-agentic-workflow command"))
 	}
 
-	// Write getting started prompt
-	initLog.Print("Writing getting started prompt")
-	if err := ensureGettingStartedPrompt(verbose, false); err != nil {
-		initLog.Printf("Failed to write getting started prompt: %v", err)
-		return fmt.Errorf("failed to write getting started prompt: %w", err)
+	// Write setup agentic workflows agent
+	initLog.Print("Writing setup agentic workflows agent")
+	if err := ensureSetupAgenticWorkflowsAgent(verbose, false); err != nil {
+		initLog.Printf("Failed to write setup agentic workflows agent: %v", err)
+		return fmt.Errorf("failed to write setup agentic workflows agent: %w", err)
 	}
 	if verbose {
-		fmt.Fprintln(os.Stderr, console.FormatSuccessMessage("Created getting started guide"))
+		fmt.Fprintln(os.Stderr, console.FormatSuccessMessage("Created setup agentic workflows agent"))
 	}
 
 	// Configure MCP if requested

pkg/cli/init_command.go

@@ -23,6 +23,7 @@ This command:
 - Configures .gitattributes to mark .lock.yml files as generated
 - Creates GitHub Copilot custom instructions at .github/instructions/github-agentic-workflows.instructions.md
 - Creates the custom agent for workflow creation at .github/agents/create-agentic-workflow.md
+- Creates the setup agentic workflows agent at .github/agents/setup-agentic-workflows.md
 - Removes the old /create-agentic-workflow prompt if it exists
 
 With --mcp flag:
@@ -31,6 +32,7 @@ With --mcp flag:
 
 After running this command, you can:
 - Use GitHub Copilot Chat with @.github/agents/create-agentic-workflow.md to create workflows interactively
+- Use GitHub Copilot Chat with @.github/agents/setup-agentic-workflows.md for setup guidance
 - Add workflows from the catalog with: ` + constants.CLIExtensionPrefix + ` add <workflow-name>
 - Create new workflows from scratch with: ` + constants.CLIExtensionPrefix + ` new <workflow-name>
 

pkg/cli/getting_started_prompt_test.go renamed to pkg/cli/setup_agentic_workflows_agent_test.go

@@ -8,26 +8,26 @@ import (
 	"testing"
 )
 
-func TestEnsureGettingStartedPrompt(t *testing.T) {
+func TestEnsureSetupAgenticWorkflowsAgent(t *testing.T) {
 	tests := []struct {
 		name            string
 		existingContent string
 		expectedContent string
 	}{
 		{
-			name:            "creates new getting started prompt file",
+			name:            "creates new setup agentic workflows agent file",
 			existingContent: "",
-			expectedContent: strings.TrimSpace(gettingStartedPromptTemplate),
+			expectedContent: strings.TrimSpace(setupAgenticWorkflowsAgentTemplate),
 		},
 		{
 			name:            "does not modify existing correct file",
-			existingContent: gettingStartedPromptTemplate,
-			expectedContent: strings.TrimSpace(gettingStartedPromptTemplate),
+			existingContent: setupAgenticWorkflowsAgentTemplate,
+			expectedContent: strings.TrimSpace(setupAgenticWorkflowsAgentTemplate),
 		},
 		{
 			name:            "updates modified file",
-			existingContent: "# Modified Getting Started\n\nThis is a modified version.",
-			expectedContent: strings.TrimSpace(gettingStartedPromptTemplate),
+			existingContent: "# Modified Setup\n\nThis is a modified version.",
+			expectedContent: strings.TrimSpace(setupAgenticWorkflowsAgentTemplate),
 		},
 	}
 
@@ -51,34 +51,34 @@ func TestEnsureGettingStartedPrompt(t *testing.T) {
 				t.Fatalf("Failed to init git repo: %v", err)
 			}
 
-			promptsDir := filepath.Join(tempDir, ".github", "prompts")
-			promptPath := filepath.Join(promptsDir, "setup-agentic-workflows.prompt.md")
+			agentsDir := filepath.Join(tempDir, ".github", "agents")
+			agentPath := filepath.Join(agentsDir, "setup-agentic-workflows.md")
 
 			// Create initial content if specified
 			if tt.existingContent != "" {
-				if err := os.MkdirAll(promptsDir, 0755); err != nil {
-					t.Fatalf("Failed to create prompts directory: %v", err)
+				if err := os.MkdirAll(agentsDir, 0755); err != nil {
+					t.Fatalf("Failed to create agents directory: %v", err)
 				}
-				if err := os.WriteFile(promptPath, []byte(tt.existingContent), 0644); err != nil {
-					t.Fatalf("Failed to create initial getting started prompt: %v", err)
+				if err := os.WriteFile(agentPath, []byte(tt.existingContent), 0644); err != nil {
+					t.Fatalf("Failed to create initial setup agent: %v", err)
 				}
 			}
 
 			// Call the function with skipInstructions=false to test the functionality
-			err = ensureGettingStartedPrompt(false, false)
+			err = ensureSetupAgenticWorkflowsAgent(false, false)
 			if err != nil {
-				t.Fatalf("ensureGettingStartedPrompt() returned error: %v", err)
+				t.Fatalf("ensureSetupAgenticWorkflowsAgent() returned error: %v", err)
 			}
 
 			// Check that file exists
-			if _, err := os.Stat(promptPath); os.IsNotExist(err) {
-				t.Fatalf("Expected getting started prompt file to exist")
+			if _, err := os.Stat(agentPath); os.IsNotExist(err) {
+				t.Fatalf("Expected setup agentic workflows agent file to exist")
 			}
 
 			// Check content
-			content, err := os.ReadFile(promptPath)
+			content, err := os.ReadFile(agentPath)
 			if err != nil {
-				t.Fatalf("Failed to read getting started prompt: %v", err)
+				t.Fatalf("Failed to read setup agent: %v", err)
 			}
 
 			contentStr := strings.TrimSpace(string(content))
@@ -93,7 +93,7 @@ func TestEnsureGettingStartedPrompt(t *testing.T) {
 	}
 }
 
-func TestEnsureGettingStartedPrompt_WithSkipInstructionsTrue(t *testing.T) {
+func TestEnsureSetupAgenticWorkflowsAgent_WithSkipInstructionsTrue(t *testing.T) {
 	// Create a temporary directory for testing
 	tempDir := t.TempDir()
 
@@ -112,22 +112,22 @@ func TestEnsureGettingStartedPrompt_WithSkipInstructionsTrue(t *testing.T) {
 		t.Fatalf("Failed to init git repo: %v", err)
 	}
 
-	promptsDir := filepath.Join(tempDir, ".github", "prompts")
-	promptPath := filepath.Join(promptsDir, "setup-agentic-workflows.prompt.md")
+	agentsDir := filepath.Join(tempDir, ".github", "agents")
+	agentPath := filepath.Join(agentsDir, "setup-agentic-workflows.md")
 
 	// Call the function with skipInstructions=true
-	err = ensureGettingStartedPrompt(false, true)
+	err = ensureSetupAgenticWorkflowsAgent(false, true)
 	if err != nil {
-		t.Fatalf("ensureGettingStartedPrompt() returned error: %v", err)
+		t.Fatalf("ensureSetupAgenticWorkflowsAgent() returned error: %v", err)
 	}
 
 	// Check that file does not exist
-	if _, err := os.Stat(promptPath); !os.IsNotExist(err) {
-		t.Fatalf("Expected getting started prompt file to not exist when skipInstructions=true")
+	if _, err := os.Stat(agentPath); !os.IsNotExist(err) {
+		t.Fatalf("Expected setup agent file to not exist when skipInstructions=true")
 	}
 }
 
-func TestGettingStartedPromptContainsRequiredSections(t *testing.T) {
+func TestSetupAgenticWorkflowsAgentContainsRequiredSections(t *testing.T) {
 	// Verify the template contains all required sections
 	requiredSections := []string{
 		"Configure Secrets for Your Chosen Agent",
@@ -141,7 +141,7 @@ func TestGettingStartedPromptContainsRequiredSections(t *testing.T) {
 		"gh secret set",
 	}
 
-	content := strings.TrimSpace(gettingStartedPromptTemplate)
+	content := strings.TrimSpace(setupAgenticWorkflowsAgentTemplate)
 
 	for _, section := range requiredSections {
 		if !strings.Contains(content, section) {
@@ -150,14 +150,14 @@ func TestGettingStartedPromptContainsRequiredSections(t *testing.T) {
 	}
 }
 
-func TestGettingStartedPromptHasValidDocumentationLinks(t *testing.T) {
+func TestSetupAgenticWorkflowsAgentHasValidDocumentationLinks(t *testing.T) {
 	// Verify the template contains documentation links
 	requiredLinks := []string{
 		"https://githubnext.github.io/gh-aw/reference/engines/",
 		"https://github.com/settings/tokens",
 	}
 
-	content := strings.TrimSpace(gettingStartedPromptTemplate)
+	content := strings.TrimSpace(setupAgenticWorkflowsAgentTemplate)
 
 	for _, link := range requiredLinks {
 		if !strings.Contains(content, link) {

pkg/cli/templates/setup-agentic-workflows.md

@@ -0,0 +1,105 @@
+---
+name: setup-agentic-workflows
+description: A guided agent to help you set up your agentic workflows using gh-aw
+tools:
+  - runInTerminal
+  - getTerminalOutput
+  - createFile
+  - createDirectory
+  - editFiles
+  - search
+  - changes
+  - githubRepo
+---
+
+You are a conversational chat agent that interacts with the user to gather requirements and iteratively builds the workflow. Don't overwhelm the user with too many questions at once or long bullet points; always ask the user to express their intent in their own words and translate it in an agent workflow.
+
+- Do NOT tell me what you did until I ask you to as a question to the user.
+
+## Starting the conversation
+
+1. **Initial Decision**
+   Start by asking the user:
+```
+What agent will you use today?
+- `copilot` (GitHub Copilot CLI) - **Recommended for most users**
+- `claude` (Anthropic Claude Code) - Great for reasoning and code analysis
+- `codex` (OpenAI Codex) - Designed for code-focused tasks
+
+Once you choose, I'll guide you through setting up any required secrets.
+```
+
+That's it stop here and wait for the user to respond.
+
+## Configure Secrets for Your Chosen Agent
+
+### For `copilot` (Recommended)
+Say to the user:
+````
+You'll need a GitHub Personal Access Token with Copilot subscription. 
+
+**Steps:**
+1. Go to [GitHub Token Settings](https://github.com/settings/tokens)
+2. Create a Personal Access Token (Classic) with appropriate scopes
+3. Ensure you have an active Copilot subscription
+
+**Documentation:** [GitHub Copilot Engine Setup](https://githubnext.github.io/gh-aw/reference/engines/#github-copilot-default)
+
+**Set the secret** in a separate terminal window (never share your secret directly with the agent):
+
+```bash
+gh secret set COPILOT_CLI_TOKEN -a actions --body "your-github-pat-here"
+```
+````
+
+### For `claude`
+
+Say to the user:
+````
+You'll need an Anthropic API key.
+
+**Steps:**
+1. Sign up for Anthropic API access at [console.anthropic.com](https://console.anthropic.com/)
+2. Generate an API key from your account settings
+
+**Documentation:** [Anthropic Claude Code Engine](https://githubnext.github.io/gh-aw/reference/engines/#anthropic-claude-code)
+
+**Set the secret** in a separate terminal window:
+
+```bash
+gh secret set ANTHROPIC_API_KEY -a actions --body "your-anthropic-api-key-here"
+```
+````
+
+### For `codex`
+
+Say to the user:
+````
+You'll need an OpenAI API key.
+
+**Steps:**
+1. Sign up for OpenAI API access at [platform.openai.com](https://platform.openai.com/)
+2. Generate an API key from your account settings
+
+**Documentation:** [OpenAI Codex Engine](https://githubnext.github.io/gh-aw/reference/engines/#openai-codex)
+
+**Set the secret** in a separate terminal window:
+
+```bash
+gh secret set OPENAI_API_KEY -a actions --body "your-openai-api-key-here"
+```
+````
+
+## Build Your First Workflow
+
+Say to the user:
+````
+When you're ready, just type the command:
+
+```
+/create-agentic-workflow
+```
+
+This will start the configuration flow to help you create your first agentic workflow.
+
+````