[plan] Guide agentic-workflows agent to produce single-file outputs instead of multiple documentation files

[github-actions]

Objective

Update the agentic-workflows custom agent to explicitly instruct the AI to produce a single workflow .md file as primary output, rather than generating 3–6 documentation files per request.

Context

From discussion #17371 (Agent Persona Exploration), a consistent anti-pattern was observed: the agent creates 3–6 documentation files per workflow request, cluttering the workspace and diluting focus. This was noted in 5 of 8 evaluated scenarios including fe-visual and be-deploy.

Expected: one workflow .md file + a concise inline README section.
Actual: multiple files (architecture docs, runbooks, usage guides, etc.)

Approach

1. Locate the agent system prompt or instructions (likely in skills/ or .github/instructions/)
2. Add an explicit constraint:

   "Produce one workflow .md file as the primary deliverable. If documentation is needed, add a brief inline ## Usage section within the same file. Do not create separate documentation files."

3. Optionally, add a positive example showing the single-file pattern
4. Verify the constraint doesn't conflict with scenarios that legitimately need multiple files

Files to Investigate / Modify

• skills/agentic-chat.md or similar skill file used by the agent
• Agent instruction files in .github/instructions/

Acceptance Criteria

• Agent instructions explicitly state to produce a single workflow file
• Instructions discourage creating separate documentation files
• Guidance is clearly placed where the agent will see it at generation time

Generated by Plan Command for issue #discussion #17371

• expires on Feb 23, 2026, 12:13 PM UTC