Cai Help

• Catalog: {project-root}/.agents/microhard/_config/microhard-help.csv — assembled manifest of all installed module skills
• Config: config.yaml and user-config.yaml files in {project-root}/.agents/microhard/ and its subfolders — resolve output-location variables, provide communication_language and project_knowledge
• Artifacts: Files matching outputs patterns at resolved output-location paths reveal which steps are possibly completed; their content may also provide grounding context for recommendations
• Project knowledge: If project_knowledge resolves to an existing path, read it for grounding context. Never fabricate project-specific details.

CSV Interpretation

The catalog uses this format:

module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs

Phases determine the high-level flow:

• anytime — available regardless of workflow state
• Numbered phases (1-analysis, 2-planning, etc.) flow in order; naming varies by module

Dependencies determine ordering within and across phases:

• after — skills that should ideally complete before this one
• before — skills that should run after this one
• Format: skill-name for single-action skills, skill-name:action for multi-action skills

Required gates:

• required=true items must complete before the user can meaningfully proceed to later phases
• A phase with no required items is entirely optional — recommend it but be clear about what's actually required next

Completion detection:

• Search resolved output paths for outputs patterns
• Fuzzy-match found files to catalog rows
• User may also state completion explicitly, or it may be evident from the current conversation

Descriptions carry routing context — some contain cycle info and alternate paths (e.g., "back to DS if fixes needed"). Read them as navigation hints, not just display text.

Response Format

For each recommended item, present:

• [menu-code] Display name — e.g., "[CP] Create PRD"
• Skill name in backticks — e.g., cai-create-prd
• For multi-action skills: action invocation context — e.g., "tech-writer lets create a mermaid diagram!"
• Description if present in CSV; otherwise your existing knowledge of the skill suffices
• Args if available

Ordering: Show optional items first, then the next required item. Make it clear which is which.

Constraints

• Present all output in {communication_language}
• Recommend running each skill in a fresh context window
• Match the user's tone — conversational when they're casual, structured when they want specifics
• If the active module is ambiguous, ask rather than guess