@antomanc/aginit 0.1.0 → 0.3.0

package/src/cli/new.ts

@@ -1,6 +1,6 @@
 import path from 'node:path';
 import pc from 'picocolors';
-import { getDefaultConfig } from '../config/defaults.js';
+import { getDefaultConfig, upgradeLegacySkillConfig } from '../config/defaults.js';
 import {
   AGINIT_CONFIG_FILENAME,
   PresetType,
@@ -12,6 +12,11 @@ import { setupGit } from '../adapters/git.js';
 import { setupAgentsMarkdown } from '../adapters/agents-md.js';
 import { installAllSkills } from '../adapters/skills.js';
 import { initGraft } from '../adapters/graft.js';
+import {
+  agentBrowserConfigured,
+  agentBrowserStubInstalled,
+  setupAgentBrowser
+} from '../adapters/agent-browser.js';
 import { ensureDir, writeJsonFile } from '../utils/fs.js';
 import {
   readProjectConfig,
@@ -28,7 +33,6 @@ export interface NewProjectOptions {
   preset?: PresetType;
   framework?: WebFramework;
   packageManager?: PackageManager;
-  specWorkflow?: boolean;
   skills?: boolean;
   graft?: boolean;
   git?: boolean;
@@ -73,8 +77,7 @@ export async function createProject(
   const presetHandler = getPreset(presetName);
   const defaults = getDefaultConfig(projectName, presetName, {
     framework,
-    packageManager,
-    specWorkflow: options.specWorkflow
+    packageManager
   });
   const config = validateConfig(
     existingConfig
@@ -88,22 +91,7 @@ export async function createProject(
             options.framework !== undefined || options.preset !== undefined
               ? { ...existingConfig.browser, ...defaults.browser }
               : existingConfig.browser,
-          skills:
-            options.specWorkflow !== undefined
-              ? {
-                  ...existingConfig.skills,
-                  workflow: defaults.skills.workflow,
-                  sources: existingConfig.skills.sources.map((source) =>
-                    source.package === 'mattpocock/skills'
-                      ? {
-                          ...source,
-                          skills: defaults.skills.sources.find((s) => s.package === source.package)!
-                            .skills
-                        }
-                      : source
-                  )
-                }
-              : existingConfig.skills
+          skills: upgradeLegacySkillConfig(existingConfig.skills)
         }
       : defaults
   );
@@ -117,7 +105,11 @@ export async function createProject(
     );
   let complete = true;
 
-  const totalSteps = 6;
+  // The agent-browser skill stub is inert without its CLI and browser
+  // binaries, so provisioning them gets its own step when the skill applies.
+  const agentBrowserWanted =
+    agentBrowserConfigured(config.skills.sources) || agentBrowserStubInstalled(targetDir);
+  const totalSteps = agentBrowserWanted ? 7 : 6;
   let currentStep = 1;
 
   // Scaffold into the clean directory before Git adds files that upstream tools reject.
@@ -168,7 +160,15 @@ export async function createProject(
     logger.dim('Skills installation skipped (--no-skills or empty configuration)');
   }
 
-  // Step 6: Codebase intelligence (Graft)
+  // Provision the agent-browser runtime the skill stub drives
+  if (agentBrowserWanted) {
+    if (!silent) logger.step(currentStep++, totalSteps, 'Provisioning agent-browser runtime');
+    const abOk = await setupAgentBrowser({ dryRun, silent, cwd: targetDir });
+    complete &&= abOk;
+    if (!silent && abOk) logger.success('agent-browser runtime ready (CLI + browser)');
+  }
+
+  // Codebase intelligence (Graft)
   if (!silent) logger.step(currentStep++, totalSteps, 'Configuring codebase intelligence');
   if (config.codebase.graft && options.graft !== false) {
     const graftOk = await initGraft(targetDir, { dryRun, silent });
@@ -189,9 +189,10 @@ export async function createProject(
       );
     console.log();
     console.log('Next steps:');
-    console.log(pc.cyan(`  cd ${path.relative(process.cwd(), targetDir) || '.'}`));
+    const relativeTarget = path.relative(process.cwd(), targetDir);
+    if (relativeTarget) console.log(pc.cyan(`  cd ${relativeTarget}`));
     console.log(pc.cyan(`  ${packageManager} install`));
-    console.log(pc.cyan('  Open the repository in T3 Code'));
+    console.log(pc.cyan('  Open the repository in your AI coding agent'));
     console.log(pc.dim('  Prompt the agent: ') + pc.bold(pc.green('"bootstrap this project"')));
     console.log();
   }

package/src/cli/wizard.ts

@@ -23,14 +23,12 @@ export interface WizardNewAnswers {
   preset: PresetType;
   framework: WebFramework;
   packageManager: PackageManager;
-  specWorkflow: boolean;
 }
 
 export interface WizardInitAnswers {
   preset: PresetType;
   framework: WebFramework;
   packageManager: PackageManager;
-  specWorkflow: boolean;
 }
 
 export async function promptNewProject(defaults?: {
@@ -38,7 +36,6 @@ export async function promptNewProject(defaults?: {
   preset?: PresetType;
   framework?: WebFramework;
   packageManager?: PackageManager;
-  specWorkflow?: boolean;
 }): Promise<WizardNewAnswers> {
   let projectName: string = defaults?.projectName || '';
   if (!projectName) {
@@ -101,28 +98,6 @@ export async function promptNewProject(defaults?: {
     framework = assertNotCancelled(res) as WebFramework;
   }
 
-  let specWorkflow = defaults?.specWorkflow;
-  if (specWorkflow === undefined) {
-    const res = await p.select({
-      message: 'Select AI engineering workflow:',
-      initialValue: 'minimal',
-      options: [
-        {
-          value: 'minimal',
-          label: 'Standard Workflow (Recommended)',
-          hint: 'TDD, Code Review, Diagnosing Bugs'
-        },
-        {
-          value: 'spec',
-          label: 'Spec & Tickets Workflow',
-          hint: 'Adds to-spec, to-tickets, implement-spec'
-        }
-      ]
-    });
-    const selected = assertNotCancelled(res);
-    specWorkflow = selected === 'spec';
-  }
-
   let packageManager = defaults?.packageManager;
   if (!packageManager) {
     const res = await p.select({
@@ -146,8 +121,7 @@ export async function promptNewProject(defaults?: {
     projectName,
     preset,
     framework,
-    packageManager,
-    specWorkflow
+    packageManager
   };
 }
 
@@ -156,7 +130,6 @@ export async function promptInitProject(defaults?: {
   preset?: PresetType;
   framework?: WebFramework;
   packageManager?: PackageManager;
-  specWorkflow?: boolean;
 }): Promise<WizardInitAnswers> {
   const targetDir = defaults?.targetDir || process.cwd();
 
@@ -197,28 +170,6 @@ export async function promptInitProject(defaults?: {
     framework = assertNotCancelled(res) as WebFramework;
   }
 
-  let specWorkflow = defaults?.specWorkflow;
-  if (specWorkflow === undefined) {
-    const res = await p.select({
-      message: 'Select AI engineering workflow:',
-      initialValue: 'minimal',
-      options: [
-        {
-          value: 'minimal',
-          label: 'Standard Workflow (Recommended)',
-          hint: 'TDD, Code Review, Diagnosing Bugs'
-        },
-        {
-          value: 'spec',
-          label: 'Spec & Tickets Workflow',
-          hint: 'Adds to-spec, to-tickets, implement-spec'
-        }
-      ]
-    });
-    const selected = assertNotCancelled(res);
-    specWorkflow = selected === 'spec';
-  }
-
   // Auto-detect and preserve existing package manager without prompting
   let packageManager = defaults?.packageManager;
   if (!packageManager) {
@@ -243,8 +194,7 @@ export async function promptInitProject(defaults?: {
   return {
     preset,
     framework,
-    packageManager,
-    specWorkflow
+    packageManager
   };
 }
 
@@ -277,8 +227,7 @@ export async function runInteractiveWizard(): Promise<void> {
     complete = await createProject(answers.projectName, {
       preset: answers.preset,
       framework: answers.framework,
-      packageManager: answers.packageManager,
-      specWorkflow: answers.specWorkflow
+      packageManager: answers.packageManager
     });
   } else {
     const saved = readProjectConfig(process.cwd());
@@ -291,8 +240,7 @@ export async function runInteractiveWizard(): Promise<void> {
       complete = await initCurrentDirectory({
         preset: answers.preset,
         framework: answers.framework,
-        packageManager: answers.packageManager,
-        specWorkflow: answers.specWorkflow
+        packageManager: answers.packageManager
       });
     }
   }

package/src/config/defaults.ts

@@ -1,21 +1,61 @@
-import { AginitConfig, PresetType, WebFramework, PackageManager } from './schema.js';
+import {
+  AginitConfig,
+  PresetType,
+  WebFramework,
+  PackageManager,
+  SkillSourceConfig
+} from './schema.js';
 
 export interface DefaultConfigOptions {
   framework?: WebFramework;
-  specWorkflow?: boolean;
   packageManager?: PackageManager;
 }
 
+/**
+ * The stable skill set from mattpocock/skills installed by default:
+ * every skill in the `engineering` and `productivity` categories.
+ *
+ * The `misc` (rarely used) and `in-progress` categories are deliberately
+ * excluded. Re-evaluate when the upstream repository reshuffles categories.
+ */
+export const MATT_POCOCK_SKILLS = [
+  // engineering
+  'ask-matt',
+  'code-review',
+  'codebase-design',
+  'diagnosing-bugs',
+  'domain-modeling',
+  'grill-with-docs',
+  'implement',
+  'implement-spec',
+  'improve-codebase-architecture',
+  'pr',
+  'prototype',
+  'research',
+  'retro',
+  'setup-matt-pocock-skills',
+  'tdd',
+  'to-spec',
+  'to-tickets',
+  'triage',
+  'wayfinder',
+  'wizard',
+  // productivity
+  'grill-me',
+  'grilling',
+  'handoff',
+  'teach',
+  'to-questionnaire',
+  'wait-what',
+  'writing-for-agents'
+] as const;
+
 export function getDefaultConfig(
   name: string,
   preset: PresetType,
   options: DefaultConfigOptions = {}
 ): AginitConfig {
-  const specWorkflow = !!options.specWorkflow;
   const packageManager = options.packageManager || 'pnpm';
-  const mattSkills = specWorkflow
-    ? ['tdd', 'code-review', 'diagnosing-bugs', 'to-spec', 'to-tickets', 'implement-spec']
-    : ['tdd', 'code-review', 'diagnosing-bugs'];
 
   switch (preset) {
     case 'web': {
@@ -33,11 +73,18 @@ export function getDefaultConfig(
           secondary: 'codex'
         },
         skills: {
-          workflow: specWorkflow ? 'spec' : 'minimal',
           sources: [
             {
               package: 'mattpocock/skills',
-              skills: mattSkills
+              skills: [...MATT_POCOCK_SKILLS]
+            },
+            {
+              package: 'blader/humanizer',
+              skills: ['humanizer']
+            },
+            {
+              package: 'dietrichgebert/ponytail',
+              skills: ['ponytail']
             },
             {
               package: 'pbakaus/impeccable',
@@ -76,11 +123,18 @@ export function getDefaultConfig(
           secondary: 'codex'
         },
         skills: {
-          workflow: specWorkflow ? 'spec' : 'minimal',
           sources: [
             {
               package: 'mattpocock/skills',
-              skills: mattSkills
+              skills: [...MATT_POCOCK_SKILLS]
+            },
+            {
+              package: 'blader/humanizer',
+              skills: ['humanizer']
+            },
+            {
+              package: 'dietrichgebert/ponytail',
+              skills: ['ponytail']
             }
           ]
         },
@@ -111,11 +165,18 @@ export function getDefaultConfig(
           secondary: 'codex'
         },
         skills: {
-          workflow: specWorkflow ? 'spec' : 'minimal',
           sources: [
             {
               package: 'mattpocock/skills',
-              skills: mattSkills
+              skills: [...MATT_POCOCK_SKILLS]
+            },
+            {
+              package: 'blader/humanizer',
+              skills: ['humanizer']
+            },
+            {
+              package: 'dietrichgebert/ponytail',
+              skills: ['ponytail']
             }
           ]
         },
@@ -135,3 +196,39 @@ export function getDefaultConfig(
       };
   }
 }
+
+/** The skill selections that older versions of aginit wrote as defaults. */
+const LEGACY_MATT_SKILL_SELECTIONS: string[][] = [
+  ['tdd', 'code-review', 'diagnosing-bugs'],
+  ['tdd', 'code-review', 'diagnosing-bugs', 'to-spec', 'to-tickets', 'implement-spec']
+];
+
+function matchesLegacySelection(skills: string[]): boolean {
+  return LEGACY_MATT_SKILL_SELECTIONS.some(
+    (selection) =>
+      selection.length === skills.length && selection.every((skill) => skills.includes(skill))
+  );
+}
+
+/**
+ * Bring a saved `skills` section forward to the current standard: install the
+ * full stable Matt Pocock set and drop the retired workflow selector.
+ *
+ * Only the exact selections aginit used to write are migrated, so a project
+ * whose skill list was narrowed by hand keeps the list its author chose.
+ */
+export function upgradeLegacySkillConfig(
+  skills: AginitConfig['skills']
+): AginitConfig['skills'] {
+  const sources: SkillSourceConfig[] = skills.sources.map((source) =>
+    source.package === 'mattpocock/skills' && matchesLegacySelection(source.skills)
+      ? { ...source, skills: [...MATT_POCOCK_SKILLS] }
+      : source
+  );
+  const migrated = sources.some((source, index) => source !== skills.sources[index]);
+  if (!migrated) return skills;
+
+  const upgraded: AginitConfig['skills'] = { ...skills, sources };
+  delete upgraded.workflow;
+  return upgraded;
+}

package/src/config/schema.ts

@@ -18,6 +18,11 @@ export interface AginitConfig {
     secondary: string;
   };
   skills: {
+    /**
+     * @deprecated Legacy selector from when only a subset of skills was
+     * installed. All standard skills are installed now, so this field is no
+     * longer written. It is still accepted so existing configs keep loading.
+     */
     workflow?: 'minimal' | 'spec';
     sources: SkillSourceConfig[];
   };

package/src/index.ts

@@ -9,6 +9,7 @@ export * from './adapters/skills.js';
 export * from './adapters/graft.js';
 export * from './adapters/agents-md.js';
 export * from './adapters/browser.js';
+export * from './adapters/agent-browser.js';
 export * from './cli/new.js';
 export * from './cli/init.js';
 export * from './cli/doctor.js';