[Code Quality] Investigate and document `jobs` field implementation in workflow compiler

[github-actions]

Description

The jobs field is defined in the workflow schema and documented, but its implementation in the compiler is unclear. This was identified during schema consistency analysis (Discussion #13673).

Current Status:

• ✅ Defined in schema: pkg/parser/schemas/main_workflow_schema.json
• ✅ Documented: docs/src/content/docs/reference/frontmatter.md:374
• ✅ Used in 7 workflows (4.5% usage rate)
• ❌ No direct frontmatter["jobs"] access found in pkg/workflow/*.go

Impact

HIGH - Workflows using this field may not compile correctly, or the field may be silently ignored.

Suggested Changes

Phase 1: Investigation (1-2 hours)

1. Search for indirect job processing code in compiler
2. Check if jobs field is processed via alternative patterns (e.g., type conversion, nested parsing)
3. Test compilation of workflows that use jobs field
4. Document actual behavior

Phase 2: Resolution (1-2 hours)

Choose one approach:

Option A: Field is working (just indirect)

• Add code comments explaining how it's processed
• Update documentation with examples

Option B: Field is not implemented

• Either implement the functionality
• Or mark as deprecated and update schema/docs

Files Affected

• pkg/workflow/compiler*.go - Compiler implementation
• pkg/parser/schemas/main_workflow_schema.json - Schema definition
• docs/src/content/docs/reference/frontmatter.md - Documentation

Example Workflows Using jobs

grep -l '"jobs":' .github/workflows/*.md | head -5

Examples: ai-moderator.md and 6 others

Success Criteria

• Determined whether jobs field is functional or not
• If functional: Added documentation and tests
• If non-functional: Either implemented or deprecated
• All 7 workflows using jobs compile correctly
• Added test case for jobs field compilation

Source

Extracted from Schema Consistency Analysis discussion #13673

Priority: High - Affects 7 production workflows

AI generated by Discussion Task Miner - Code Quality Improvement Agent

• expires on Feb 18, 2026, 9:12 AM UTC