@shepai/cli 1.169.1-pr526.8e89740 → 1.170.0-pr513.cff27cb

package/apis/json-schema/Feature.yaml

@@ -39,16 +39,21 @@ properties:
   agentRunId:
     type: string
     description: Associated agent run ID for process tracking (optional)
+  injectedSkills:
+    type: array
+    items:
+      type: string
+    description: Skills that were injected into this feature's worktree during creation
   specPath:
     type: string
     description: Absolute path to the feature spec directory inside the worktree
   repositoryId:
     $ref: UUID.yaml
     description: ID of the Repository entity this feature belongs to
-  fast:
-    type: boolean
-    default: false
-    description: When true, SDLC phases were skipped and the feature was implemented directly from the prompt
+  mode:
+    $ref: FeatureMode.yaml
+    default: Regular
+    description: "Execution mode determining the workflow: Regular (full SDLC), Fast (direct implementation), or Exploration (iterative prototyping)"
   push:
     type: boolean
     default: false
@@ -73,6 +78,10 @@ properties:
     type: boolean
     default: false
     description: "Enable evidence collection after implementation (default: false)"
+  injectSkills:
+    type: boolean
+    default: false
+    description: "Inject curated skills into the feature worktree (default: false)"
   commitEvidence:
     type: boolean
     default: false
@@ -83,6 +92,17 @@ properties:
   worktreePath:
     type: string
     description: Absolute path to the git worktree for this feature
+  iterationCount:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    default: 0
+    description: Current feedback iteration count in exploration mode (0 when not exploring)
+  maxIterations:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Maximum allowed iterations for exploration mode (only set when mode is Exploration)
   pr:
     $ref: PullRequest.yaml
     description: Pull request data (null until PR created)
@@ -107,15 +127,17 @@ required:
   - lifecycle
   - messages
   - relatedArtifacts
-  - fast
+  - mode
   - push
   - openPr
   - forkAndPr
   - commitSpecs
   - ciWatchEnabled
   - enableEvidence
+  - injectSkills
   - commitEvidence
   - approvalGates
+  - iterationCount
 allOf:
   - $ref: SoftDeletableEntity.yaml
 description: Central entity tracking a piece of work through the SDLC lifecycle (Aggregate Root)

package/apis/json-schema/FeatureMode.yaml

@@ -0,0 +1,8 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureMode.yaml
+type: string
+enum:
+  - Regular
+  - Fast
+  - Exploration
+description: Execution mode determining the feature's workflow and agent graph

package/apis/json-schema/SdlcLifecycle.yaml

@@ -12,6 +12,7 @@ enum:
   - Maintain
   - Blocked
   - Pending
+  - Exploring
   - Deleting
   - AwaitingUpstream
   - Archived

package/apis/json-schema/SkillInjectionConfig.yaml

@@ -0,0 +1,17 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: SkillInjectionConfig.yaml
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: false
+    description: "Whether skill injection is enabled (default: false, opt-in)"
+  skills:
+    type: array
+    items:
+      $ref: SkillSource.yaml
+    description: List of skills to inject into feature worktrees
+required:
+  - enabled
+  - skills
+description: Skill injection configuration for feature worktrees

package/apis/json-schema/SkillSource.yaml

@@ -0,0 +1,21 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: SkillSource.yaml
+type: object
+properties:
+  name:
+    type: string
+    description: Unique skill directory name (e.g. 'architecture-reviewer')
+  type:
+    $ref: SkillSourceType.yaml
+    description: How this skill is provisioned (local copy or remote install)
+  source:
+    type: string
+    description: Source path (local) or npm package/URL (remote)
+  remoteSkillName:
+    type: string
+    description: Remote skill name passed to --skill flag (remote type only)
+required:
+  - name
+  - type
+  - source
+description: A skill source for injection into feature worktrees

package/apis/json-schema/SkillSourceType.yaml

