Skip to content

[plan] Add concrete tool setup examples for Playwright, axe-core, and webpack-bundle-analyzer #10286

@github-actions

Description

@github-actions

Objective

Add concrete, copy-paste-ready setup examples for commonly suggested tools (Playwright, axe-core, webpack-bundle-analyzer) to the agentic-workflows agent instructions.

Context

Research identified tool selection as the weakest dimension (4.73/5.0). Multiple scenarios (FE-1, FE-3, FE-2) suggested these tools but lacked concrete configuration examples, requiring developers to research integration details themselves.

Approach

  1. Create tool setup reference section in developer.instructions.md
  2. Add Playwright configuration example:
    • Minimal playwright.config.js with multi-browser setup
    • Package.json dependencies
    • Basic test template
  3. Add axe-core integration example:
    • Package installation command
    • Import and usage pattern
    • Configuration options
  4. Add webpack-bundle-analyzer example:
    • webpack.config.js modifications
    • CLI flag examples
    • Size threshold configuration
  5. Update agent to reference these examples when suggesting tools

Files to Modify

  • Update: .github/instructions/developer.instructions.md (add tool setup reference section)
  • Create: .github/instructions/examples/playwright-setup.md (optional: separate examples file)

Acceptance Criteria

  • Playwright config includes Chromium/Firefox/Safari setup
  • axe-core example shows complete integration (install + import + usage)
  • webpack-bundle-analyzer includes both config and CLI approaches
  • Each example is under 30 lines (copy-paste-ready)
  • Agent instructions reference these examples when suggesting tools
  • Examples tested in a sample workflow

Expected Impact

Improves tool selection dimension score from 4.73 to 4.9+, addressing the main weakness identified in research.
Related to #10285

AI generated by Plan Command for discussion #10248

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions