feat: enhance run profile management with presets and UI integration

Author: ddurzo

README.md

@@ -18,23 +18,29 @@ Sessions are persistent. You can continue the same session with an additional re
 
 ## Pipeline
 
-Default 12-step flow — each step can be toggled, reassigned to a different model, or given a custom skill file:
+Default pipeline — each step can be toggled, reassigned to a different model, or given a custom skill file:
 
 | # | Step | Default model |
 |---|---|---|
 | 1 | 📋 Refine Specification | claude-sonnet-4-6 |
 | 2 | 🏛 Architecture Breakdown | claude-sonnet-4-6 |
-| 3 | 🗺 Development Plan | claude-sonnet-4-6 |
+| 3 | 🗺 Development Plan _(full profile)_ | claude-sonnet-4-6 |
 | 4 | 🧭 Formal Pre-Check | gpt-5.4 |
 | 5 | 🛠 Implement | claude-sonnet-4-6 |
 | 6 | 🔍 Technical Review | gpt-5.4 |
 | 7 | 🧯 Fix Findings _(runs only if issues found)_ | claude-sonnet-4-6 |
-| 8 | 🧪 Tests & Verification | claude-sonnet-4-6 |
-| 9 | 🔒 Security Review | gpt-5.4 |
-| 10 | 📚 Documentation | gpt-5.4-mini |
-| 11 | 💥 Runtime Hard Check _(optional, disabled by default)_ | claude-sonnet-4-6 |
+| 8 | 🧪 Tests & Verification _(full profile)_ | claude-sonnet-4-6 |
+| 9 | 🔒 Security Review _(full profile)_ | gpt-5.4 |
+| 10 | 📚 Documentation _(full profile)_ | gpt-5.4-mini |
+| 11 | 💥 Runtime Hard Check _(full profile / optional)_ | claude-sonnet-4-6 |
 | 12 | ✅ Final Report | gpt-5.4-mini |
 
+Recommended run profiles:
+
+- `lite` — `spec`, `implement`, `review`, `fix`, `final-report`
+- `standard` — `spec`, `architecture`, `formal-precheck`, `implement`, `review`, `fix`, `final-report`
+- `full` — enables every step, including planning, test/security/docs, and hard-check
+
 ## Token strategy
 
 - Step outputs are structured JSON — compact and machine-parseable
@@ -103,6 +109,8 @@ The new `🧭 Formal Pre-Check` step runs before implementation and is meant to
 - logic gaps and sequencing errors
 - structural coupling that would make implementation brittle
 
+For UI-heavy tasks, prefer assigning the optional skill [ui-direction.md](/Users/ddurzo/Development/misc/agentic-flow/skills/ui-direction.md) to `architecture` or `formal-precheck` instead of adding a permanent extra step to every run.
+
 Current auto-detection order:
 
 - existing `docker-compose.yml` / `compose.yaml`

skills/ui-direction.md

@@ -0,0 +1,22 @@
+# Role: UI Direction Lead
+
+Define the visual and interaction direction before frontend implementation starts.
+
+## Output
+
+1. **Visual intent** — the design mood, hierarchy, and clarity goals
+2. **Core interaction rules** — navigation, affordances, loading/error/empty states
+3. **Accessibility guardrails** — contrast, keyboard flow, semantics, focus visibility
+4. **Responsive guardrails** — what must remain stable across desktop and mobile
+5. **Implementation guardrails** — the constraints the coding step must preserve
+
+## Rules
+
+- Do not produce code.
+- Do not redesign the product unless the task explicitly asks for it.
+- If an existing design system or product language exists, stay within it.
+- If no visual direction exists, define one clearly and simply; avoid generic UI filler.
+- Focus on decisions that reduce ambiguity during implementation.
+- Call out UX contradictions, unclear flows, or states that are missing from the current plan.
+
+Finish with the `agenticflow` JSON block.

src/configManager.ts

@@ -4,7 +4,7 @@
 import * as vscode from 'vscode';
 import * as fs from 'fs';
 import * as path from 'path';
-import type { AgenticFlowConfig, SessionState, StepConfig } from './types';
+import type { AgenticFlowConfig, RunProfileId, SessionState, StepConfig } from './types';
 
 const DEFAULT_STORAGE_DIR = '.agentic-flow';
 const CONFIG_BASENAME = 'config.json';
@@ -13,6 +13,24 @@ const SESSION_BASENAME = 'session.json';
 const RUNTIME_ENV_BASENAME = 'runtime.env';
 const SKILLS_DIRNAME = 'skills';
 