@@ -0,0 +1,7 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: SkillSourceType.yaml
+type: string
+enum:
+  - local
+  - remote
+description: How a skill is provisioned into a worktree

package/apis/json-schema/WorkflowConfig.yaml

@@ -55,20 +55,28 @@ properties:
   hideCiStatus:
     type: boolean
     description: "Hide CI status badges from UI (default: true)"
-  defaultFastMode:
-    type: boolean
-    default: true
-    description: "Default new features to fast mode (default: true)"
+  defaultMode:
+    type: string
+    default: Fast
+    description: "Default feature mode for new features: 'Regular', 'Fast', or 'Exploration' (default: 'Fast')"
+  explorationMaxIterations:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Maximum exploration feedback iterations (default: 10, 0 = unlimited)"
   autoArchiveDelayMinutes:
     type: integer
     minimum: -2147483648
     maximum: 2147483647
     description: "Minutes after completion before auto-archiving a feature (default: 10, 0 = disabled)"
+  skillInjection:
+    $ref: SkillInjectionConfig.yaml
+    description: Skill injection configuration (optional, disabled by default)
 required:
   - openPrOnImplementationComplete
   - approvalGateDefaults
   - ciWatchEnabled
   - enableEvidence
   - commitEvidence
-  - defaultFastMode
+  - defaultMode
 description: Global workflow configuration defaults

package/dist/packages/core/src/application/ports/output/agents/feature-agent-process.interface.d.ts

@@ -9,7 +9,7 @@
  * - Application layer depends on this interface
  * - Infrastructure layer provides concrete implementation
  */
-import type { ApprovalGates, AgentType } from '../../../../domain/generated/output.js';
+import type { ApprovalGates, AgentType, FeatureMode } from '../../../../domain/generated/output.js';
 /**
  * Service interface for feature agent background process management.
  */
@@ -37,7 +37,7 @@ export interface IFeatureAgentProcessService {
         commitEvidence?: boolean;
         resumePayload?: string;
         agentType?: AgentType;
-        fast?: boolean;
+        mode?: FeatureMode;
         model?: string;
         resumeReason?: string;
     }): number;

package/dist/packages/core/src/application/ports/output/agents/feature-agent-process.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-process.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,MAAM,CAAC;IAEV;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}
+{"version":3,"file":"feature-agent-process.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,MAAM,CAAC;IAEV;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/packages/core/src/application/ports/output/services/index.d.ts

@@ -20,4 +20,5 @@ export type { IDeploymentService, DeploymentStatus } from './deployment-service.
 export type { IGitHubRepositoryService, GitHubRepo, GitHubOrganization, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl, } from './github-repository-service.interface.js';
 export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';
 export type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState, } from './interactive-session-service.interface.js';
+export type { ISkillInjectorService, SkillInjectionResult } from './skill-injector.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/packages/core/src/application/ports/output/services/skill-injector.interface.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Skill Injector Service Interface
+ *
+ * Output port for injecting curated agent skills into worktrees
+ * during feature creation. Handles local skill copying, remote skill
+ * installation via npx, idempotency checks, and .gitignore management.
+ */
+import type { SkillInjectionConfig } from '../../../../domain/generated/output.js';
+export interface SkillInjectionResult {
+    /** Names of skills that were successfully injected */
+    injected: string[];
+    /** Names of skills that were already present and skipped */
+    skipped: string[];
+    /** Skills that failed to inject, with error details */
+    failed: {
+        name: string;
+        error: string;
+    }[];
+}
+export interface ISkillInjectorService {
+    /**
+     * Inject curated skills into a worktree's .claude/skills/ directory.
+     *
+     * For each skill in the config:
+     * - Local skills are deep-copied from the source path
+     * - Remote skills are installed via `npx skills add`
+     * - Skills already present (SKILL.md exists) are skipped
+     * - Newly injected skills are added to .gitignore (unless already tracked in git)
+     *
+     * Individual skill failures are captured in the result (not thrown).
+     *
+     * @param worktreePath - Absolute path to the worktree root
+     * @param config - Skill injection configuration from settings
+     * @param repoRoot - Absolute path to the main repository root (for resolving local skill sources)
+     * @returns Counts of injected, skipped, and failed skills
+     */
+    inject(worktreePath: string, config: SkillInjectionConfig, repoRoot?: string): Promise<SkillInjectionResult>;
+}
+//# sourceMappingURL=skill-injector.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/skill-injector.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-injector.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/skill-injector.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC"}

