agent-devkit 0.8.5 → 0.8.9

package/src/assets/scaffolds/flutter-app.json

@@ -0,0 +1,17 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "flutter-app",
+  "name": "Flutter App",
+  "description": "Create a Flutter application.",
+  "category": "mobile",
+  "kind": "application",
+  "requiredTooling": ["flutter"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [{ "command": "flutter", "args": ["create", "{{name}}"] }],
+  "postCreate": [{ "command": "flutter", "args": ["pub", "get"], "cwd": "{{name}}" }],
+  "doctor": [{ "command": "flutter", "args": ["doctor", "--machine"], "cwd": "{{name}}" }],
+  "outputs": ["{{name}}/pubspec.yaml", "{{name}}/lib/main.dart"]
+}

package/src/assets/scaffolds/go-api.json

@@ -0,0 +1,20 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "go-api",
+  "name": "Go API",
+  "description": "Create a minimal Go API project.",
+  "category": "backend",
+  "kind": "api",
+  "requiredTooling": ["go"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." },
+    { "name": "module", "description": "Go module path.", "default": "{{name}}" }
+  ],
+  "create": [
+    { "command": "mkdir", "args": ["-p", "{{name}}"], "platforms": ["darwin", "linux"] },
+    { "command": "cmd", "args": ["/c", "mkdir", "{{name}}"], "platforms": ["win32"] },
+    { "command": "go", "args": ["mod", "init", "{{module}}"], "cwd": "{{name}}" }
+  ],
+  "outputs": ["{{name}}/go.mod"]
+}

package/src/assets/scaffolds/laravel-app.json

@@ -0,0 +1,15 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "laravel-app",
+  "name": "Laravel App",
+  "description": "Create a Laravel application.",
+  "category": "backend",
+  "kind": "application",
+  "requiredTooling": ["php", "composer"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [{ "command": "composer", "args": ["create-project", "laravel/laravel", "{{name}}"] }],
+  "outputs": ["{{name}}/composer.json", "{{name}}/artisan"]
+}

package/src/assets/scaffolds/nestjs-api.json

@@ -0,0 +1,21 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "nestjs-api",
+  "name": "NestJS API",
+  "description": "Create a NestJS API project.",
+  "category": "backend",
+  "kind": "api",
+  "requiredTooling": ["node", "npm"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [
+    {
+      "command": "npx",
+      "args": ["@nestjs/cli@latest", "new", "{{name}}", "--package-manager", "npm"]
+    }
+  ],
+  "doctor": [{ "command": "npm", "args": ["run", "build"], "cwd": "{{name}}" }],
+  "outputs": ["{{name}}/package.json", "{{name}}/src/main.ts"]
+}

package/src/assets/scaffolds/next-app.json

@@ -0,0 +1,29 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "next-app",
+  "name": "Next.js App",
+  "description": "Create a Next.js application.",
+  "category": "fullstack",
+  "kind": "application",
+  "requiredTooling": ["node", "npm"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [
+    {
+      "command": "npx",
+      "args": [
+        "create-next-app@latest",
+        "{{name}}",
+        "--typescript",
+        "--eslint",
+        "--app",
+        "--src-dir",
+        "--yes"
+      ]
+    }
+  ],
+  "doctor": [{ "command": "npm", "args": ["run", "build"], "cwd": "{{name}}" }],
+  "outputs": ["{{name}}/package.json", "{{name}}/src/app"]
+}

package/src/assets/scaffolds/node-cli.json

@@ -0,0 +1,21 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "node-cli",
+  "name": "Node CLI",
+  "description": "Create a minimal Node.js CLI project.",
+  "category": "cli",
+  "kind": "cli",
+  "requiredTooling": ["node", "npm"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [
+    {
+      "command": "node",
+      "args": ["-e", "require('fs').mkdirSync(process.argv[1], { recursive: true })", "{{name}}"]
+    },
+    { "command": "npm", "args": ["init", "-y"], "cwd": "{{name}}" }
+  ],
+  "outputs": ["{{name}}/package.json"]
+}

package/src/assets/scaffolds/python-fastapi.json

