sead-method-core/sead-core/tasks/sead-document-issue.md

Specification Enforced Agentic Agile Development - A hybrid methodology preventing AI agent drift through catalog-based constraints with comprehensive external asset integration

<!-- Powered by SEAD-METHOD™ Core -->

# SEAD Document Issue Task

## Purpose

To systematically document issues, bugs, and problems within the SEAD constitutional framework, ensuring comprehensive context preservation, catalog pattern impact analysis, and constitutional constraint considerations. This task creates actionable issue documentation that supports effective resolution while maintaining catalog integrity and agent handoff continuity.

## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)

### 0. Load SEAD Configuration and Issue Context

- Load `{root}/sead.config.yaml` and `{root}/sead-core/core-config.yaml` from the project root
- If files do not exist, HALT and inform the user: "SEAD configuration files not found. Run 'sead init' or 'sead catalog generate --source .' to initialize SEAD project"
- Extract key configurations: `issues.*`, `catalog.*`, `modes.*`, `validation.*`, `governance.*`
- **SEAD Enhancement**: Load current development mode and issue documentation requirements
- **SEAD Enhancement**: Validate catalog patterns relevant to issue domain
- **SEAD Enhancement**: Check constitutional constraint framework for issue classification

### 1. Issue Discovery and Initial Analysis

#### 1.1 Issue Identification with SEAD Context

- Identify and gather initial information about the issue:
  - Issue description and symptoms
  - Steps to reproduce or trigger conditions
  - Expected vs. actual behavior
  - Environment and context where issue occurs
  - Impact assessment on functionality and user experience

- **SEAD Enhancement**: Map issue to SEAD framework components:
  - Catalog patterns potentially affected or violated
  - Constitutional constraints that may be compromised
  - Agent workflows that may be disrupted
  - Context preservation that may be broken

#### 1.2 Issue Classification with Constitutional Framework

- **SEAD Enhancement**: Classify issue within SEAD constitutional framework:
  - **Constitutional Violation**: Issue stems from constitutional constraint violation or enforcement failure
  - **Catalog Pattern Inconsistency**: Issue caused by catalog pattern misuse or inconsistency
  - **Context Preservation Failure**: Issue results from agent handoff or context preservation breakdown
  - **Technical Implementation**: Standard technical issue within established patterns and constraints
  - **Process Breakdown**: Issue with SEAD methodology application or workflow execution

### 2. Impact Analysis with Catalog Pattern Assessment

#### 2.1 Catalog Pattern Impact Analysis

- **SEAD Enhancement**: Analyze issue impact on catalog patterns:
  - **API Contracts**: Does issue affect API contract compliance or integration?
  - **Shared Types**: Does issue involve type definition inconsistencies or violations?
  - **Design System**: Does issue affect UI component consistency or design system compliance?
  - **State Management**: Does issue involve state management pattern violations or inconsistencies?
  - **Error Handling**: Does issue represent error handling pattern failure or gap?
  - **Authentication**: Does issue affect authentication pattern implementation or security?
  - **Integration**: Does issue impact integration pattern effectiveness or compliance?
  - **Testing**: Does issue involve test pattern failure or validation gap?

#### 2.2 Constitutional Constraint Impact Assessment

- **SEAD Enhancement**: Evaluate issue impact on constitutional constraints:
  - Mode-specific constraint violations (prototype/development/build-to-deploy)
  - Quality gate failures or validation bypass issues
  - Context preservation breakdown affecting agent handoffs
  - Governance process failures or enforcement gaps

### 3. Root Cause Analysis with SEAD Framework

#### 3.1 Pattern-Based Root Cause Analysis

- **SEAD Enhancement**: Analyze root causes within catalog pattern context:
  - **Pattern Misunderstanding**: Catalog patterns not properly understood or applied
  - **Pattern Incompleteness**: Catalog patterns insufficient for specific use case requirements
  - **Pattern Evolution Needed**: Existing patterns need enhancement or replacement
  - **Pattern Documentation Gap**: Pattern usage guidance insufficient or unclear
  - **Pattern Integration Failure**: Multiple patterns not integrated properly

#### 3.2 Constitutional Constraint Root Cause Analysis

- **SEAD Enhancement**: Analyze constitutional constraint failures:
  - **Constraint Awareness Gap**: Constitutional constraints not understood or communicated
  - **Constraint Conflict**: Multiple constraints creating impossible or contradictory requirements
  - **Constraint Enforcement Failure**: Validation systems not catching constraint violations
  - **Mode Inappropriate**: Current SEAD mode inappropriate for development context or requirements
  - **Process Deviation**: SEAD methodology not followed or improperly applied

### 4. Issue Documentation with Context Preservation

#### 4.1 Comprehensive Issue Description

**Issue Summary with SEAD Context:**
- Clear, concise issue title with catalog domain and constitutional context
- **SEAD Enhancement**: Primary catalog patterns affected
- **SEAD Enhancement**: Constitutional constraints involved
- **SEAD Enhancement**: SEAD mode context and relevance

**Detailed Description with Pattern Context:**
- Comprehensive issue description with technical details
- **SEAD Enhancement**: Catalog pattern usage at time of issue occurrence
- **SEAD Enhancement**: Constitutional constraint status during issue manifestation
- **SEAD Enhancement**: Agent workflow context and handoff history leading to issue

#### 4.2 Reproduction and Evidence Documentation