package/dist/packages/core/src/application/ports/output/services/skill-injector.interface.js

@@ -0,0 +1,8 @@
+/**
+ * Skill Injector Service Interface
+ *
+ * Output port for injecting curated agent skills into worktrees
+ * during feature creation. Handles local skill copying, remote skill
+ * installation via npx, idempotency checks, and .gitignore management.
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/spec-initializer.interface.d.ts

@@ -22,15 +22,16 @@ export interface ISpecInitializerService {
      * - tasks.yaml
      * - feature.yaml
      *
-     * When mode is 'fast', only feature.yaml is created (no spec/research/plan/tasks).
+     * When mode is 'fast', only feature.yaml and spec.yaml are created.
+     * When mode is 'exploration', only feature.yaml is created.
      *
      * @param basePath - Directory to create specs/ in (typically the worktree path)
      * @param slug - Feature slug (kebab-case, e.g., "user-authentication")
      * @param featureNumber - Sequential feature number (will be zero-padded to 3 digits)
      * @param description - Feature description for template substitution
-     * @param mode - Optional mode; when 'fast', only feature.yaml is created
+     * @param mode - Optional mode; controls which template files are created
      * @returns The spec directory path and feature number used
      */
-    initialize(basePath: string, slug: string, featureNumber: number, description: string, mode?: 'fast'): Promise<SpecInitializerResult>;
+    initialize(basePath: string, slug: string, featureNumber: number, description: string, mode?: 'fast' | 'exploration'): Promise<SpecInitializerResult>;
 }
 //# sourceMappingURL=spec-initializer.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/spec-initializer.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-initializer.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/spec-initializer.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC"}
+{"version":3,"file":"spec-initializer.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/spec-initializer.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC"}

package/dist/packages/core/src/application/use-cases/agents/approve-agent-run.use-case.js

@@ -22,7 +22,7 @@ import { injectable, inject } from 'tsyringe';
 import yaml from 'js-yaml';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { AgentRunStatus } from '../../../domain/generated/output.js';
+import { AgentRunStatus, FeatureMode } from '../../../domain/generated/output.js';
 import { writeSpecFileAtomic, safeYamlDump, } from '../../../infrastructure/services/agents/feature-agent/nodes/node-helpers.js';
 import { computeWorktreePath } from '../../../infrastructure/services/ide-launchers/compute-worktree-path.js';
 let ApproveAgentRunUseCase = class ApproveAgentRunUseCase {
@@ -119,7 +119,7 @@ let ApproveAgentRunUseCase = class ApproveAgentRunUseCase {
             ...(payload ? { resumePayload: JSON.stringify(payload) } : {}),
             agentType: run.agentType,
             ...(run.modelId ? { model: run.modelId } : {}),
-            ...(feature?.fast ? { fast: true } : {}),
+            ...(feature?.mode && feature.mode !== FeatureMode.Regular ? { mode: feature.mode } : {}),
         });
         return { approved: true, reason: 'Approved and resumed' };
     }

package/dist/packages/core/src/application/use-cases/agents/reject-agent-run.use-case.js

@@ -21,7 +21,7 @@ import { injectable, inject } from 'tsyringe';
 import yaml from 'js-yaml';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { AgentRunStatus } from '../../../domain/generated/output.js';
