[IMPORTANT] Use

TaskCreate

to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ATTENTION ask user whether to skip.

<!-- SYNC:critical-thinking-mindset -->

Critical Thinking Mindset — Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence >80% to act. Anti-hallucination: Never present guess as fact — cite sources for every claim, admit uncertainty freely, self-check output for errors, cross-reference independently, stay skeptical of own confidence — certainty without evidence root of all hallucination.

<!-- /SYNC:critical-thinking-mindset --> <!-- SYNC:ai-mistake-prevention -->

AI Mistake Prevention — Failure modes to avoid on every task:

• Check downstream references before deleting. Deleting components causes documentation and code staleness cascades. Map all referencing files before removal.
• Verify AI-generated content against actual code. AI hallucinates APIs, class names, and method signatures. Always grep to confirm existence before documenting or referencing.
• Trace full dependency chain after edits. Changing a definition misses downstream variables and consumers derived from it. Always trace the full chain.
• Trace ALL code paths when verifying correctness. Confirming code exists is not confirming it executes. Always trace early exits, error branches, and conditional skips — not just happy path.
• When debugging, ask "whose responsibility?" before fixing. Trace whether bug is in caller (wrong data) or callee (wrong handling). Fix at responsible layer — never patch symptom site.
• Assume existing values are intentional — ask WHY before changing. Before changing any constant, limit, flag, or pattern: read comments, check git blame, examine surrounding code.
• Verify ALL affected outputs, not just the first. Changes touching multiple stacks require verifying EVERY output. One green check is not all green checks.
• Holistic-first debugging — resist nearest-attention trap. When investigating any failure, list EVERY precondition first (config, env vars, DB names, endpoints, DI registrations, data preconditions), then verify each against evidence before forming any code-layer hypothesis.
• Surgical changes — apply the diff test. Bug fix: every changed line must trace directly to the bug. Don't restyle or improve adjacent code. Enhancement task: implement improvements AND announce them explicitly.
• Surface ambiguity before coding — don't pick silently. If request has multiple interpretations, present each with effort estimate and ask. Never assume all-records, file-based, or more complex path.

<!-- /SYNC:ai-mistake-prevention -->

Prerequisites:

<!-- SYNC:plan-quality -->

Plan Quality — Every plan phase MUST ATTENTION include test specifications.

1. Add

   ## Test Specifications

   section with TC-{FEAT}-{NNN} IDs to every phase file
2. Map every functional requirement to ≥1 TC (or explicit

   TBD

   with rationale)
3. TC IDs follow

   TC-{FEATURE}-{NNN}

   format — reference by ID, never embed full content
4. Before any new workflow step: call

   TaskList

   and re-read the phase file
5. On context compaction: call

   TaskList

   FIRST — never create duplicate tasks
6. Verify TC satisfaction per phase before marking complete (evidence must be

   file:line

   , not TBD)

Mode: TDD-first → reference existing TCs with

Evidence: TBD

. Implement-first → use TBD →

/tdd-spec

fills after.

<!-- /SYNC:plan-quality -->

• docs/test-specs/

  — Test specifications by module (read existing TCs to include test strategy in plan)

<!-- SYNC:iterative-phase-quality -->

Iterative Phase Quality — Score complexity BEFORE planning.

Complexity signals: >5 files +2, cross-service +3, new pattern +2, DB migration +2 Score >=6 → MUST ATTENTION decompose into phases. Each phase:

• ≤5 files modified
• ≤3h effort
• Follows cycle: plan → implement → review → fix → verify
• Do NOT start Phase N+1 until Phase N passes VERIFY

Phase success = all TCs pass + code-reviewer agent approves + no CRITICAL findings.

<!-- /SYNC:iterative-phase-quality -->

Quick Summary

Goal: Analyze an implementation plan, assess its impact on the codebase, and update specification documents accordingly.

Workflow:

