Workflow Granularity System

[amirkiarafiei]

Problem:

Current workflows enforce hardcoded conciseness constraints (e.g., "Keep each section short" , "2-8 focused tests maximum"). This one-size-fits-all approach produces outputs that are too abstract for certain use cases and LLM models that need more specific guidance. It prevent users from getting the detail level they need for their specific LLM models and project requirements.

Solution:

It would be nice to have a system that allows user to modify the level of abstraction/detail/depth, possibly through two approaches:

1. Add CLI flags to scripts/project-install.sh to control granularity:

--detail-level [minimal|standard|detailed|exhaustive]  
--test-count [low|medium|high]  
--spec-depth [brief|moderate|comprehensive]

These flags would override hardcoded limits in workflow templates during compilation

2. Extend the template compilation system to support conditional content blocks:

{{#if detailed_mode}}  
Write comprehensive implementation details with examples  
{{else}}  
Keep sections concise with essential information only  
{{/if}}

Add granularity settings to config.yml that flow through the existing variable substitution system

Benefits:

• Allows users to adjust the detail of outputs
• Enables detailed specifications when needed while preserving conciseness as default
• Maintains backward compatibility with default values