+import { AgentRunStatus, FeatureMode } from '../../../domain/generated/output.js';
 import { writeSpecFileAtomic, safeYamlDump, } from '../../../infrastructure/services/agents/feature-agent/nodes/node-helpers.js';
 import { recordLifecycleEvent } from '../../../infrastructure/services/agents/feature-agent/phase-timing-context.js';
 import { computeWorktreePath } from '../../../infrastructure/services/ide-launchers/compute-worktree-path.js';
@@ -135,7 +135,7 @@ let RejectAgentRunUseCase = class RejectAgentRunUseCase {
             resumePayload: JSON.stringify(rejectionPayload),
             agentType: run.agentType,
             ...(run.modelId ? { model: run.modelId } : {}),
-            ...(feature.fast ? { fast: true } : {}),
+            ...(feature.mode !== FeatureMode.Regular ? { mode: feature.mode } : {}),
         });
         return {
             rejected: true,

package/dist/packages/core/src/application/use-cases/features/adopt-branch.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adopt-branch.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/adopt-branch.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,qCAAqC,CAAC;AAEhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAG7F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,qBACa,kBAAkB;IAG3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBANZ,WAAW,EAAE,kBAAkB,EAE/B,cAAc,EAAE,qBAAqB,EAErC,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8FlE;;;;OAIG;YACW,gBAAgB;IAiB9B;;;;OAIG;YACW,iBAAiB;IA4B/B;;;OAGG;YACW,iBAAiB;CAuBhC"}
+{"version":3,"file":"adopt-branch.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/adopt-branch.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,qCAAqC,CAAC;AAEhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAG7F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,qBACa,kBAAkB;IAG3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBANZ,WAAW,EAAE,kBAAkB,EAE/B,cAAc,EAAE,qBAAqB,EAErC,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgGlE;;;;OAIG;YACW,gBAAgB;IAiB9B;;;;OAIG;YACW,iBAAiB;IA4B/B;;;OAGG;YACW,iBAAiB;CAuBhC"}

package/dist/packages/core/src/application/use-cases/features/adopt-branch.use-case.js

@@ -23,7 +23,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
-import { SdlcLifecycle, PrStatus } from '../../../domain/generated/output.js';
+import { SdlcLifecycle, PrStatus, FeatureMode } from '../../../domain/generated/output.js';
 import { deriveName, deriveSlug } from './branch-name-utils.js';
 /** Branches that must not be adopted as features. */
 const PROTECTED_BRANCHES = new Set(['main', 'master']);
@@ -89,13 +89,15 @@ let AdoptBranchUseCase = class AdoptBranchUseCase {
             lifecycle,
             messages: [],
             relatedArtifacts: [],
-            fast: false,
+            mode: FeatureMode.Regular,
+            iterationCount: 0,
             push: false,
             openPr: hasOpenPr,
             forkAndPr: false,
             commitSpecs: true,
             ciWatchEnabled: true,
             enableEvidence: false,
+            injectSkills: false,
             commitEvidence: false,
             approvalGates: {
                 allowPrd: false,

package/dist/packages/core/src/application/use-cases/features/check-and-unblock-features.use-case.js

@@ -27,7 +27,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-import { SdlcLifecycle } from '../../../domain/generated/output.js';
+import { SdlcLifecycle, FeatureMode } from '../../../domain/generated/output.js';
 import { POST_IMPLEMENTATION } from '../../../domain/lifecycle-gates.js';
 let CheckAndUnblockFeaturesUseCase = class CheckAndUnblockFeaturesUseCase {
     featureRepo;
@@ -69,7 +69,7 @@ let CheckAndUnblockFeaturesUseCase = class CheckAndUnblockFeaturesUseCase {
                     ciWatchEnabled: child.ciWatchEnabled,
                     enableEvidence: child.enableEvidence,
                     commitEvidence: child.commitEvidence,
-                    ...(child.fast ? { fast: true } : {}),
+                    ...(child.mode !== FeatureMode.Regular ? { mode: child.mode } : {}),
                 });
             }
         }

package/dist/packages/core/src/application/use-cases/features/create/create-feature.use-case.d.ts

@@ -24,6 +24,7 @@ import type { ISpecInitializerService } from '../../../ports/output/services/spe
 import type { IRepositoryRepository } from '../../../ports/output/repositories/repository-repository.interface.js';
 import type { IGitPrService } from '../../../ports/output/services/git-pr-service.interface.js';
 import type { IAgentValidator } from '../../../ports/output/agents/agent-validator.interface.js';
+import type { ISkillInjectorService } from '../../../ports/output/services/skill-injector.interface.js';
 import { AttachmentStorageService } from '../../../../infrastructure/services/attachment-storage.service.js';
 import { MetadataGenerator } from './metadata-generator.js';
 import { SlugResolver } from './slug-resolver.js';
@@ -40,7 +41,8 @@ export declare class CreateFeatureUseCase {
     private readonly gitPrService;
     private readonly attachmentStorage;
     private readonly agentValidator;
-    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver, repositoryRepo: IRepositoryRepository, gitPrService: IGitPrService, attachmentStorage: AttachmentStorageService, agentValidator: IAgentValidator);
+    private readonly skillInjector;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver, repositoryRepo: IRepositoryRepository, gitPrService: IGitPrService, attachmentStorage: AttachmentStorageService, agentValidator: IAgentValidator, skillInjector: ISkillInjectorService);
     /**
      * Full synchronous execution: creates record, initializes worktree/spec, spawns agent.
      * Used by the CLI which shows a spinner and needs everything done before returning.

package/dist/packages/core/src/application/use-cases/features/create/create-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAMtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AAGjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBApBd,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa,EAE3B,iBAAiB,EAAE,wBAAwB,EAE3C,cAAc,EAAE,eAAe;IAGlD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwI1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAmJ1D"}
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAOtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAIxG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAtBb,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa,EAE3B,iBAAiB,EAAE,wBAAwB,EAE3C,cAAc,EAAE,eAAe,EAE/B,aAAa,EAAE,qBAAqB;IAGvD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiJ1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CA0K1D"}

package/dist/packages/core/src/application/use-cases/features/create/create-feature.use-case.js

@@ -29,8 +29,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
-import { SdlcLifecycle, AgentRunStatus, } from '../../../../domain/generated/output.js';
+import { SdlcLifecycle, AgentRunStatus, FeatureMode, } from '../../../../domain/generated/output.js';
 import { getSettings } from '../../../../infrastructure/services/settings.service.js';
+import { createDefaultSettings } from '../../../../domain/factories/settings-defaults.factory.js';
 import { POST_IMPLEMENTATION } from '../../../../domain/lifecycle-gates.js';
 import { AttachmentStorageService } from '../../../../infrastructure/services/attachment-storage.service.js';
 import { MetadataGenerator } from './metadata-generator.js';
@@ -47,7 +48,8 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
     gitPrService;
     attachmentStorage;
     agentValidator;
-    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, metadataGenerator, slugResolver, repositoryRepo, gitPrService, attachmentStorage, agentValidator) {
+    skillInjector;
+    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, metadataGenerator, slugResolver, repositoryRepo, gitPrService, attachmentStorage, agentValidator, skillInjector) {
         this.featureRepo = featureRepo;
         this.worktreeService = worktreeService;
         this.agentProcess = agentProcess;
@@ -59,6 +61,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         this.gitPrService = gitPrService;
         this.attachmentStorage = attachmentStorage;
         this.agentValidator = agentValidator;
+        this.skillInjector = skillInjector;
     }
     /**
      * Full synchronous execution: creates record, initializes worktree/spec, spawns agent.
@@ -75,9 +78,12 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
      * No AI calls, no git operations — just DB writes.
      */
     async createRecord(input) {
-        let initialLifecycle = input.fast
-            ? SdlcLifecycle.Implementation
-            : SdlcLifecycle.Requirements;
+        const effectiveMode = input.mode ?? FeatureMode.Regular;
+        let initialLifecycle = effectiveMode === FeatureMode.Exploration
+            ? SdlcLifecycle.Exploring
+            : effectiveMode === FeatureMode.Fast
+                ? SdlcLifecycle.Implementation
+                : SdlcLifecycle.Requirements;
         let shouldSpawn = true;
         let effectiveRepoPath = input.repositoryPath.replace(/\\/g, '/');
         // Pending flag takes precedence — user explicitly defers agent execution.
@@ -150,19 +156,24 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             lifecycle: initialLifecycle,
             messages: [],
             relatedArtifacts: [],
-            fast: input.fast ?? false,
+            mode: effectiveMode,
             push: input.push ?? false,
             openPr: input.openPr ?? false,
             forkAndPr: input.forkAndPr ?? false,
             commitSpecs: input.commitSpecs ?? true,
             ciWatchEnabled: input.ciWatchEnabled ?? true,
             enableEvidence: input.enableEvidence ?? false,
+            injectSkills: input.injectSkills ?? false,
             commitEvidence: input.commitEvidence ?? false,
             approvalGates: input.approvalGates ?? {
                 allowPrd: false,
                 allowPlan: false,
                 allowMerge: false,
             },
+            iterationCount: 0,
+            ...(effectiveMode === FeatureMode.Exploration && {
+                maxIterations: getSettings().workflow.explorationMaxIterations ?? 10,
+            }),
             agentRunId: runId,
             specPath: '',
             repositoryId: repository.id,
@@ -227,7 +238,11 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         const worktreePath = this.worktreeService.getWorktreePath(effectiveRepoPath, branch);
         await this.worktreeService.create(effectiveRepoPath, branch, worktreePath, defaultBranch);
         // Initialize spec directory — full user input goes into spec.yaml as-is
-        const { specDir } = await this.specInitializer.initialize(worktreePath, slug, featureNumber, input.userInput, input.fast ? 'fast' : undefined);
+        const { specDir } = await this.specInitializer.initialize(worktreePath, slug, featureNumber, input.userInput, feature.mode === FeatureMode.Fast
+            ? 'fast'
+            : feature.mode === FeatureMode.Exploration
+                ? 'exploration'
+                : undefined);
         // Commit pending attachments if sessionId was provided (web UI flow)
         let committedAttachments = input.attachments;
         if (input.sessionId) {
@@ -255,6 +270,20 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 // Attachment storage failure should not block feature creation
             }
         }