1. Discovery — Parse plan, extract requirements, catalog planned changes
2. Knowledge Graph — Build detailed component-level impact map with test/spec mappings
3. Analysis — Assess architecture impact, business logic changes, testing strategy
4. Approval Gate — Present findings for explicit user approval before any spec updates
5. Spec Update — Execute approved changes to specification documents

Key Rules:

• Planning-only skill -- never implement code changes
• Always collaborate and get user approval before proceeding
• Maintain bidirectional traceability between plan and specification

Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).

Implementation Plan Analysis & Specification Update

PLANNING-ONLY — Collaboration Required

DO NOT use the

EnterPlanMode

tool — you are ALREADY in a planning workflow. DO NOT implement or execute any code changes. COLLABORATE with the user: ask decision questions, present options with recommendations. After plan analysis, validate findings with user approval. ASK user to confirm the analysis before any next steps.

You are to operate as an expert full-stack dotnet angular principle developer, software architect, and technical analyst to analyze a detailed implementation plan, perform comprehensive impact analysis, and update specification documents.

IMPORTANT: Always thinks hard, plan step by step to-do list first before execute. Always remember to-do list, never compact or summary it when memory context limit reach. Always preserve and carry your to-do list through every operation.

Prerequisites:

<!-- SYNC:understand-code-first -->

Understand Code First — HARD-GATE: Do NOT write, plan, or fix until you READ existing code.

1. Search 3+ similar patterns (

   grep

   /

   glob

   ) — cite

   file:line

   evidence
2. Read existing files in target area — understand structure, base classes, conventions
3. Run

   python .claude/scripts/code_graph trace <file> --direction both --json

   when

   .code-graph/graph.db

   exists
4. Map dependencies via

   connections

   or

   callers_of

   — know what depends on your target
5. Write investigation to

   .ai/workspace/analysis/

   for non-trivial tasks (3+ files)
6. Re-read analysis file before implementing — never work from memory alone
7. NEVER invent new patterns when existing ones work — match exactly or document deviation

BLOCKED until:

- [ ]

Read target files

- [ ]

Grep 3+ patterns

- [ ]

Graph trace (if graph.db exists)

- [ ]

Assumptions verified with evidence

<!-- /SYNC:understand-code-first --> <!-- SYNC:evidence-based-reasoning -->

Evidence-Based Reasoning — Speculation is FORBIDDEN. Every claim needs proof.

1. Cite

   file:line

   , grep results, or framework docs for EVERY claim
2. Declare confidence: >80% act freely, 60-80% verify first, <60% DO NOT recommend
3. Cross-service validation required for architectural changes
4. "I don't have enough evidence" is valid and expected output

BLOCKED until:

- [ ]

Evidence file path (

file:line

)

- [ ]

Grep search performed

- [ ]

3+ similar patterns found

- [ ]

Confidence level stated

Forbidden without proof: "obviously", "I think", "should be", "probably", "this is because" If incomplete → output:

"Insufficient evidence. Verified: [...]. Not verified: [...]."

<!-- /SYNC:evidence-based-reasoning -->

---

PHASE 1: EXTERNAL MEMORY-DRIVEN IMPLEMENTATION PLAN ANALYSIS

Build a structured knowledge model in

.ai/workspace/analysis/[plan-name].analysis.md

.

PHASE 1A: INITIALIZATION AND DISCOVERY

1. Initialize the analysis file with standard headings

IMPLEMENTATION PLAN COMPREHENSIVE ANALYSIS

IMPLEMENTATION_PLAN_DEEP_ANALYSIS: Thorough analysis of the implementation plan file:

1. Plan Structure Analysis:

   • Read and parse the implementation plan completely
   • Extract all planned features, requirements, and changes
   • Identify implementation phases and dependencies
   • Document under

     ## Implementation Plan Overview

