BMAD-METHOD/expansion-packs/bmad-rfq-government/tasks/shard-aware-evaluation.md

8.9 KiB

Shard-Aware Evaluation Task

Purpose

  • Enable comprehensive evaluation of sharded proposal content
  • Implement cross-shard analysis capabilities for SWARD analysis
  • Add metadata to evaluation results linking back to specific shards
  • Create consolidated evaluation views that span multiple shards
  • Improve evaluation efficiency and depth across large proposal content

Usage Scenarios

Scenario 1: Sharded Technical Volume Evaluation

  1. Shard Inventory: Identify all technical approach content shards
  2. Cross-Shard Review: Evaluate technical content across shard boundaries
  3. Consolidated Analysis: Aggregate evaluation findings from all technical shards
  4. Metadata Linkage: Track evaluation findings back to source shards
  5. Unified Recommendations: Generate integrated improvement recommendations

Scenario 2: Multi-Volume Sharded Evaluation

  1. Cross-Volume Analysis: Analyze related content across different sharded volumes
  2. Requirement Traceability: Track requirement implementation across all shards
  3. Consistency Verification: Ensure uniform messaging across proposal shards
  4. Gap Identification: Find cross-shard gaps and inconsistencies
  5. Strategic Enhancement: Provide comprehensive strategy improvements spanning all shards

Task Instructions

1. Shard-Aware Evaluation Preparation

Preparation Process:

  1. Shard Inventory and Mapping:

    • Review shard manifests for all proposal content
    • Create evaluation matrix linking shards to Section M criteria
    • Map relationships between related shards
    • Identify dependencies and cross-references between shards
  2. Cross-Shard Context Building:

    • Review shard metadata to understand context
    • Identify thematic connections between shards
    • Document content that spans multiple shards
    • Create cross-reference map for related concepts
  3. Evaluation Framework Extension:

    • Adapt evaluation criteria for sharded content
    • Establish consistent scoring approach across shards
    • Create cross-shard evaluation worksheets
    • Develop metadata tagging schema for findings

2. Cross-Shard Evaluation Process

Evaluation Methodology:

  1. Individual Shard Review:

    • Evaluate each shard on its own merits
    • Score against applicable Section M criteria
    • Document strengths, weaknesses, risks, and deficiencies
    • Tag findings with shard-specific metadata
  2. Boundary Analysis:

    • Review content transitions between related shards
    • Identify inconsistencies at shard boundaries
    • Assess narrative flow across shard divisions
    • Evaluate context preservation between shards
  3. Cross-Shard Requirements Verification:

    • Track requirement implementation across multiple shards
    • Verify complete coverage of multi-part requirements
    • Identify redundancies or conflicts in requirement responses
    • Assess consistency of approach for related requirements
  4. Theme and Message Consistency:

    • Evaluate win theme implementation across all shards
    • Verify consistent messaging on key points
    • Identify terminology variations between shards
    • Assess uniform presentation of corporate capabilities

3. Metadata-Enhanced Findings Documentation

Documentation Approach:

  1. Shard-Specific Findings:

    • Document findings with shard identifiers
    • Include location references within shards
    • Tag with requirement IDs from compliance matrix
    • Link to related findings in other shards
  2. Cross-Shard Findings:

    • Document issues that span multiple shards
    • Identify root causes of cross-shard inconsistencies
    • Map finding impacts across the proposal
    • Create relationship diagrams for complex issues
  3. Metadata Enrichment:

    • Apply consistent taxonomy to all findings
    • Tag findings with evaluation criteria references
    • Include impact ratings and priority indicators
    • Add context notes for findings at shard boundaries
  4. Consolidated Finding Repository:

    • Create centralized database of all findings
    • Implement filtering by shard, criteria, and priority
    • Enable sorting and grouping of related findings
    • Provide visualization of finding distribution

4. Cross-Shard SWARD Analysis