+        // Inject curated skills into the worktree (opt-in, guarded by settings or CLI flag)
+        const settings = getSettings();
+        const shouldInject = input.injectSkills ?? settings.workflow.skillInjection?.enabled ?? false;
+        let injectedSkillNames;
+        const skillConfig = settings.workflow.skillInjection ?? createDefaultSettings().workflow.skillInjection;
+        if (shouldInject && skillConfig.skills?.length) {
+            try {
+                const result = await this.skillInjector.inject(worktreePath, skillConfig, effectiveRepoPath);
+                injectedSkillNames = [...result.injected, ...result.skipped];
+            }
+            catch {
+                // Skill injection failure must not block feature creation (NFR-3)
+            }
+        }
         // Update feature record with refined metadata, branch, specPath, and attachments
         const updatedFeature = {
             ...feature,
@@ -264,6 +293,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             branch,
             specPath: specDir,
             ...(committedAttachments?.length ? { attachments: committedAttachments } : {}),
+            ...(injectedSkillNames?.length ? { injectedSkills: injectedSkillNames } : {}),
             updatedAt: new Date(),
         };
         await this.featureRepo.update(updatedFeature);
@@ -273,7 +303,6 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             // a background worker — prevents the feature from getting stuck
             // with a silent failure in the detached worker process.
             // Skip validation when using mock executor (E2E tests, CI without real agents).
