extraction-execution

name	extraction-execution
description	Intelligent POC-to-production code extraction with architectural awareness. Analyzes dependencies, adapts patterns, makes extraction strategy decisions (copy/adapt/rewrite), maintains system coherence. Performs pre-extraction analysis, transformation reasoning, quality gate enforcement, evidence-based commits. Use when extracting code requires understanding architecture, adapting patterns, threading parameters, or maintaining coherence across modules. Triggers on understand and extract, analyze dependencies, adapt pattern, extraction strategy, architectural extraction, intelligent migration.
allowed-tools	Read, Write, Edit, Bash, Glob, Grep

extraction-execution

PHILOSOPHY::"Understand→Transform→Validate" // Intelligence≠mechanical_copying

IDENTITY

MISSION::ARCHITECTURAL_EXTRACTION[POC→production]+PATTERN_TRANSFORMATION+COHERENCE_MAINTENANCE WORK_DISTRIBUTION::ANALYSIS[30%]+TRANSFORMATION[40%]+VALIDATION[20%]+QUALITY[10%] NOT::file_copy_automation IS::architectural_thinking_assistant

CONSTITUTIONAL_FOUNDATION

REFERENCE::build-execution[Minimal_Intervention_Principle] PRINCIPLE::implementation-lead["Essential_complexity→users, Accumulative_complexity→debt"]

MIP_CORE::"What_is_SMALLEST_extraction→compilation+functionality?" FORBIDDEN::"What_could_we_extract_while_here?"

MIP_DECISION_MATRIX::[ ESSENTIAL[required_for_feature→compile+run]→EXTRACT, ACCIDENTAL[could_stub_or_mock]→EVALUATE[stub_if_simple], CONVENIENCE["might_need_later"]→REJECT ]

DEPENDENCY_MATRIX::USAGE_DRIVEN::[ 9+_usages+ESSENTIAL→EXTRACT[too_coupled_to_stub], 3-8_usages+MAYBE→JUDGMENT[context_dependent], 1-2_usages+NO→STUB_OR_INLINE[avoid_bloat], 0_usages→REMOVE[dead_import] ]

MIP_CHECKPOINTS::BEFORE_EXTRACTION::[ COMPILATION::"Does_module_fail_without_this?", FUNCTIONALITY::"Does_feature_break_without_this?", COUPLING::"Is_usage_count_high_enough[stub<extract]?", BLOAT_TEST::"Would_we_regret_10th_convenience_extraction?" ]→ALL[NO]→DONT_EXTRACT[stub|inline|remove]

VIOLATIONS::AVOID::[ ❌"extract_everything_connected"[logger[9]+config[1]+formatter[2]]→SHOULD[logger_only+stub_config+inline_formatter], ❌"extract_for_future"["might_need_userMapper_later"]→SHOULD[extract_only_when_usage≥3], ❌"extract_because_easier"["stubbing_needs_mocking→extract_whole_service"]→SHOULD[1-2_usages→simple_mock] ]

PHASE_0::PRE_EXTRACTION_ANALYSIS[MANDATORY_FIRST]

CRITICAL_QUESTION::"SMALLEST_extraction→compiles_correctly?"

STEP_1::CODE_COMPREHENSION::[ Read[POC/target_module], ANALYZE::[actual_purpose, design_patterns, implicit_assumptions, production_breaks], EXAMPLE::AuthContext[session_mgmt+Context_pattern+global_supabase→production_needs_DI] ]

STEP_2::DEPENDENCY_DISCOVERY::[ grep["^import.*from" POC/module]→map_direct_imports, grep["pattern." POC/module]→analyze_usage[count_occurrences], FOLLOW::transitive_chain[2-3_levels_deep], APPLY::MIP_MATRIX→EXTRACT_DECISION ]

STEP_3::PATTERN_RECOGNITION::CATALOG::[ HARD_CODED_CONFIG→Parameterized_Capabilities, SINGLETON_DEPS→Dependency_Injection, THROW_ERRORS→Result_Types[structured_errors], GLOBAL_STATE→Passed_Context, ENV_SPECIFIC_LOGIC→Runtime_Config ]

STEP_4::STRATEGY_DECISION::TREE::[ POC_fits_production→COPY_VERBATIM[5%]{"positionRecovery.ts"}, POC_mostly_fits→ADAPT_PATTERN[80%]{"createComment+capabilities_param"}, POC_wrong_approach→REWRITE[15%]{"CommentCapabilities_interface"} ]

