fix: improve instructions and change kilocode to automode

Author: rogeriochaves

src/assistant-kickoff/build-initial-prompt.ts

@@ -39,14 +39,15 @@ First steps:
 7. Use the LangWatch MCP to learn about prompt management and testing
 8. Start implementing the core agent functionality
 9. Instrument the agent with LangWatch
-10. Use Scenario tests to ensure the agent is working as expected, integrate with the agent and consider it done only when all scenarios pass
-11. If available from the framework, open a dev server for the user in the background and give them the url so they can play with the agent themselves
+10. Use Scenario tests to ensure the agent is working as expected, integrate with the agent and consider it done only when all scenarios pass, check scenario docs on how to implement
+11. If available from the framework, tell the user how to open a dev server give them the url they will be able to access so they can play with the agent themselves, don't run it for them
 
 
 Remember:
+- The LLM and LangWatch API keys are already available in the .env file, you don't need to set them up
 - ALWAYS use LangWatch Prompt CLI for prompts (ask the MCP how)
 - ALWAYS write Scenario tests for new features (ask the MCP how)
-- The LLM and LangWatch API keys are already available in the .env file
+- DO NOT test it "manually", always use the Scenario tests instead, do not open the dev server for the user, let them do it themselves only at the end of the implementation with everything working
 - Test everything before considering it done`;
 
   return `${instructions}\n\nAgent Goal: ${config.projectGoal}`;

src/config-collection/collect-config.ts

@@ -52,6 +52,53 @@ export const collectConfig = async (): Promise<ProjectConfig> => {
       })),
     });
 
+    const selectedProvider = allProviders.find((p) => p.id === llmProvider);
+    const providerDisplayName = selectedProvider?.displayName || llmProvider;
+
+    if (selectedProvider?.apiKeyUrl) {
+      logger.userInfo(`To get your ${providerDisplayName} API key, visit:`);
+      logger.userInfo(`${selectedProvider.apiKeyUrl}`);
+    }
+
+    const llmApiKey = await password({
+      message: `Enter your ${providerDisplayName} API key:`,
+      mask: "*",
+      validate:
+        llmProvider === "openai"
+          ? validateOpenAIKey
+          : (value) => {
+              if (!value || value.length < 5) {
+                return "API key is required and must be at least 5 characters";
+              }
+              return true;
+            },
+    });
+
+    // Collect additional credentials if the provider needs them
+    let llmAdditionalInputs: Record<string, string> | undefined;
+    if (
+      selectedProvider?.additionalCredentials &&
+      selectedProvider.additionalCredentials.length > 0
+    ) {
+      llmAdditionalInputs = {};
+
+      for (const credential of selectedProvider.additionalCredentials) {
+        if (credential.type === "password") {
+          llmAdditionalInputs[credential.key] = await password({
+            message: `Enter your ${credential.label}:`,
+            mask: "*",
+            validate: credential.validate,
+          });
+        } else {
+          llmAdditionalInputs[credential.key] = await input({
+            message: `Enter your ${credential.label}:`,
+            default: credential.defaultValue,
+            validate: credential.validate,
+          });
+        }
+      }
+    }
+
     const codingAssistant = await select<CodingAssistant>({
       message:
         "What is your preferred coding assistant for building the agent?",
@@ -123,52 +170,7 @@ export const collectConfig = async (): Promise<ProjectConfig> => {
       }
     }
 
-    const selectedProvider = allProviders.find((p) => p.id === llmProvider);
-    const providerDisplayName = selectedProvider?.displayName || llmProvider;
-
-    if (selectedProvider?.apiKeyUrl) {
-      logger.userInfo(`To get your ${providerDisplayName} API key, visit:`);
-      logger.userInfo(`${selectedProvider.apiKeyUrl}`);
-    }
-
-    const llmApiKey = await password({
-      message: `Enter your ${providerDisplayName} API key:`,
-      mask: "*",
-      validate:
-        llmProvider === "openai"
-          ? validateOpenAIKey
-          : (value) => {
-              if (!value || value.length < 5) {
-                return "API key is required and must be at least 5 characters";
-              }
-              return true;
-            },
-    });
-
-    // Collect additional credentials if the provider needs them
-    let llmAdditionalInputs: Record<string, string> | undefined;
-    if (
-      selectedProvider?.additionalCredentials &&
-      selectedProvider.additionalCredentials.length > 0
-    ) {
-      llmAdditionalInputs = {};
-
-      for (const credential of selectedProvider.additionalCredentials) {
-        if (credential.type === "password") {
-          llmAdditionalInputs[credential.key] = await password({
-            message: `Enter your ${credential.label}:`,
-            mask: "*",
-            validate: credential.validate,
-          });
-        } else {
-          llmAdditionalInputs[credential.key] = await input({
-            message: `Enter your ${credential.label}:`,
-            default: credential.defaultValue,
-            validate: credential.validate,
-          });
-        }
-      }
-    }
+    logger.userInfo("✔︎ Your coding assistant will finish setup later if needed\n");
 
     logger.userInfo("To get your LangWatch API key, visit:");
     logger.userInfo("https://app.langwatch.ai/authorize");

src/documentation/sections/principles-section.ts

@@ -29,6 +29,7 @@ Best practices:
 - When broken, run on single scenario at a time to debug and iterate faster, not the whole suite
 - Write as few scenarios as possible, try to cover more ground with few scenarios, as they are heavy to run
 - If user made 1 request, just 1 scenario might be enough, run it at the end of the implementation to check if it works
+- ALWAYS consult the Scenario docs on how to write scenarios, do not assume the syntax
 
 ### 2. Prompt Management
 

src/providers/coding-assistants/kilocode/index.ts

@@ -41,7 +41,7 @@ export const KilocodeCodingAssistantProvider: CodingAssistantProvider = {
       logger.userInfo(`🤖 Launching ${this.displayName}...`);
       // Launch kilocode with full terminal control
       // This blocks until kilocode exits
-      ProcessUtils.launchWithTerminalControl("kilocode", [prompt], {
+      ProcessUtils.launchWithTerminalControl("kilocode", ["-a", prompt], {
         cwd: projectPath,
       });
       logger.userSuccess("Session complete!");