-            const settings = getSettings();
             const effectiveAgentType = input.agentType ?? settings.agent.type;
             const isMockExecutor = process.env.SHEP_MOCK_EXECUTOR === '1';
             const validation = isMockExecutor
@@ -305,7 +334,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 ciWatchEnabled: input.ciWatchEnabled ?? true,
                 enableEvidence: input.enableEvidence ?? false,
                 commitEvidence: input.commitEvidence ?? false,
-                ...(input.fast ? { fast: true } : {}),
+                ...(feature.mode !== FeatureMode.Regular ? { mode: feature.mode } : {}),
                 ...(input.agentType ? { agentType: input.agentType } : {}),
                 ...(input.model ? { model: input.model } : {}),
             });
@@ -326,7 +355,8 @@ CreateFeatureUseCase = __decorate([
     __param(8, inject('IGitPrService')),
     __param(9, inject(AttachmentStorageService)),
     __param(10, inject('IAgentValidator')),
+    __param(11, inject('ISkillInjectorService')),
     __metadata("design:paramtypes", [Object, Object, Object, Object, Object, MetadataGenerator,
-        SlugResolver, Object, Object, AttachmentStorageService, Object])
+        SlugResolver, Object, Object, AttachmentStorageService, Object, Object])
 ], CreateFeatureUseCase);
 export { CreateFeatureUseCase };