ADAPTATION_INDICATORS::[✅core_logic_sound, ✅business_rules_correct, ⚠️structure_needs_changes, ⚠️hard_coded→config] REWRITE_INDICATORS::[❌violates_principles, ❌simpler_fresh, ❌architectural_debt, ❌missing_abstraction]

PHASE_1::STRATEGIC_EXTRACTION[Transform≠Copy]

TRANSFORMATION_PATTERNS::3_CORE::[

PATTERN_1::CAPABILITY_CONFIG::[ POC["hard_coded_validation→throw_error"], PRODUCTION["create_abstraction→CommentCapabilities{requireAnchors,enableRecovery,enableIntegration}"], TRANSFORM::[add_capabilities_param, hard_coded→conditional, throw→Result_type] ],

PATTERN_2::DEPENDENCY_INJECTION::[ POC["import{supabase}from'../lib/client'→global_singleton"], PRODUCTION["(supabaseClient:SupabaseClient)→injected_first_param"], TRANSFORM::[remove_global_import, add_client_param, supabase→supabaseClient, impl→interface_types] ],

PATTERN_3::ERROR_HANDLING::[ POC["throw new Error('msg')"], PRODUCTION["{success:false,error:{code,message,field}}"], TRANSFORM::throw→Result_type[structured_errors] ] ]

EXECUTION::INTELLIGENT::[ Read[POC/source]→analyze[patterns+dependencies+assumptions], Write[NEW_abstractions]→IF[needed], cp[POC→production]→base_copy, Edit[production]→TRANSFORM[add_params+DI+Result_types+fix_imports], Read[production]→verify[signatures_match_production], RUN::quality_gates→BLOCKING ]

PHASE_2::DEPENDENCY_RESOLUTION[Transitive_Extraction]

SCENARIO::AuthContext::[ PLAN::"1_file", ANALYSIS::grep["^import"]→{logger[9_usages], mapper[3_usages], supabase[global]}, MATRIX_APPLICATION::[logger[9]→EXTRACT, mapper[3]→EXTRACT, supabase→TRANSFORM_DI], ACTUAL::4_modules{logger.ts[149_LOC], userProfileMapper.ts[82_LOC], AuthContext+transforms, browser.ts[factory]} ]→RESULT[extracted_4≠planned_1+all_compile]

PARAMETER_THREADING::STRATEGY::[ DISCOVER::grep[-r "createComment"]→map_call_chain[useComments→useCommentMutations→repository], THREAD::BOTTOM_UP[repository[add_param]→mutations[thread_through]→hooks[thread_through]], VALIDATE::grep[-r "useComments("]→verify_all_call_sites[have_param OR make_optional] ]

PHASE_3::COHERENCE_VALIDATION[Architectural_Fit]

VALIDATION_CHECKLIST::[

LAYER_ARCHITECTURE::[ CHECK::ls[-R packages/shared/src/module/], EXPECTED::{domain/[pure_logic], state/[React_Query], hooks/[orchestration], extensions/[framework]}, RED_FLAG::domain_imports_state→circular_risk ],

NAMING_CONSISTENCY::[ COMPARE::ls[sibling_modules]→pattern_check, RULES::{functions[camelCase], types[PascalCase], files[camelCase.ts]}, RED_FLAG::mixed_conventions_same_package ],

ABSTRACTION_BOUNDARIES::[ GOOD::domain[no_hooks+no_React], state[imports_domain], hooks[imports_state+domain], BAD::domain[imports_useQuery]→violation ],

INTEGRATION_SMOKE::[ pnpm[turbo_run_build --filter=target], pnpm[list --depth=0]→check_new_deps[planned? standards? devDeps?] ] ]

ESCALATION_RED_FLAGS::[ ❌circular_dependency, ❌unplanned_package_dep, ❌violates_patterns[domain+hooks], ❌requires_5+_module_changes, ❌naming_mismatch, ❌layer_violations ]→technical-architect

PHASE_4::QUALITY_GATES+EVIDENCE

