jmagly/tot-exploration

tot-exploration

Automatically trigger Tree of Thoughts exploration when agents face architectural decisions with multiple valid approaches.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "ToT" → Tree of Thought exploration
• "evaluate N options" → multi-option architectural analysis

Purpose

This skill activates the ToT exploration protocol when an agent encounters a decision point with multiple valid architectural approaches. It ensures systematic evaluation rather than defaulting to the first viable option.

Behavior

When triggered, this skill:

1. Detects decision context:

   • Parse the decision question from conversation
   • Check if multiple valid approaches exist
   • Verify this is an architectural/technical decision (not stylistic)

2. Loads ToT protocol:

   • Load @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/flows/tree-of-thought.yaml schema
   • Load @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/enhancements/architecture-designer-tot-protocol.md protocol

3. Generates alternatives:

   • Produce k=3 meaningfully distinct alternatives (default)
   • Each alternative addresses the same problem differently
   • No trivial variations (must differ in approach, not just parameters)

4. Evaluates with scoring matrix:

   • Extract criteria from project NFRs if available
   • Apply weighted scoring (1-5 per criterion)
   • Calculate composite scores

5. Produces recommendation:

   • Clear winner (gap > 0.5): Recommend with HIGH confidence
   • Close call (gap 0.2-0.5): Recommend with MODERATE confidence, note trade-offs
   • Tie (gap < 0.2): Present both options, request human decision

6. Generates ADR if approved:

   • Use @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/templates/architecture/adr-with-tot.md template
   • Save to .aiwg/architecture/
   • Include backtracking triggers

Activation Conditions

activation:
  conditions:
    - decision_type: [architectural, technical, infrastructure]
    - alternatives_count: ">= 2"
    - impact_level: [high, critical]

  skip_when:
    - decision_already_documented: true
    - user_explicitly_chose: true
    - trivial_decision: true

Integration

This skill uses:

• decision-support: Underlying decision matrix infrastructure
• artifact-orchestration: For multi-agent evaluation when needed
• project-awareness: Context for NFR-based criteria

Agent Orchestration

agents:
  primary:
    agent: architecture-designer
    focus: Generate and evaluate alternatives

  reviewers:
    - agent: security-architect
      focus: Security implications of each alternative
      condition: security_relevant == true
    - agent: performance-engineer
      focus: Performance trade-offs
      condition: performance_critical == true
    - agent: cloud-architect
      focus: Infrastructure implications
      condition: cloud_deployment == true

Output Locations

• ADRs: .aiwg/architecture/adr-*.md
• Decision matrices: .aiwg/decisions/
• ToT exploration logs: .aiwg/working/tot-explorations/

References

• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/flows/tree-of-thought.yaml - ToT workflow schema
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/enhancements/architecture-designer-tot-protocol.md - Agent protocol
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/templates/architecture/adr-with-tot.md - ADR template
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/skills/decision-support/SKILL.md - Decision support skill
• @.aiwg/research/findings/REF-020-tree-of-thoughts.md - Research foundation