@@ -0,0 +1,24 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "python-fastapi",
+  "name": "Python FastAPI",
+  "description": "Create a minimal Python FastAPI project.",
+  "category": "backend",
+  "kind": "api",
+  "requiredTooling": ["python", "pip"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [
+    { "command": "python", "args": ["-m", "venv", "{{name}}/.venv"] },
+    {
+      "command": "python",
+      "args": [
+        "-c",
+        "from pathlib import Path; p=Path('{{name}}'); p.mkdir(exist_ok=True); (p/'main.py').write_text('from fastapi import FastAPI\\n\\napp = FastAPI()\\n\\n@app.get(\"/\")\\ndef read_root():\\n    return {\"status\": \"ok\"}\\n'); (p/'requirements.txt').write_text('fastapi\\nuvicorn\\n')"
+      ]
+    }
+  ],
+  "outputs": ["{{name}}/main.py", "{{name}}/requirements.txt"]
+}

package/src/assets/scaffolds/rails-app.json

@@ -0,0 +1,15 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "rails-app",
+  "name": "Rails App",
+  "description": "Create a Ruby on Rails application.",
+  "category": "backend",
+  "kind": "application",
+  "requiredTooling": ["ruby", "rails"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [{ "command": "rails", "args": ["new", "{{name}}"] }],
+  "outputs": ["{{name}}/Gemfile", "{{name}}/config/application.rb"]
+}

package/src/assets/scaffolds/react-native-expo.json

@@ -0,0 +1,16 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "react-native-expo",
+  "name": "React Native Expo App",
+  "description": "Create an Expo React Native application.",
+  "category": "mobile",
+  "kind": "application",
+  "requiredTooling": ["node", "npm"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [{ "command": "npx", "args": ["create-expo-app@latest", "{{name}}"] }],
+  "doctor": [{ "command": "npx", "args": ["expo-doctor"], "cwd": "{{name}}" }],
+  "outputs": ["{{name}}/package.json", "{{name}}/app.json"]
+}

package/src/assets/scaffolds/react-vite.json

@@ -0,0 +1,23 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "react-vite",
+  "name": "React Vite App",
+  "description": "Create a React application with Vite.",
+  "category": "frontend",
+  "kind": "application",
+  "requiredTooling": ["node", "npm"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." },
+    { "name": "template", "description": "Vite template.", "default": "react-ts" }
+  ],
+  "create": [
+    {
+      "command": "npm",
+      "args": ["create", "vite@latest", "{{name}}", "--", "--template", "{{template}}"]
+    }
+  ],
+  "postCreate": [{ "command": "npm", "args": ["install"], "cwd": "{{name}}" }],
+  "doctor": [{ "command": "npm", "args": ["run", "build"], "cwd": "{{name}}" }],
+  "outputs": ["{{name}}/package.json", "{{name}}/src"]
+}

package/src/assets/scaffolds/rust-cli.json

@@ -0,0 +1,16 @@
+{
+  "schema": "agent-devkit.scaffold/v1",
+  "id": "rust-cli",
+  "name": "Rust CLI",
+  "description": "Create a Rust CLI project.",
+  "category": "cli",
+  "kind": "cli",
+  "requiredTooling": ["cargo", "rust"],
+  "variables": [
+    { "name": "name", "description": "Project directory name.", "required": true },
+    { "name": "directory", "description": "Parent directory.", "default": "." }
+  ],
+  "create": [{ "command": "cargo", "args": ["new", "{{name}}", "--bin"] }],
+  "doctor": [{ "command": "cargo", "args": ["check"], "cwd": "{{name}}" }],
+  "outputs": ["{{name}}/Cargo.toml", "{{name}}/src/main.rs"]
+}

package/src/modules/automations/surface/knowledge.json

@@ -0,0 +1,11 @@
+{
+  "moduleId": "automations",
+  "summary": "Automations are reusable local task packages made of automation.json, skill.md, readme.md and payloads/.",
+  "facts": [
+    "The agent reads skill.md first; readme.md is for human documentation.",
+    "The curator must reject or mark for revision any automation outside the canonical contract.",
+    "Agent-generated automations can only use workflow, http, template or mcp.tool executors automatically.",
+    "Secrets must be referenced by vault name, never stored directly in automation files.",
+    "Duplicate automations are blocked; meaningful variants may be kept as candidate variations."
+  ]
+}

package/src/modules/automations/surface/loop.json