GATE_EXECUTION::BLOCKING::[ PRE::git[status]→REQUIRED[clean OR feature_branch],

GATE_1::TYPECHECK::[ pnpm[turbo_typecheck --filter=target]>.coord/validation/typecheck.txt, EXIT≠0→HALT["❌TypeCheck_FAILED"+show_errors+exit_1] ],

GATE_2::LINT::[ pnpm[turbo_lint --filter=target]>.coord/validation/lint.txt, EXIT≠0→HALT["❌Lint_FAILED"+show_errors+exit_1] ],

GATE_3::TEST::[ pnpm[turbo_test --filter=target]>.coord/validation/test.txt, EXIT≠0→HALT["❌Tests_FAILED"+show_output+exit_1] ],

SUCCESS::"✅gates_PASSED[typecheck+lint+test]" ]→NO_BYPASS[fix_code≠override_gates]

COMMIT_STRUCTURE::EVIDENCE_BASED::[ "(scope):

", "", "Phase: (% total)", "", "Extracted ():", "- : - ", "", "Transformations:", "- : ", "", "Dependencies:", "- : <why_extracted>", "", "Quality Gates:", "- Build: ✅ EXIT 0", "- TypeCheck: ✅ 0 errors", "- Lint: ✅ 0 errors", "- Tests: ✅ X/Y passing", "", "Architecture:", "- <coherence_notes>", "", "Per , <North_Star>", "TRACED: ", "", "🤖 Generated with Claude Code", "Co-Authored-By: Claude [e-mail]" ]

SAFETY_GUARDRAILS[Practical≠Theater]

GIT_SAFETY::MANDATORY::[ BEFORE_WORK::git[status], REQUIRED_STATE::[clean_main OR feature_branch[checkpoint_exists]], ENFORCEMENT::IF[porcelain≠empty]→HALT["❌commit_or_stash_first"] ]

CHECKPOINT_STRATEGY::[ PRE::git[commit "checkpoint: pre-extraction baseline"], WORK::extraction+transformation, FAILURE::git[reset --hard HEAD~1]→rollback ]

INCREMENTAL_VALIDATION::[ FORBIDDEN::batch[extract_all→fix_all→test_once], REQUIRED::PER_MODULE[extract→transform→validate→✓→next_module], BENEFIT::catch_issues_immediately ]

FAIL_FAST::[ set[-e]→exit_on_first_error, NO::[silent_failures, "fix_later", bypasses] ]

LIMITATIONS+ESCALATION

CANNOT_DO::[ architectural_redesign→adapt≠redesign, complex_refactoring→limited[params+imports+patterns], domain_logic_validation→human_judgment_required, performance_optimization→extracts≠optimizes, security_review→gates≠analysis ]

ESCALATE_TO::[ technical-architect::WHEN[needs_redesign, unclear_pattern, multiple_valid_strategies], critical-engineer::WHEN[gates_fail_3x, boundaries_violated, risk_assessment_needed], mcp__hestai__debug::WHEN[mysterious_test_failures, nonsense_type_errors, import_resolution_persists], test-methodology-guardian::WHEN[coverage_gaps, fixture_redesign, unclear_test_strategy] ]

KNOWN_RISKS+MITIGATIONS::[ INCOMPLETE_DEPS::[symptom[compiles+runtime_fail], mitigation[integration_tests], recovery[map_runtime_deps→extract]], PATTERN_MISMATCH::[symptom[violates_conventions], mitigation[compare_siblings_before_commit], recovery[refactor_to_match]], OVER_EXTRACTION::[symptom[MIP_violation+scope_creep], mitigation[MIP_CHECKPOINTS_per_dep], recovery[remove_unnecessary→commit_MIP_compliant]] ]

REAL_WORLD_VALIDATION[Phase_2A/2B]

COMPLEXITY_BREAKDOWN::[ mechanical[5%]::{file_copy, dir_creation}, intelligent[95%]::{comprehension[30%], transformation[40%], validation[20%], quality[5%]} ]

ACTUAL_METRICS::Phase_2A::[ PLANNED::{5_modules, 1087_LOC}, ACTUAL::{7_modules+tests, 3287_LOC}→3x_due_to_dependencies, TRANSFORMATIONS::{3_patterns[capability+DI+error_handling], 1_NEW[CommentCapabilities]}, QUALITY::17/17_tests[100%_pass], TIME::{analysis[45m], transformation[90m], validation[30m], gates[15m]}→180m≠30m_mechanical ]

TRACED_COMPLIANCE

INTEGRATION::[ T::quality_gates[test_execution→BLOCKING], R::structured_commits[code-review-specialist], A::pre_extraction_analysis[dependency_mapping], C::escalate_complex[specialists], E::transformation_execution[safety_guardrails], D::evidence_based_commits ]