+export const RUN_PROFILE_PRESETS: Record<Exclude<RunProfileId, 'custom'>, { label: string; description: string; enabledStepIds: string[] }> = {
+  lite: {
+    label: 'Lite',
+    description: 'Fastest practical flow for small or iterative changes.',
+    enabledStepIds: ['spec', 'implement', 'review', 'fix', 'final-report'],
+  },
+  standard: {
+    label: 'Standard',
+    description: 'Balanced flow with architecture and formal pre-check before coding.',
+    enabledStepIds: ['spec', 'architecture', 'formal-precheck', 'implement', 'review', 'fix', 'final-report'],
+  },
+  full: {
+    label: 'Full',
+    description: 'Extended flow with planning, testing, security, docs and runtime verification.',
+    enabledStepIds: ['spec', 'architecture', 'implementation-plan', 'formal-precheck', 'implement', 'review', 'fix', 'test', 'security', 'docs', 'hard-check', 'final-report'],
+  },
+};
+
 const DEFAULT_STEPS: StepConfig[] = [
   {
     id: 'spec',
@@ -37,7 +55,7 @@ const DEFAULT_STEPS: StepConfig[] = [
   {
     id: 'implementation-plan',
     name: '🗺 Development Plan',
-    enabled: true,
+    enabled: false,
     model: 'claude-sonnet-4-6',
     skill: '.agentic-flow/skills/implementation-plan.md',
     contextMode: 'summary',
@@ -88,7 +106,7 @@ const DEFAULT_STEPS: StepConfig[] = [
   {
     id: 'test',
     name: '🧪 Tests & Verification',
-    enabled: true,
+    enabled: false,
     model: 'claude-sonnet-4-6',
     skill: '.agentic-flow/skills/testing.md',
     contextMode: 'summary',
@@ -98,7 +116,7 @@ const DEFAULT_STEPS: StepConfig[] = [
   {
     id: 'security',
     name: '🔒 Security Review',
-    enabled: true,
+    enabled: false,
     model: 'gpt-5.4',
     skill: '.agentic-flow/skills/security.md',
     contextMode: 'summary',
@@ -108,7 +126,7 @@ const DEFAULT_STEPS: StepConfig[] = [
   {
     id: 'docs',
     name: '📚 Documentation',
-    enabled: true,
+    enabled: false,
     model: 'gpt-5.4-mini',
     skill: '.agentic-flow/skills/docs.md',
     contextMode: 'summary',
@@ -145,6 +163,7 @@ const DEFAULT_STEPS: StepConfig[] = [
 
 export const DEFAULT_CONFIG: AgenticFlowConfig = {
   version: '2.0',
+  runProfile: 'standard',
   steps: DEFAULT_STEPS,
   stateFile: path.join(DEFAULT_STORAGE_DIR, STATE_BASENAME),
   sessionFile: path.join(DEFAULT_STORAGE_DIR, SESSION_BASENAME),
@@ -195,6 +214,7 @@ export function loadConfig(): AgenticFlowConfig {
     return {
       ...DEFAULT_CONFIG,
       ...parsed,
+      runProfile: normalizeRunProfile(parsed.runProfile),
       steps: mergeSteps(parsed.steps),
       runtime: {
         ...DEFAULT_CONFIG.runtime,
@@ -234,12 +254,25 @@ function mergeSteps(parsedSteps?: StepConfig[]): StepConfig[] {
   return merged;
 }
 
+export function normalizeRunProfile(profile?: string): RunProfileId {
+  return profile === 'lite' || profile === 'standard' || profile === 'full' || profile === 'custom'
+    ? profile
+    : 'standard';
+}
+
+export function applyRunProfileToSteps(steps: StepConfig[], profile: RunProfileId): StepConfig[] {
+  if (profile === 'custom') return structuredClone(steps);
+  const preset = RUN_PROFILE_PRESETS[profile];
+  const enabled = new Set(preset.enabledStepIds);
+  return steps.map(step => ({ ...step, enabled: enabled.has(step.id) }));
+}
+
 export function saveConfig(config: AgenticFlowConfig): void {
   const dir = getAgenticFlowDir();
   if (!dir) throw new Error('No workspace open');
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
   const p = path.join(dir, CONFIG_BASENAME);
-  fs.writeFileSync(p, JSON.stringify(config, null, 2), 'utf8');
+  fs.writeFileSync(p, JSON.stringify({ ...config, runProfile: normalizeRunProfile(config.runProfile) }, null, 2), 'utf8');
 }
 
 export async function initWorkspace(defaultModel?: string): Promise<void> {

src/types.ts

@@ -8,6 +8,7 @@ export type RunMode = 'new' | 'continue';
 export type StepRunCondition = 'always' | 'ifIssues';
 export type StepResultStatus = 'ok' | 'issues' | 'blocked';
 export type StepExecutor = 'model' | 'hard-check';
+export type RunProfileId = 'lite' | 'standard' | 'full' | 'custom';
 export type ModelSource = 'cli' | 'api' | 'vscode';
 export type TokenAccounting = 'estimated' | 'reported';
 export type ApiProviderId = 'openai' | 'anthropic' | 'xai' | 'openrouter' | 'ollama';
@@ -103,6 +104,7 @@ export interface HardCheckConfig {
 
 export interface AgenticFlowConfig {
   version: string;
+  runProfile?: RunProfileId;
   steps: StepConfig[];
   stateFile?: string;
   sessionFile?: string;