@@ -0,0 +1,18 @@
+{
+  "moduleId": "automations",
+  "mode": "automation-curation-and-execution",
+  "allowedActions": [
+    "Search existing automations before executing repetitive work.",
+    "Run active automations when permissions allow it.",
+    "Create candidate automations when a task is reusable and no equivalent automation exists.",
+    "Ask the curator to validate, classify and review candidates.",
+    "Use vault references for credentials required by automation execution."
+  ],
+  "forbiddenActions": [
+    "Run candidate automations before validation and promotion.",
+    "Accept automations missing automation.json, skill.md, readme.md or payloads/.",
+    "Store secrets inside automation manifests, skills, readmes or payload files.",
+    "Create duplicate automations when an active equivalent already covers the task."
+  ],
+  "approvalRequired": true
+}

package/src/modules/automations/surface/prompt.json

@@ -0,0 +1,20 @@
+{
+  "moduleId": "automations",
+  "templates": [
+    {
+      "id": "automations.search",
+      "template": "Search reusable automations for this task before building a new workflow: {{query}}",
+      "variables": ["query"]
+    },
+    {
+      "id": "automations.createCandidate",
+      "template": "Create a canonical automation candidate only after confirming no equivalent active automation covers this task: {{task}}",
+      "variables": ["task"]
+    },
+    {
+      "id": "automations.run",
+      "template": "Run the selected active automation with structured input: {{input}}",
+      "variables": ["input"]
+    }
+  ]
+}

package/src/modules/automations/surface/skill.json

@@ -0,0 +1,17 @@
+{
+  "moduleId": "automations",
+  "purpose": "Reuse, create and curate safe task automations that the agent can execute through a canonical contract.",
+  "whenToUse": [
+    "The user asks for a repetitive or reusable task.",
+    "A previous task can become a script, template, HTTP request, workflow or MCP tool wrapper.",
+    "The agent needs to check whether an automation already exists.",
+    "The agent has created an automation candidate and needs curator review.",
+    "The user asks to install, disable, archive or audit automations."
+  ],
+  "whenNotToUse": [
+    "The task is one-off and should not be reused.",
+    "The automation would require storing secrets in plain text.",
+    "The candidate does not follow the canonical automation package layout.",
+    "The existing automation already covers the requested task exactly."
+  ]
+}

package/src/modules/background/surface/knowledge.json

@@ -0,0 +1,11 @@
+{
+  "moduleId": "background",
+  "summary": "Background runs persistent local jobs through a queue, worker registry and user-controlled preferences.",
+  "facts": [
+    "Features dispatch background work through the canonical background dispatcher.",
+    "The runtime executes jobs in parallel up to maxParallelWorkers.",
+    "Jobs are persisted, auditable, retryable and can move to dead-letter.",
+    "Background jobs must not persist secrets in payloads.",
+    "Model usage in background is disabled unless the user preference allows it."
+  ]
+}

package/src/modules/background/surface/loop.json

@@ -0,0 +1,18 @@
+{
+  "moduleId": "background",
+  "mode": "background-runtime-management",
+  "allowedActions": [
+    "List background jobs and queue counters.",
+    "Dispatch supported internal jobs when useful.",
+    "Run one runtime cycle on demand.",
+    "Update runtime preferences when the user asks.",
+    "Retry or cancel jobs when requested."
+  ],
+  "forbiddenActions": [
+    "Store credentials in job payloads.",
+    "Run background model jobs when allowModelUse is false.",
+    "Bypass environment permissions for local execution.",
+    "Create feature-specific background loops outside the canonical dispatcher."
+  ],
+  "approvalRequired": true
+}

package/src/modules/background/surface/prompt.json

@@ -0,0 +1,20 @@
+{
+  "moduleId": "background",
+  "templates": [
+    {
+      "id": "background.dispatch",
+      "template": "Dispatch the internal background job {{type}} with a minimal non-secret payload.",
+      "variables": ["type"]
+    },
+    {
+      "id": "background.status",
+      "template": "Inspect the background runtime status and explain whether jobs are pending, running, blocked or failed.",
+      "variables": []
+    },
+    {
+      "id": "background.runOnce",
+      "template": "Run one background processing cycle and report what changed.",
+      "variables": []
+    }
+  ]
+}

package/src/modules/background/surface/skill.json

