red64-cli 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Core type system for flow orchestration
+ * Requirements: 1.1, 1.2, 4.1-4.7, 5.1-5.5
+ */
+/**
+ * Status type for UI states
+ */
+export type Status = 'pending' | 'running' | 'success' | 'error' | 'warning';
+/**
+ * Command type union for all supported commands
+ * Requirements: 4.1-4.7
+ */
+export type Command = 'init' | 'start' | 'status' | 'list' | 'abort' | 'help' | undefined;
+/**
+ * GlobalFlags interface for CLI options
+ * Requirements: 5.1-5.5
+ */
+/**
+ * Supported coding agents
+ */
+export type CodingAgent = 'claude' | 'gemini' | 'codex';
+/**
+ * Model options per agent
+ * Cheap models for development, expensive for production
+ */
+export declare const AGENT_MODELS: Record<CodingAgent, {
+    cheap: string;
+    best: string;
+    all: readonly string[];
+}>;
+export interface GlobalFlags {
+    readonly skipPermissions: boolean;
+    readonly brownfield: boolean;
+    readonly greenfield: boolean;
+    readonly tier: string | undefined;
+    readonly help: boolean;
+    readonly version: boolean;
+    readonly verbose: boolean;
+    readonly yes: boolean;
+    readonly sandbox: boolean;
+    readonly model?: string;
+    readonly repo?: string;
+    readonly stack?: string;
+    readonly 'skip-guided'?: boolean;
+    readonly 'no-steering'?: boolean;
+    readonly 'no-cache'?: boolean;
+    readonly agent?: CodingAgent;
+}
+/**
+ * CLIConfig interface combining command, args, and flags
+ * Requirements: 4.1-4.7, 5.1-5.5
+ */
+export interface CLIConfig {
+    readonly command: Command;
+    readonly args: readonly string[];
+    readonly flags: GlobalFlags;
+}
+/**
+ * FlowPhase discriminated union covering all workflow states
+ * Requirement: 1.1 - Deterministic state machine
+ */
+export type FlowPhase = {
+    type: 'idle';
+} | {
+    type: 'initializing';
+    feature: string;
+    description: string;
+} | {
+    type: 'requirements-generating';
+    feature: string;
+} | {
+    type: 'requirements-review';
+    feature: string;
+} | {
+    type: 'design-generating';
+    feature: string;
+} | {
+    type: 'design-review';
+    feature: string;
+} | {
+    type: 'tasks-generating';
+    feature: string;
+} | {
+    type: 'tasks-review';
+    feature: string;
+} | {
+    type: 'implementing';
+    feature: string;
+    currentTask: number;
+    totalTasks: number;
+} | {
+    type: 'complete';
+    feature: string;
+} | {
+    type: 'aborted';
+    feature: string;
+    reason: string;
+} | {
+    type: 'error';
+    feature: string;
+    error: string;
+};
+/**
+ * FlowEvent discriminated union for all valid state transitions
+ * Requirement: 1.1 - Deterministic state machine
+ */
+export type FlowEvent = {
+    type: 'START';
+    feature: string;
+    description: string;
+} | {
+    type: 'RESUME';
+    feature: string;
+} | {
+    type: 'PHASE_COMPLETE';
+} | {
+    type: 'APPROVE';
+} | {
+    type: 'REJECT';
+} | {
+    type: 'ABORT';
+    reason: string;
+} | {
+    type: 'ERROR';
+    error: string;
+};
+/**
+ * Phase completion metrics for tracking timing per phase
+ */
+export interface PhaseMetric {
+    readonly startedAt: string;
+    readonly completedAt?: string;
+    readonly elapsedMs?: number;
+}
+/**
+ * Task progress tracking for implementation phase
+ */
+export interface TaskProgress {
+    readonly completedTasks: readonly string[];
+    readonly totalTasks: number;
+}
+/**
+ * FlowState interface with feature, phase, timestamps, history, and metadata
+ * Requirement: 1.5 - State persistence
+ */
+export interface FlowState {
+    readonly feature: string;
+    readonly phase: FlowPhase;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly history: readonly FlowPhase[];
+    readonly metadata: {
+        readonly description: string;
+        readonly mode: 'greenfield' | 'brownfield';
+        readonly tier?: string;
+        readonly worktreePath?: string;
+        readonly prUrl?: string;
+        readonly prNumber?: number;
+        readonly resolvedFeatureName?: string;
+    };
+    readonly taskProgress?: TaskProgress;
+    readonly phaseMetrics?: {
+        readonly [phaseType: string]: PhaseMetric;
+    };
+}
+/**
+ * Agent invocation options for Claude CLI execution
+ * Requirements: 7.1, 7.2, 7.5, 7.6
+ */
+export interface AgentInvokeOptions {
+    readonly prompt: string;
+    readonly workingDirectory: string;
+    readonly skipPermissions: boolean;
+    readonly tier: string | undefined;
+    readonly model?: string;
+    readonly sandbox?: boolean;
+    readonly onOutput?: (chunk: string) => void;
+    readonly onError?: (chunk: string) => void;
+    readonly timeout?: number;
+}
+/**
+ * Claude CLI error codes for specific failure types
+ */
+export type ClaudeErrorCode = 'CREDIT_EXHAUSTED' | 'RATE_LIMITED' | 'AUTH_FAILED' | 'MODEL_UNAVAILABLE' | 'CONTEXT_EXCEEDED' | 'NETWORK_ERROR' | 'PERMISSION_DENIED' | 'UNKNOWN';
+/**
+ * Parsed Claude error with actionable information
+ */
+export interface ClaudeError {
+    readonly code: ClaudeErrorCode;
+    readonly message: string;
+    readonly recoverable: boolean;
+    readonly suggestion: string;
+    readonly retryAfterMs?: number;
+}
+/**
+ * Agent invocation result from Claude CLI
+ * Requirements: 7.1, 7.2, 7.5, 7.6
+ */
+export interface AgentResult {
+    readonly success: boolean;
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly timedOut: boolean;
+    readonly claudeError?: ClaudeError;
+}
+export { type ExtendedFlowPhase, type ExtendedFlowEvent, type ExtendedFlowState, type WorkflowMode, GREENFIELD_PHASES, BROWNFIELD_PHASES, isApprovalPhase, isGeneratingPhase, isTerminalPhase, getPhaseSequence } from './extended-flow.js';
+export type { GitStatus } from '../services/GitStatusChecker.js';
+export type { PRStatus } from '../services/PRStatusFetcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,28 @@
+/**
+ * Core type system for flow orchestration
+ * Requirements: 1.1, 1.2, 4.1-4.7, 5.1-5.5
+ */
+/**
+ * Model options per agent
+ * Cheap models for development, expensive for production
+ */
+export const AGENT_MODELS = {
+    claude: {
+        cheap: 'claude-3-5-haiku-latest',
+        best: 'claude-sonnet-4-20250514',
+        all: ['claude-3-5-haiku-latest', 'claude-3-5-sonnet-latest', 'claude-sonnet-4-20250514', 'claude-opus-4-20250514']
+    },
+    gemini: {
+        cheap: 'gemini-2.0-flash',
+        best: 'gemini-2.5-pro',
+        all: ['gemini-2.0-flash', 'gemini-2.0-flash-lite', 'gemini-2.5-pro', 'gemini-2.5-flash']
+    },
+    codex: {
+        cheap: 'gpt-4o-mini',
+        best: 'o1',
+        all: ['gpt-4o-mini', 'gpt-4o', 'o1-mini', 'o1', 'o3-mini']
+    }
+};
+// Re-export extended flow types
+export { GREENFIELD_PHASES, BROWNFIELD_PHASES, isApprovalPhase, isGeneratingPhase, isTerminalPhase, getPhaseSequence } from './extended-flow.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiF;IACxG,MAAM,EAAE;QACN,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,0BAA0B;QAChC,GAAG,EAAE,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,wBAAwB,CAAC;KACnH;IACD,MAAM,EAAE;QACN,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;KACzF;IACD,KAAK,EAAE;QACL,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC;KAC3D;CACF,CAAC;AAgKF,gCAAgC;AAChC,OAAO,EAKL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EACjB,MAAM,oBAAoB,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Git operations placeholder
+ * Requirements: 1.4 - Execute git operations directly via TypeScript
+ *
+ * NOTE: Actual implementation deferred to red64-flow-core spec.
+ * This file provides interfaces and placeholder functions.
+ */
+/**
+ * Git operation result
+ */
+export interface GitResult {
+    readonly success: boolean;
+    readonly output: string;
+    readonly error: string | undefined;
+}
+/**
+ * Create a git worktree
+ * Requirements: 1.4 - Git worktree operations
+ */
+export declare function createWorktree(_repoPath: string, _worktreePath: string, _branch: string): Promise<GitResult>;
+/**
+ * Create a git branch
+ * Requirements: 1.4 - Git branch operations
+ */
+export declare function createBranch(_repoPath: string, _branchName: string, _baseBranch?: string): Promise<GitResult>;
+/**
+ * Commit changes
+ * Requirements: 1.4 - Git commit operations
+ */
+export declare function commit(_repoPath: string, _message: string, _files?: readonly string[]): Promise<GitResult>;
+/**
+ * Push to remote
+ * Requirements: 1.4 - Git push operations
+ */
+export declare function push(_repoPath: string, _remote?: string, _branch?: string): Promise<GitResult>;
+/**
+ * Remove worktree
+ * Requirements: 1.4 - Git worktree cleanup
+ */
+export declare function removeWorktree(_repoPath: string, _worktreePath: string): Promise<GitResult>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,SAAS,CAAC,CAOpB"}