**Reproduction Steps with Catalog Context:**
- Detailed steps to reproduce issue with catalog pattern usage
- **SEAD Enhancement**: Catalog pattern state and configuration during reproduction
- **SEAD Enhancement**: Constitutional constraint validation status during reproduction
- **SEAD Enhancement**: Agent context and handoff state during issue occurrence

**Evidence and Artifacts:**
- **SEAD Enhancement**: Catalog pattern compliance reports or validation failures
- **SEAD Enhancement**: Constitutional constraint violation logs or enforcement gaps
- **SEAD Enhancement**: Agent workflow context preservation artifacts
- **SEAD Enhancement**: Relevant code, configuration, and documentation snapshots

### 5. Impact Assessment and Prioritization

#### 5.1 Business and Technical Impact Analysis

**User and Business Impact:**
- User experience degradation or functionality loss
- Business process disruption or efficiency reduction
- **SEAD Enhancement**: Catalog pattern consistency impact across system
- **SEAD Enhancement**: Constitutional compliance risk and governance implications

**Technical Impact Assessment:**
- **SEAD Enhancement**: Catalog pattern fragmentation or inconsistency risk
- **SEAD Enhancement**: Constitutional constraint violation precedent risk
- **SEAD Enhancement**: Agent workflow disruption and context preservation risk
- **SEAD Enhancement**: Long-term technical debt and maintenance burden implications

#### 5.2 Issue Prioritization with SEAD Framework

- **SEAD Enhancement**: SEAD-aware issue prioritization criteria:
  - **CRITICAL**: Constitutional violations affecting security, data integrity, or system stability
  - **HIGH**: Catalog pattern violations affecting system consistency or user experience
  - **MEDIUM**: Context preservation failures affecting agent handoff effectiveness
  - **LOW**: Quality of life issues or optimization opportunities within established patterns

### 6. Resolution Strategy with Constitutional Guidance

#### 6.1 Resolution Approach Planning

- **SEAD Enhancement**: Constitutional constraint-guided resolution planning:
  - **Immediate Fix**: Address critical constitutional violations with established pattern usage
  - **Pattern Evolution**: Enhance catalog patterns to address issue root cause systematically
  - **Constraint Adjustment**: Modify constitutional constraints if they create impossible or counterproductive requirements
  - **Process Improvement**: Strengthen SEAD methodology to prevent similar issues

#### 6.2 Resolution Context Package Creation

- **SEAD Enhancement**: Resolution guidance with catalog pattern integration:
  - Required catalog patterns for issue resolution
  - Constitutional constraint compliance requirements during resolution
  - Agent workflow context preservation requirements
  - Quality assurance and validation requirements for resolution verification

### 7. Issue Assignment and Context Handoff

#### 7.1 Resolution Team Assignment

- **SEAD Enhancement**: Agent-aware issue assignment:
  - Appropriate SEAD agent capabilities for issue domain and resolution approach
  - Catalog pattern expertise requirements for effective resolution
  - Constitutional constraint knowledge requirements for compliant resolution
  - Context preservation capabilities for maintaining agent handoff effectiveness

#### 7.2 Context Preservation for Resolution

- **SEAD Enhancement**: Issue resolution context package:
  - Complete issue analysis with catalog pattern impact assessment
  - Constitutional constraint context and compliance requirements
  - Agent workflow context and handoff preservation requirements
  - Quality assurance criteria and validation requirements for resolution acceptance

### 8. Issue Monitoring and Follow-up

#### 8.1 Resolution Progress Tracking

- **SEAD Enhancement**: Constitutional compliance tracking during resolution:
  - Catalog pattern usage and compliance during resolution implementation
  - Constitutional constraint adherence throughout resolution process
  - Context preservation effectiveness during agent handoffs
  - Quality gate satisfaction and validation coverage for resolution

#### 8.2 Resolution Validation and Learning Integration

- **SEAD Enhancement**: Resolution outcome validation:
  - Issue resolution effectiveness and completeness
  - Catalog pattern integrity and consistency preservation
  - Constitutional constraint compliance restoration
  - Agent workflow context preservation and handoff continuity

- **SEAD Enhancement**: Learning integration for methodology improvement:
  - Pattern evolution insights from issue resolution
  - Constitutional constraint refinements based on real-world application
  - Process improvements for issue prevention and resolution effectiveness

## SEAD Success Criteria

- Issue documentation comprehensively captures catalog pattern and constitutional constraint context
- Root cause analysis identifies pattern inconsistencies and constraint failures accurately
- Resolution strategy maintains catalog integrity while addressing issue effectively
- Context preservation enables effective agent handoff and resolution continuity
- Issue resolution strengthens catalog patterns and constitutional constraint framework
- Learning integration improves SEAD methodology and prevents similar issues

## SEAD Innovation Benefits

- **Systematic Issue Analysis**: Constitutional framework provides structured approach to issue understanding
- **Pattern Integrity**: Issue documentation and resolution maintains catalog pattern consistency
- **Context Preservation**: Issue documentation preserves agent handoff context for effective resolution
- **Governance Strengthening**: Issue analysis and resolution improves constitutional constraint framework
- **Learning Integration**: Issue resolution insights enhance SEAD methodology and organizational knowledge

## Output

Comprehensive issue documentation including:
- Detailed issue description with catalog pattern and constitutional constraint context
- Root cause analysis with SEAD framework integration
- Impact assessment with catalog integrity and governance implications
- Resolution strategy with context preservation and compliance requirements
- Agent assignment and context handoff package for effective resolution
- Learning integration recommendations for methodology improvement