@@ -0,0 +1,16 @@
+{
+  "moduleId": "background",
+  "purpose": "Operate the canonical local background runtime for asynchronous jobs, maintenance and future autonomous processing.",
+  "whenToUse": [
+    "A task can be processed asynchronously without blocking the user.",
+    "The user asks about background status, jobs or runtime preferences.",
+    "Memory processing, environment scans, schedules or maintenance should run outside the main prompt path.",
+    "A failed or waiting job needs retry, cancellation or inspection."
+  ],
+  "whenNotToUse": [
+    "The user expects an immediate direct answer.",
+    "The payload contains secrets or credentials.",
+    "The job type is not registered in the background worker registry.",
+    "The action needs user approval or permissions that are not currently available."
+  ]
+}

package/src/modules/environment/surface/knowledge.json

@@ -3,10 +3,18 @@
   "summary": "Environment capabilities inspect the local development machine, scan supported tooling, prepare dependencies, manage tooling lifecycle plans, process variables, files and approved shell execution.",
   "facts": [
     "Tools inspection can locate installed binaries and common version strings.",
-    "Environment scan runs a structured read-only inventory of languages, SDKs, CLIs, frameworks, services and workspace tooling from the canonical tooling catalog.",
+    "Environment scan quick runs a structured read-only inventory from the canonical tooling catalog.",
+    "Environment scan full also discovers executable commands in PATH, project markers under approved roots and external MCP config files.",
+    "Environment inventory reads the persisted result of full scans so the agent can answer environment questions without rescanning every time.",
+    "Environment background stores opt-in scan preferences and can run a full scan on demand for approved roots.",
     "Environment tooling uses JSON definitions from assets/tooling plus local data/tooling entries to detect, doctor, install, upgrade, downgrade and uninstall supported tools.",
     "Environment setup is the preferred orchestrator when the user wants the agent to prepare, repair, install or authenticate operational dependencies.",
+    "Environment permissions stores the user's global/project/session permission mode, grants and capability-specific exceptions used by the agent approval runtime.",
+    "Environment terminal manages persistent shell sessions when the user needs a sequence of commands in the same cwd or process context.",
+    "Environment processes inspects and controls local processes and ports when the user asks what is running or needs to stop a process.",
+    "Environment variables lists and reads environment variables with sensitive-value redaction by default.",
     "When a required CLI is missing, prefer environment.setup before telling the user to install it manually.",
+    "When the user asks what exists on the machine, use environment.inventory first; if it is empty or stale, run environment.scan with scope full and persist true.",
     "Tooling lifecycle actions must plan before mutating the local environment.",
     "Learned tooling starts as a draft and must be promoted before it should be used for trusted lifecycle execution.",
     "Environment variable reads redact sensitive values unless explicitly requested.",

package/src/modules/environment/surface/prompt.json

@@ -6,9 +6,29 @@
       "template": "Use filesystem results to answer with exact paths and mention whether a write, patch or delete changed state: {{result}}",
       "variables": ["result"]
     },
+    {
+      "id": "environment.permissions",
+      "template": "Explain the current environment permission mode, grants, exceptions, missing permissions and the exact approval the user must grant before retrying. Never imply broad access unless the result explicitly says full-access: {{result}}",
+      "variables": ["result"]
+    },
+    {
+      "id": "environment.processes",
+      "template": "Summarize process inspection or control results with pid, command, port, signal, status and any failed operation. Do not hide permission or platform limitations: {{result}}",
+      "variables": ["result"]
+    },
     {
       "id": "environment.scan",
-      "template": "Summarize the environment scan by host, installed tools, missing tools, workspace matches, health findings and recommended next actions. Do not claim credentials are configured unless the scan explicitly says so: {{result}}",
+      "template": "Summarize the environment scan by host, installed tools, missing tools, discovered PATH commands, projects, MCP configs, health findings and recommended next actions. Do not claim credentials are configured unless the scan explicitly says so: {{result}}",
+      "variables": ["result"]
+    },
+    {
+      "id": "environment.inventory",
+      "template": "Summarize persisted environment inventory. If it is empty, recommend a full scan with approved roots. If it has projects, MCP configs or CLI discoveries, use exact paths and counts: {{result}}",
+      "variables": ["result"]
+    },
+    {
+      "id": "environment.background",
+      "template": "Explain background scanning status, configured roots, cadence and whether a full scan just ran. Make clear that background scanning is opt-in: {{result}}",
       "variables": ["result"]
     },
     {
@@ -16,6 +36,11 @@
       "template": "Summarize shell execution result with exit code, stdout, stderr and timeout status. Never hide failures: {{result}}",
       "variables": ["result"]
     },