package/dist/packages/core/src/application/use-cases/features/create/types.d.ts

@@ -1,4 +1,5 @@
 import type { ApprovalGates, Attachment, Feature } from '../../../../domain/generated/output.js';
+import { type FeatureMode } from '../../../../domain/generated/output.js';
 export interface CreateFeatureInput {
     userInput: string;
     repositoryPath: string;
@@ -11,8 +12,8 @@ export interface CreateFeatureInput {
     name?: string;
     /** Pre-supplied description (skips AI metadata extraction for description). */
     description?: string;
-    /** When true, skip SDLC phases and implement directly from the user prompt. */
-    fast?: boolean;
+    /** Execution mode: Regular (full SDLC), Fast (direct implementation), or Exploration (iterative prototyping). */
+    mode?: FeatureMode;
     /** Fork repo and create PR to upstream at merge time (default: false). */
     forkAndPr?: boolean;
     /** Commit specs/evidences into the repo (default: true, auto-false when forkAndPr). */
@@ -37,6 +38,8 @@ export interface CreateFeatureInput {
     attachmentPaths?: string[];
     /** Sync the default branch from remote before creating the feature branch (default: true). */
     rebaseBeforeBranch?: boolean;
+    /** Inject curated skills into the worktree (overrides settings.workflow.skillInjection.enabled). */
+    injectSkills?: boolean;
 }
 export interface CreateFeatureResult {
     feature: Feature;

package/dist/packages/core/src/application/use-cases/features/create/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iHAAiH;IACjH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/packages/core/src/application/use-cases/features/delete-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBALP,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB,EAClC,YAAY,EAAE,aAAa;IAGjE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BlF,oGAAoG;YACtF,gBAAgB;IAW9B,0DAA0D;YAC5C,iBAAiB;IAQ/B,6DAA6D;YAC/C,yBAAyB;IAevC,sDAAsD;YACxC,sBAAsB;IAYpC,6EAA6E;YAC/D,oBAAoB;CA+EnC"}
+{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBALP,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB,EAClC,YAAY,EAAE,aAAa;IAGjE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BlF,oGAAoG;YACtF,gBAAgB;IAW9B,0DAA0D;YAC5C,iBAAiB;IAQ/B,6DAA6D;YAC/C,yBAAyB;IAevC,sDAAsD;YACxC,sBAAsB;IAYpC,6EAA6E;YAC/D,oBAAoB;CAyFnC"}