2. Requirements Extraction:

   • Parse Knowledge Graph from implementation plan
   • Extract new business requirements
   • Map functional and non-functional requirements
   • Identify changed business workflows
   • Document under

     ## Extracted Requirements

3. Planned Changes Analysis:

   • Catalog all planned code changes (new files, modifications, deletions)
   • Identify affected components, services, and layers
   • Map file-level changes to business capabilities
   • Extract integration points
   • Document under

     ## Planned Changes Analysis

4. Architecture Impact Assessment:

   • Analyze how changes affect overall system architecture
   • Identify CQRS pattern impacts (new Commands/Queries/Events)
   • Map domain entity changes and repository patterns
   • Document under

     ## Architecture Impact Assessment

5. Existing Specification Analysis:

   • Read and analyze existing specification document structure
   • Identify current test cases, requirements, entity relationships
   • Map existing test coverage to planned changes
   • Document under

     ## Current Specification Analysis

AFFECTED_COMPONENTS_DISCOVERY: For each planned change, discover:

• Direct Dependencies
• Indirect Dependencies
• Test Coverage Impact
• API Integration Impact
• Cross-Service Communication
• Database Schema Impact

Save to

## Comprehensive File List

with:

• filePath

  ,

  changeType

  ,

  relationshipType

  ,

  impactLevel

• serviceContext

  ,

  planContext

  ,

  specificationRelevance

PHASE 1B: KNOWLEDGE GRAPH CONSTRUCTION

IMPORTANT: MUST ATTENTION DO WITH TODO LIST

For each file, document in

## Knowledge Graph

:

• Standard fields plus plan-specific:

• currentContent

  : Existing functionality (if file exists)

• plannedChanges

  : Specific changes planned

• changeImpactAnalysis

  : How changes affect other components

• testingRequirements

  : New test cases needed

• specificationMapping

  : How component maps to spec sections

• testCaseImpact

  : Existing test cases needing modification

PHASE 1C: SPECIFICATION MAPPING ANALYSIS

• Test Case Mapping: Which existing test cases are affected
• Business Requirement Mapping: How new requirements relate to existing
• Entity Relationship Impact: Changes to entity relationships
• Workflow Integration: How new workflows integrate with existing
• Coverage Gap Analysis: Areas where new test cases needed

PHASE 1D: OVERALL ANALYSIS

Write comprehensive summary showing:

• Complete end-to-end workflows affected
• Architectural patterns impacted
• Business logic workflow changes
• Integration points affected
• Comprehensive test coverage requirements

---

PHASE 2: COMPREHENSIVE ANALYSIS AND PLANNING

Generate detailed analysis under these headings:

1. Implementation Impact Analysis: Component impact, integration points, data flow changes, platform compliance

2. Business Logic Analysis: New business rules, modified workflows, validation requirements

3. Testing Strategy Analysis: Test coverage requirements, new test scenarios, regression testing needs

4. Specification Update Strategy: How to integrate new requirements, maintain traceability, preserve existing coverage

5. Rollback and Safety Strategy: Backup procedures, rollback plan, validation checkpoints

---

PHASE 3: APPROVAL GATE

CRITICAL: Present comprehensive analysis for explicit approval. DO NOT proceed without it.

---

PHASE 4: SPECIFICATION UPDATE EXECUTION

Once approved, execute with MANDATORY steps:

1. Backup Original Specification
2. Read and Parse Existing Specification
3. Execute Planned Updates:
   • New Requirements Integration
   • Entity Relationship Updates
   • Test Case Enhancement
   • Traceability Matrix Updates
   • Coverage Analysis Updates
4. Maintain Specification Structure
5. Quality Assurance Validation

---

SUCCESS VALIDATION

Verify under

## Specification Validation

:

• Requirements Traceability: All plan requirements mapped
• Test Coverage Validation: All changes covered by tests
• Business Workflow Validation: End-to-end workflows documented
• Integration Testing Coverage: Cross-service impacts covered
• Regression Prevention: Existing functionality protected