Analysis Process:

  1. Strength Aggregation:

    • Identify strengths that span multiple shards
    • Evaluate cumulative impact of related strengths
    • Highlight themes of excellence across shards
    • Create strength heat map across all content
  2. Weakness Pattern Recognition:

    • Detect recurring weaknesses across shards
    • Identify systemic issues affecting multiple sections
    • Create weakness pattern analysis
    • Develop root cause assessment
  3. Risk Dependency Analysis:

    • Map risks that affect multiple proposal areas
    • Identify compound risks spanning shards
    • Evaluate cascading risk implications
    • Create risk network visualization
  4. Deficiency Impact Assessment:

    • Evaluate how deficiencies affect overall compliance
    • Identify critical pathway deficiencies
    • Create deficiency severity matrix
    • Map deficiency correction dependencies

5. Consolidated Evaluation Views

Consolidation Techniques:

  1. Executive Dashboards:

    • Create high-level view of evaluation across all shards
    • Provide scoring summaries by evaluation criteria
    • Highlight critical findings requiring attention
    • Present strategic recommendation overview
  2. Heat Map Visualizations:

    • Generate heat maps showing evaluation results across shards
    • Visualize strength and weakness distributions
    • Create color-coded requirement coverage maps
    • Show theme implementation effectiveness
  3. Finding Relationship Maps:

    • Visualize connections between related findings
    • Map finding dependencies and impacts
    • Show clustering of issues by topic or area
    • Create navigable relationship diagrams
  4. Cross-Reference Navigator:

    • Enable navigation between related findings across shards
    • Provide context transitions between shards
    • Support drilling down from summary to detail
    • Create traceable paths through evaluation data

6. Integrated Improvement Recommendations

Recommendation Approach:

  1. Cross-Shard Enhancement Strategy:

    • Develop holistic improvement strategy
    • Prioritize changes that affect multiple shards
    • Create coordinated enhancement approach
    • Design consistent implementation guidance
  2. Boundary Improvement Recommendations:

    • Provide specific guidance for shard transitions
    • Recommend context enhancements at boundaries
    • Suggest narrative flow improvements
    • Develop terminology standardization
  3. Theme Reinforcement Recommendations:

    • Suggest consistent theme application across shards
    • Recommend balanced theme emphasis
    • Provide cross-shard messaging guidance
    • Create theme implementation templates
  4. Implementation Coordination:

    • Develop synchronized revision approach
    • Create cross-team coordination plan
    • Establish consistency verification milestones
    • Design final integration validation process

Best Practices

  • Holistic Perspective: Maintain awareness of the complete proposal context when evaluating individual shards
  • Boundary Focus: Pay special attention to content transitions between shards
  • Metadata Discipline: Consistently tag all findings with appropriate shard references and metadata
  • Cross-Reference Mapping: Maintain clear relationships between findings across different shards
  • Context Preservation: Ensure evaluation considers the intended context of each shard
  • Consistent Standards: Apply uniform evaluation criteria across all shards
  • Integrated Visualization: Use visual tools to represent findings across multiple shards
  • Coordinated Recommendations: Ensure improvement recommendations consider impacts across all related shards

Integration Points

  • RFQ Document Sharding: Aligns with sharded RFQ documents for evaluation against requirements
  • Compliance Requirement Sharding: Uses sharded requirements for compliance verification
  • Proposal Content Sharding: Evaluates sharded proposal content with awareness of relationships
  • Shard Visualization Tools: Feeds evaluation data to visualization systems
  • Smart Shard Reassembly: Provides input for improvement implementation during reassembly
  • Evaluator Simulator: Primary agent for evaluation across sharded content
  • Compliance Matrix Builder: Provider of requirement traceability data
  • Technical Narrative Drafter: Consumer of shard-specific evaluation findings

Technical Implementation Notes

  • Extends the existing review simulation task with shard-aware capabilities
  • Compatible with the sharded content development workflow
  • Enables comprehensive evaluation across arbitrary shard boundaries
  • Maintains evaluation consistency regardless of content sharding approach