+    {
+      "id": "environment.terminal",
+      "template": "Summarize persistent terminal session results with session id, cwd, command, output, exit state and next safe command if the task is not complete: {{result}}",
+      "variables": ["result"]
+    },
     {
       "id": "environment.setup",
       "template": "Explain this setup result as readiness, planned work, executed work and next actions. If approval is required, state exactly what permission is needed. If a CLI login requires an interactive terminal, say which command will run: {{result}}",
@@ -25,6 +50,11 @@
       "id": "environment.tooling",
       "template": "Explain this tooling result. For plans, show exact commands and approval requirements. For executions, show succeeded/failed/skipped steps and the next safe action: {{result}}",
       "variables": ["result"]
+    },
+    {
+      "id": "environment.variables",
+      "template": "Summarize environment variable results with names, redaction status and scope. Never print sensitive values unless the result explicitly includes them and the user requested sensitive reads: {{result}}",
+      "variables": ["result"]
     }
   ]
 }

package/src/modules/environment/surface/skill.json

@@ -3,6 +3,8 @@
   "purpose": "Inspect the local development environment and manage supported tooling through a safe catalog-driven lifecycle.",
   "whenToUse": [
     "The user asks for a system scan, environment diagnosis, machine raio X, installed languages, CLIs, frameworks, Docker, Flutter, Dart, cloud tools or development tools.",
+    "The user asks what projects, MCP configs or executable commands the agent has discovered locally.",
+    "The user wants to enable, disable or run opt-in background environment scanning.",
     "The user asks whether a required external tool, CLI, SDK, runtime or framework is installed or compatible.",
     "The user asks the agent to configure, prepare, repair or make a provider/tool ready for use.",
     "The user asks to install, update, upgrade, downgrade, uninstall or doctor a supported CLI, SDK, runtime, service or framework.",
@@ -10,7 +12,11 @@
     "The agent needs to verify runtime prerequisites before using a module.",
     "The user asks what tools, versions or environment variables are available.",
     "The user asks the agent to inspect, create, edit or patch files.",
-    "The user asks the agent to run a terminal command."
+    "The user asks the agent to run a terminal command.",
+    "The user asks to configure or review permission modes, grants or tool-specific exceptions.",
+    "The user asks to create or continue a persistent terminal session.",
+    "The user asks to inspect or stop local processes and ports.",
+    "The user asks to list, read or reason about environment variables."
   ],
   "whenNotToUse": [
     "The task requires credentials that are not already configured or explicitly provided.",

package/src/modules/integrations/surface/knowledge.json

@@ -3,6 +3,10 @@
   "summary": "Integrations connect Agent DevKit to external tools and MCP servers. External tools are cached locally before the agent can use them.",
   "facts": [
     "External MCP tools are exposed to the agent with ids formatted as mcp.<serverId>.<toolName>.",
+    "MCP discovery can inspect known external config files and workspace roots before the user manually registers a server.",
+    "Canonical MCP definitions live in assets/mcp and local user/discovered definitions live under data/mcp.",
+    "MCP catalog entries can register stdio or HTTP servers using template variables supplied by the user.",
+    "Discovered MCP servers must be imported with approval before they become registered integrations.",
     "The agent only sees external MCP tools after the server tools have been refreshed into the local cache.",
     "External MCP write, destructive, or unknown-risk tools require explicit approval before execution."
   ]

package/src/modules/integrations/surface/prompt.json

@@ -3,7 +3,7 @@
   "templates": [
     {
       "id": "integrations.mcpServers",
-      "template": "Explain this external MCP integration result and identify whether tools were cached, disabled, or blocked by approval policy: {{result}}",
+      "template": "Explain this external MCP integration result and identify whether servers were listed from catalog, registered, discovered, imported, cached, disabled, or blocked by approval policy: {{result}}",
       "variables": ["result"]
     }
   ]

package/src/modules/integrations/surface/skill.json

@@ -3,6 +3,10 @@
   "purpose": "Manage external integrations that extend the local agent runtime, starting with MCP servers.",
   "whenToUse": [
     "The user wants to connect Agent DevKit to an external MCP server.",
+    "The user wants to list, inspect or register a canonical MCP from the built-in MCP catalog.",
+    "The user wants to add a new MCP definition without changing project code.",
+    "The user asks to discover MCP servers configured in Claude, Codex, Cursor or a workspace.",
+    "The user wants to import discovered MCP server configs into Agent DevKit.",
     "The agent needs to list or refresh external MCP tools available for orchestration.",
     "The user asks whether a registered MCP integration is enabled or working."
   ],

package/src/modules/project/surface/knowledge.json

@@ -1,11 +1,14 @@
 {
   "moduleId": "project",
-  "summary": "Project state is local, explicit, and kept under .agent-devkit. Doctor observes state, init creates it, and reset removes it only with confirmation.",
+  "summary": "Project state is local, explicit, and kept under .agent-devkit. Doctor observes state, init creates it, reset removes it only with confirmation, and scaffold creates new application projects from canonical templates.",
   "facts": [
     "~/.agent-devkit is global user state.",
     "<project>/.agent-devkit is project-local state.",
     "agent doctor must not create or delete files.",
     "agent init creates .agent-devkit/config.json and .agent-devkit/agent-devkit.lock.",
-    "agent reset removes only .agent-devkit for the selected scope and requires --yes for destructive work."
+    "agent reset removes only .agent-devkit for the selected scope and requires --yes for destructive work.",
+    "project.scaffold is the preferred capability when the user asks to create a new app, API, CLI, library or framework project.",
+    "project.scaffold plans required tooling and commands before creating files.",
+    "When scaffold required tooling is missing, use environment.setup before asking the user to install dependencies manually."
   ]
 }

package/src/modules/project/surface/prompt.json

@@ -15,6 +15,11 @@
       "id": "project.reset",
       "template": "Explain the reset target and warn that deletion requires explicit confirmation: {{targetPath}}",
       "variables": ["targetPath"]
+    },
+    {
+      "id": "project.scaffold",
+      "template": "Explain this scaffold result. For plans, show required tooling, missing tooling, target path and exact commands. For create, show created path, failed steps and validation status. If tooling is missing, recommend environment.setup before retrying: {{result}}",
+      "variables": ["result"]
     }
   ]
 }