---

Plan Analysis Guidelines

• Plan-Driven Analysis: Base all analysis on the detailed implementation plan
• Specification Structure Preservation: Maintain standardized specification format
• Comprehensive Impact Assessment: Analyze direct and indirect effects
• End-to-End Workflow Mapping: Understand affected business processes
• Enterprise Architecture Awareness: Respect platform patterns
• Quality-Focused Testing: Create comprehensive test specifications
• Specification Completeness: Ensure full traceability
• Risk Assessment and Mitigation: Identify risks and provide rollback strategies
• Bidirectional Traceability: Maintain clear mapping between plan and spec
• Coverage Preservation: Maintain existing test coverage while adding new

Related

• planning

• feature-implementation

• MANDATORY FINAL TASKS: After creating all planning todo tasks, ALWAYS add these three final tasks:

  1. Task: "Write test specifications for each phase" — Add

     ## Test Specifications

     with TC-{FEAT}-{NNN} IDs to every phase file. Use

     /tdd-spec

     if feature docs exist. Use

     Evidence: TBD

     for TDD-first mode.
  2. Task: "Run /plan-validate" — Trigger

     /plan-validate

     skill to interview the user with critical questions and validate plan assumptions
  3. Task: "Run /plan-review" — Trigger

     /plan-review

     skill to auto-review plan for validity, correctness, and best practices

REMINDER — Planning-Only Skill

DO NOT use

EnterPlanMode

tool. DO NOT start implementing. ALWAYS validate with user approval after analysis. ASK user to confirm findings before any execution begins. ASK user for clarification when multiple approaches exist.

---

Closing Reminders

• MANDATORY IMPORTANT MUST ATTENTION break work into small todo tasks using

  TaskCreate

  BEFORE starting
• MANDATORY IMPORTANT MUST ATTENTION search codebase for 3+ similar patterns before creating new code
• MANDATORY IMPORTANT MUST ATTENTION cite

  file:line

  evidence for every claim (confidence >80% to act)
• MANDATORY IMPORTANT MUST ATTENTION add a final review todo task to verify work quality
• MANDATORY IMPORTANT MUST ATTENTION include Test Specifications section and story_points in plan frontmatter <!-- SYNC:plan-quality:reminder -->
• MANDATORY IMPORTANT MUST ATTENTION include

  ## Test Specifications

  with TC IDs per phase. Call

  TaskList

  before creating new tasks. <!-- /SYNC:plan-quality:reminder --> <!-- SYNC:understand-code-first:reminder -->
• MANDATORY IMPORTANT MUST ATTENTION search 3+ existing patterns and read code BEFORE any modification. Run graph trace when graph.db exists. <!-- /SYNC:understand-code-first:reminder --> <!-- SYNC:evidence-based-reasoning:reminder -->
• MANDATORY IMPORTANT MUST ATTENTION cite

  file:line

  evidence for every claim. Confidence >80% to act, <60% = do NOT recommend. <!-- /SYNC:evidence-based-reasoning:reminder --> <!-- SYNC:iterative-phase-quality:reminder -->
• MANDATORY IMPORTANT MUST ATTENTION score complexity first. Score >=6 → decompose. Each phase: plan → implement → review → fix → verify. No skipping. <!-- /SYNC:iterative-phase-quality:reminder --> <!-- SYNC:critical-thinking-mindset:reminder -->
• MUST ATTENTION apply critical thinking — every claim needs traced proof, confidence >80% to act. Anti-hallucination: never present guess as fact. <!-- /SYNC:critical-thinking-mindset:reminder --> <!-- SYNC:ai-mistake-prevention:reminder -->
• MUST ATTENTION apply AI mistake prevention — holistic-first debugging, fix at responsible layer, surface ambiguity before coding, re-read files after compaction. <!-- /SYNC:ai-mistake-prevention:reminder -->