Skip to content

[Code Quality] Document engine.extensions in frontmatter.md (shipped key missing from concise reference) #47083

Description

@github-actions

Description

The engine.extensions frontmatter key is implemented in production (pkg/workflow/pi_engine.go:211,240) and documented in frontmatter-full.md, but is completely absent from the concise frontmatter.md reference. This means users consulting the most common reference page cannot discover a shipped, usable feature.

From the Schema Consistency Check — 2026-07-21:

frontmatter.md documents engine.driver but still omits engine.extensions. The concise frontmatter reference is incomplete for a shipped frontmatter key.

Suggested Changes

  • Add engine.extensions entry to docs/src/content/docs/reference/frontmatter.md in the engine section (after engine.driver)
  • Mirror the description already in frontmatter-full.md:2478-2485
  • Optionally add a short usage example

Files Affected

  • docs/src/content/docs/reference/frontmatter.md (add engine.extensions entry, lines ~146-161)

Success Criteria

  • engine.extensions appears in frontmatter.md with a clear description
  • Description matches the implementation in pkg/workflow/pi_engine.go
  • No content is removed or broken in the surrounding engine section

Source

Extracted from 🔍 Schema Consistency Check — 2026-07-21

Priority

Medium — improves discoverability of a shipped feature for all users

🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · sonnet46 38.1 AIC · ⌖ 5.38 AIC · ⊞ 7K ·

  • expires on Jul 22, 2026, 5:13 AM UTC-08:00

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions