[docs] Update CLI reference for features from Oct 26

[github-actions]

Documentation Updates - October 26, 2025

This PR updates the CLI reference documentation based on features merged in the last 24 hours.

Features Documented

1. Init command workflow creation guidance (from Update init command to guide users to create workflows via chat prompt #2567)

   • Documents new prompt: activate @.github/prompts/create-agentic-workflow.prompt.md
   • Adds "Repository Initialization" subsection with clear instructions
   • Reorganizes workflow creation section for better clarity

2. Validate flag behavior change (from Fix: Disable container validation by default, require --validate flag #2550)

   • Documents that --validate flag now defaults to false (was true)
   • Explains flag enables both schema and container image validation
   • Clarifies when to use validation (verify correctness, slower compilation)

Changes Made

• Updated docs/src/content/docs/tools/cli.md:
  • Added "Repository Initialization" subsection under "Workflow Creation and Management"
  • Documented post-init workflow creation guidance with activation prompt
  • Added "Validation" section explaining --validate flag behavior
  • Updated compile command example comment to reflect validation includes containers
  • Reorganized content for better flow and clarity

Merged PRs Referenced

• Update init command to guide users to create workflows via chat prompt #2567 - Update init command to guide users to create workflows via chat prompt
• Fix: Disable container validation by default, require --validate flag #2550 - Fix: Disable container validation by default, require --validate flag

Analysis Notes

Other merged PRs reviewed (no documentation needed):

• Add JSON schema examples for workflow properties (name, description, source, imports, on) #2578, Add JSON schema examples for permissions, engine, and network properties #2579, Add JSON schema examples for safe-outputs configuration #2580 - JSON schema examples (internal schema files)
• Add Copilot CLI and VS Code MCP server configuration instructions #2548 - MCP server configuration (already documented in PR)
• Standardize repository access with cached implementation #2519 - Repository access refactoring (internal code organization)
• Generate update_reaction job for command workflows with reactions #2552 - Update reaction job generation (internal workflow compiler)
• Update OpenAI Codex CLI to v0.50.0 #2554 - OpenAI Codex CLI version update (version bump)
• Add workflow run URL formatting guidelines to reporting shared workflow #2562, Add diagnostic logging for patch application failures in push_to_pull_request_branch #2546, Recompile workflow files with enhanced patch diagnostics #2547, [log] Add debug logging to filters, git operations, and GitHub token handling #2544, Always fail job when patch file contains error messages #2539, Remove commit-title-suffix from mergefest workflow #2549 - Bug fixes and logging improvements

All changes follow the Diátaxis framework with reference-style documentation for CLI commands. Content is concise, technically accurate, and uses neutral tone per documentation guidelines.

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]

AI generated by Daily Documentation Updater