package/dist/utils/git.js

@@ -0,0 +1,68 @@
+/**
+ * Git operations placeholder
+ * Requirements: 1.4 - Execute git operations directly via TypeScript
+ *
+ * NOTE: Actual implementation deferred to red64-flow-core spec.
+ * This file provides interfaces and placeholder functions.
+ */
+/**
+ * Create a git worktree
+ * Requirements: 1.4 - Git worktree operations
+ */
+export async function createWorktree(_repoPath, _worktreePath, _branch) {
+    // Placeholder - implementation in red64-flow-core
+    return {
+        success: true,
+        output: 'Worktree creation placeholder',
+        error: undefined
+    };
+}
+/**
+ * Create a git branch
+ * Requirements: 1.4 - Git branch operations
+ */
+export async function createBranch(_repoPath, _branchName, _baseBranch) {
+    // Placeholder - implementation in red64-flow-core
+    return {
+        success: true,
+        output: 'Branch creation placeholder',
+        error: undefined
+    };
+}
+/**
+ * Commit changes
+ * Requirements: 1.4 - Git commit operations
+ */
+export async function commit(_repoPath, _message, _files) {
+    // Placeholder - implementation in red64-flow-core
+    return {
+        success: true,
+        output: 'Commit placeholder',
+        error: undefined
+    };
+}
+/**
+ * Push to remote
+ * Requirements: 1.4 - Git push operations
+ */
+export async function push(_repoPath, _remote, _branch) {
+    // Placeholder - implementation in red64-flow-core
+    return {
+        success: true,
+        output: 'Push placeholder',
+        error: undefined
+    };
+}
+/**
+ * Remove worktree
+ * Requirements: 1.4 - Git worktree cleanup
+ */
+export async function removeWorktree(_repoPath, _worktreePath) {
+    // Placeholder - implementation in red64-flow-core
+    return {
+        success: true,
+        output: 'Worktree removal placeholder',
+        error: undefined
+    };
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,aAAqB,EACrB,OAAe;IAEf,kDAAkD;IAClD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,+BAA+B;QACvC,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,WAAmB,EACnB,WAAoB;IAEpB,kDAAkD;IAClD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,6BAA6B;QACrC,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAAiB,EACjB,QAAgB,EAChB,MAA0B;IAE1B,kDAAkD;IAClD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,oBAAoB;QAC5B,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,SAAiB,EACjB,OAAgB,EAChB,OAAgB;IAEhB,kDAAkD;IAClD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,kBAAkB;QAC1B,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,aAAqB;IAErB,kDAAkD;IAClD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,8BAA8B;QACtC,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utilities index
+ */
+export * from './paths.js';
+export * from './git.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utilities index
+ */
+export * from './paths.js';
+export * from './git.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Path utilities for red64
+ * Requirements: 8.2 - Use .red64/ as the unified directory
+ */
+/**
+ * Get the red64 directory path
+ * Requirements: 8.2 - Use .red64/ directory structure
+ */
+export declare function getRed64Dir(baseDir: string): string;
+/**
+ * Get the flows directory path
+ */
+export declare function getFlowsDir(baseDir: string): string;
+/**
+ * Get the specs directory path
+ */
+export declare function getSpecsDir(baseDir: string): string;
+/**
+ * Get the steering directory path
+ */
+export declare function getSteeringDir(baseDir: string): string;
+/**
+ * Get feature flow directory path
+ */
+export declare function getFeatureDir(baseDir: string, feature: string): string;
+/**
+ * Get feature state file path
+ */
+export declare function getStatePath(baseDir: string, feature: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/utils/paths.js

@@ -0,0 +1,43 @@
+/**
+ * Path utilities for red64
+ * Requirements: 8.2 - Use .red64/ as the unified directory
+ */
+import { join } from 'node:path';
+/**
+ * Get the red64 directory path
+ * Requirements: 8.2 - Use .red64/ directory structure
+ */
+export function getRed64Dir(baseDir) {
+    return join(baseDir, '.red64');
+}
+/**
+ * Get the flows directory path
+ */
+export function getFlowsDir(baseDir) {
+    return join(getRed64Dir(baseDir), 'flows');
+}
+/**
+ * Get the specs directory path
+ */
+export function getSpecsDir(baseDir) {
+    return join(getRed64Dir(baseDir), 'specs');
+}
+/**
+ * Get the steering directory path
+ */
+export function getSteeringDir(baseDir) {
+    return join(getRed64Dir(baseDir), 'steering');
+}
+/**
+ * Get feature flow directory path
+ */
+export function getFeatureDir(baseDir, feature) {
+    return join(getFlowsDir(baseDir), feature);
+}
+/**
+ * Get feature state file path
+ */
+export function getStatePath(baseDir, feature) {
+    return join(getFeatureDir(baseDir, feature), 'state.json');
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAe;IAC5D,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAe;IAC3D,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC"}

package/framework/.red64/settings/rules/design-discovery-full.md

@@ -0,0 +1,93 @@
+# Full Discovery Process for Technical Design
+
+## Objective
+Conduct comprehensive research and analysis to ensure the technical design is based on complete, accurate, and up-to-date information.
+
+## Discovery Steps
+
+### 1. Requirements Analysis
+**Map Requirements to Technical Needs**
+- Extract all functional requirements from EARS format
+- Identify non-functional requirements (performance, security, scalability)
+- Determine technical constraints and dependencies
+- List core technical challenges
+
+### 2. Existing Implementation Analysis
+**Understand Current System** (if modifying/extending):
+- Analyze codebase structure and architecture patterns
+- Map reusable components, services, utilities
+- Identify domain boundaries and data flows
+- Document integration points and dependencies
+- Determine approach: extend vs refactor vs wrap
+
+### 3. Technology Research
+**Investigate Best Practices and Solutions**:
+- **Use WebSearch** to find:
+  - Latest architectural patterns for similar problems
+  - Industry best practices for the technology stack
+  - Recent updates or changes in relevant technologies
+  - Common pitfalls and solutions
+
+- **Use WebFetch** to analyze:
+  - Official documentation for frameworks/libraries
+  - API references and usage examples
+  - Migration guides and breaking changes
+  - Performance benchmarks and comparisons
+
+### 4. External Dependencies Investigation
+**For Each External Service/Library**:
+- Search for official documentation and GitHub repositories
+- Verify API signatures and authentication methods
+- Check version compatibility with existing stack
+- Investigate rate limits and usage constraints
+- Find community resources and known issues
+- Document security considerations
+- Note any gaps requiring implementation investigation
+
+### 5. Architecture Pattern & Boundary Analysis
+**Evaluate Architectural Options**:
+- Compare relevant patterns (MVC, Clean, Hexagonal, Event-driven)
+- Assess fit with existing architecture and steering principles
+- Identify domain boundaries and ownership seams required to avoid team conflicts
+- Consider scalability implications and operational concerns
+- Evaluate maintainability and team expertise
+- Document preferred pattern and rejected alternatives in `research.md`
+
+### 6. Risk Assessment
+**Identify Technical Risks**:
+- Performance bottlenecks and scaling limits
+- Security vulnerabilities and attack vectors
+- Integration complexity and coupling
+- Technical debt creation vs resolution
+- Knowledge gaps and training needs
+
+## Research Guidelines
+
+### When to Search
+**Always search for**:
+- External API documentation and updates
+- Security best practices for authentication/authorization
+- Performance optimization techniques for identified bottlenecks
+- Latest versions and migration paths for dependencies
+
+**Search if uncertain about**:
+- Architectural patterns for specific use cases
+- Industry standards for data formats/protocols
+- Compliance requirements (GDPR, HIPAA, etc.)
+- Scalability approaches for expected load
+
+### Search Strategy
+1. Start with official sources (documentation, GitHub)
+2. Check recent blog posts and articles (last 6 months)
+3. Review Stack Overflow for common issues
+4. Investigate similar open-source implementations
+
+## Output Requirements
+Capture all findings that impact design decisions in `research.md` using the shared template:
+- Key insights affecting architecture, technology alignment, and contracts
+- Constraints discovered during research
+- Recommended approaches and selected architecture pattern with rationale
+- Rejected alternatives and trade-offs (documented in the Design Decisions section)
+- Updated domain boundaries that inform Components & Interface Contracts
+- Risks and mitigation strategies
+- Gaps requiring further investigation during implementation

package/framework/.red64/settings/rules/design-discovery-light.md

@@ -0,0 +1,49 @@
+# Light Discovery Process for Extensions
+
+## Objective
+Quickly analyze existing system and integration requirements for feature extensions.
+
+## Focused Discovery Steps
+
+### 1. Extension Point Analysis
+**Identify Integration Approach**:
+- Locate existing extension points or interfaces
+- Determine modification scope (files, components)
+- Check for existing patterns to follow
+- Identify backward compatibility requirements
+
+### 2. Dependency Check
+**Verify Compatibility**:
+- Check version compatibility of new dependencies
+- Validate API contracts haven't changed
+- Ensure no breaking changes in pipeline
+
+### 3. Quick Technology Verification
+**For New Libraries Only**:
+- Use WebSearch for official documentation
+- Verify basic usage patterns
+- Check for known compatibility issues
+- Confirm licensing compatibility
+- Record key findings in `research.md` (technology alignment section)
+
+### 4. Integration Risk Assessment
+**Quick Risk Check**:
+- Impact on existing functionality
+- Performance implications
+- Security considerations
+- Testing requirements
+
+## When to Escalate to Full Discovery
+Switch to full discovery if you find:
+- Significant architectural changes needed
+- Complex external service integrations
+- Security-sensitive implementations
+- Performance-critical components
+- Unknown or poorly documented dependencies
+
+## Output Requirements
+- Clear integration approach (note boundary impacts in `research.md`)
+- List of files/components to modify
+- New dependencies with versions
+- Integration risks and mitigations
+- Testing focus areas