Subagents, Simplifications & Efficiency

[CasJam]

Added

• Pre-flight Check System - New meta/pre-flight.md instruction for centralized agent detection and initialization
• Proactive Agent Usage - Updated agent descriptions to encourage proactive use when appropriate
• Structured Instruction Organization - New folder structure with core/ and meta/ subdirectories

Changed

• Instruction File Structure - Reorganized all instruction files into subdirectories:
  • Core instructions moved to instructions/core/ (plan-product, create-spec, execute-tasks, execute-task, analyze-product)
  • Meta instructions in instructions/meta/ (pre-flight, more to come)
• Simplified XML Metadata - Removed verbose <ai_meta> and <step_metadata> blocks for cleaner, more readable instructions
• Subagent Integration - Replaced manual agent detection with centralized pre-flight check across all instruction files to enforce delegation and preserve main agent's context.
• Step Definitions - Added subagent attribute to steps for clearer delegation of work to help enforce delegation and preserve main agent's context.
• Setup Script - Updated to create subdirectories and download files to new locations

Improved

• Code Clarity - Removed redundant XML instructions in favor of descriptive step purposes
• Agent Efficiency - Centralized agent detection reduces repeated checks throughout workflows
• Maintainability - Cleaner instruction format with less XML boilerplate
• User Experience - Clearer indication of when specialized agents will be used proactively

Removed

• CLAUDE.md - Removed deprecated Claude Code configuration file (functionality moved to pre-flight system, preventing over-reading instructions into context)
• Redundant Instructions - Eliminated verbose ACTION/MODIFY/VERIFY instruction blocks

---

This discussion was created from the release Subagents, Simplifications & Efficiency.