package/src/modules/project/surface/skill.json

@@ -1,13 +1,16 @@
 {
   "moduleId": "project",
-  "purpose": "Manage and inspect Agent DevKit state for a local project.",
+  "purpose": "Manage Agent DevKit project state and create new application projects from canonical scaffolds.",
   "whenToUse": [
     "The user asks whether the current project is initialized.",
     "The user wants to initialize project-local Agent DevKit state.",
-    "The user wants to remove project or global Agent DevKit state."
+    "The user wants to remove project or global Agent DevKit state.",
+    "The user asks to create, bootstrap or scaffold a new project in a supported language or framework.",
+    "The user asks for a new Flutter, React, Next.js, Angular, .NET, Python, Go, Rust, Laravel, Rails or Node project."
   ],
   "whenNotToUse": [
     "The user wants to update the npm package.",
-    "The user wants model reasoning, routing, or prompt execution."
+    "The user wants model reasoning, routing, or prompt execution.",
+    "The user wants to install a missing SDK or CLI without creating a project; use environment.setup instead."
   ]
 }

package/src/assets/prompts/core/intent.json

@@ -1,33 +0,0 @@
-{
-  "schema": "agent-devkit.prompt-pack/v1",
-  "id": "core/intent",
-  "version": "1.0.0",
-  "description": "Classifies a user message as conversation (chat) or an action request (task) so the runtime can route it.",
-  "locale": "pt-BR",
-  "output": {
-    "format": "json",
-    "language": "pt-BR"
-  },
-  "policies": {
-    "allowToolCalls": false,
-    "approvalRequired": false,
-    "maxToolCalls": 0
-  },
-  "knowledge": [
-    {
-      "id": "agent.intent.rule",
-      "source": "core/intent",
-      "content": "task = the user asks the agent to DO or CHANGE something: rename or configure the agent, create/update/delete local state, run diagnostics, install models, manage sessions/projects/preferences/secrets, analyze files or logs, execute any capability. chat = questions, explanations, opinions, small talk, or requests for information that need no tool."
-    },
-    {
-      "id": "agent.intent.bias",
-      "source": "core/intent",
-      "content": "When genuinely ambiguous, prefer chat. Greetings and questions about the agent itself are chat."
-    }
-  ],
-  "task": {
-    "intent": "intent-routing",
-    "userMessage": "Mensagem do usuario: {{message}}\n\nClassifique a mensagem. Responda SOMENTE com JSON: {\"intent\":\"chat\"} ou {\"intent\":\"task\"}.",
-    "variables": ["message"]
-  }
-}